Definire le regole di visualizzazione della barra multifunzione

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Quando si configurano gli elementi della barra multifunzione è possibile definire regole specifiche per controllare quando tali elementi devono essere visualizzati.

• Utilizzare l'elemento /RuleDefinitions/DisplayRules/<DisplayRule> (RibbonDiffXml) per definire regole che controllano quando l'elemento della barra multifunzione deve essere visualizzato.

• Utilizzare l'elemento /CommandDefinitions/CommandDefinition/DisplayRules/<DisplayRule> (RibbonDiffXml) per associare regole di visualizzazione specifiche a una definizione di comando.

Controllare quando gli elementi della barra multifunzione sono visualizzati

Definendo le regole di visualizzazione con le definizioni delle regole, è possibile utilizzare la stessa regola di visualizzazione per molte definizioni di comando. Se per una definizione di comando sono definite più regole di visualizzazione, tutte le regole di visualizzazione devono restituire true affinché l'elemento della barra multifunzione venga visualizzato.

Tutte le regole di visualizzazione forniscono un attributo facoltativo per specificare se il valore predefinito della regola è true o false e un attributo facoltativo InvertResult per abilitare la restituzione di un risultato negativo in cui l'elemento testato restituisca true.

L'elemento /RuleDefinitions/DisplayRules/DisplayRule supporta i tipi di regole seguenti:

• <CommandClientTypeRule> (RibbonDiffXml)
  Specifica una regola con cui si rileva il tipo di presentazione utilizzata.

  I valori Type corrispondono ai seguenti:

  Valore	Presentazione
  Modern	La barra dei comandi viene presentata mediante Microsoft Dynamics 365 per tablet.
  Refresh	La barra dei comandi viene presentata tramite l'interfaccia utente aggiornata.
  Legacy	La barra multifunzione viene presentata nei moduli per le entità che non sono state aggiornate o in una visualizzazione elenco in Microsoft Dynamics 365 per Outlook.

• <CrmClientTypeRule> (RibbonDiffXml)
  Consente di definire le regole in base al tipo di client utilizzato. Le opzioni di Type sono le seguenti:

  • Web

  • Outlook

• <CrmOfflineAccessStateRule> (RibbonDiffXml)
  Utilizzare questo criterio per visualizzare un elemento della barra multifunzione in base al fatto che Microsoft Dynamics 365 per Microsoft Office Outlook con accesso offline sia attualmente offline.

• <CrmOutlookClientTypeRule> (RibbonDiffXml)
  Utilizza questa regola se desideri visualizzare solo un pulsante per il tipo specifico di Microsoft Dynamics 365 per Outlook. Le opzioni di Type sono le seguenti:

  • CrmForOutlook

  • CrmForOutlookOfflineAccess

• <CrmOutlookClientVersionRule> (RibbonDiffXml)
  Rileva la versione di Microsoft Dynamics 365 per Microsoft Office Outlook.

  Valori validi:

  • 2003

  • 2007

  • 2010

• <EntityPrivilegeRule> (RibbonDiffXml)
  Utilizzare questo tipo di regola per visualizzare gli elementi della barra multifunzione quando un utente ha privilegi specifici per un'entità. È necessario specificare la profondità di privilegio e il privilegio specifico che si desidera verificare.

• <EntityPropertyRule> (RibbonDiffXml)
  Consente di definire le regole in base ai valori booleani di proprietà dell'entità specifiche. Le opzioni di PropertyName sono le seguenti:

  • DuplicateDetectionEnabled

  • GridFiltersEnabled

  • HasStateCode

  • IsConnectionsEnabled

  • MailMergeEnabled

  • WorksWithQueue

  • HasActivities

  • IsActivity

  • HasNotes

• <EntityRule> (RibbonDiffXml)
  Le regole di entità consentono la valutazione dell'entità corrente. Questo risulta utile quando si definiscono azioni personalizzate applicabili al modello dell'entità anziché a entità specifiche. Ad esempio, è possibile aggiungere un elemento della barra multifunzione a tutte le entità ad eccezione di diverse entità specifiche. È più semplice definire l'azione personalizzata per il modello dell'entità che si riferisce a tutte le entità, quindi utilizzare una regola di entità per filtrare le entità che devono essere escluse.

  La regola di entità include inoltre un attributo facoltativo di contesto per specificare se l'entità viene visualizzata nel modulo o in un elenco (HomePageGrid). L'attributo facoltativo AppliesTo può essere impostato su PrimaryEntity o SelectedEntity per distinguere se l'entità viene visualizzata in una griglia secondaria.

• <FormEntityContextRule> (RibbonDiffXml)
  Specifica una regola tramite cui è possibile rilevare se la barra multifunzione di un modulo viene visualizzata nel contesto di un'entità specifica.

• <FormStateRule> (RibbonDiffXml)
  Utilizzare lo stato del modulo per determinare il tipo corrente di modulo che visualizza un record. Le opzioni di State sono le seguenti:

  • Create

  • Existing

  • ReadOnly

  • Disabled

  • BulkEdit

• <FormTypeRule> (RibbonDiffXml)
  Specifica una regola con cui si rileva il tipo di modulo Microsoft Dynamics 365.

  I valori Type corrispondono ai seguenti:

  Valore	Presentazione
  Main	Un modulo dell'entità visualizzato nell'applicazione.
  Preview	Il modulo di anteprima per un'entità visualizzato come elemento di espansione nella griglia.
  AppointmentBook	Utilizzata per l'appuntamento, le attrezzature, il serviceappointment e le entità di utente di sistema dell'interfaccia utente della pianificazione dei servizi.
  Dashboard	Il modulo definisce un dashboard.
  Quick	Un modulo di visualizzazione rapida
  QuickCreate	Un modulo Creazione rapida

• <HideForTabletExperienceRule> (RibbonDiffXml)
  Specifica una regola che restituirà false quando l'applicazione Web viene visualizzata in un browser per dispositivi mobili su un dispositivo tablet.

• <MiscellaneousPrivilegeRule> (RibbonDiffXml)
  Utilizzare questo tipo di regola per i privilegi che non si applicano a un'entità specifica, come ExportToExcel, MailMerge o GoOffline.

• <OrganizationSettingRule> (RibbonDiffXml)
  Utilizzarla per visualizzare un elemento della barra multifunzione se sono abilitate impostazioni specifiche dell'organizzazione. Le opzioni di impostazione sono le seguenti:

  • IsSharepointEnabled

  • IsSOPIntegrationEnabled

  • IsFiscalCalendarDefined

• <OrRule> (RibbonDiffXml)
  Questa regola consente di sostituire il confronto AND predefinito per visualizzare più tipi di regole. Utilizzare l'elemento OrRule per definire più combinazioni valide per il controllo.

• <OutlookRenderTypeRule> (RibbonDiffXml)
  Utilizza questa opzione per visualizzare un elemento della barra multifunzione se la barra multifunzione in Microsoft Outlook è visualizzata in una maniera specifica. Le opzioni di Type sono le seguenti:

  • Web

  • Outlook

• <OutlookVersionRule> (RibbonDiffXml)
  Consente di visualizzare un elemento della barra multifunzione per una versione di Microsoft Outlook specifica. Le opzioni di Version sono le seguenti:

  • 2003

  • 2007

  • 2010

• <PageRule> (RibbonDiffXml)
  Questo tipo di regola controlla l'URL della pagina visualizzata. Restituisce true se l'indirizzo corrisponde.

• <RelationshipTypeRule> (RibbonDiffXml)
  Questo tipo di regola si applica ai record selezionati in una griglia. Consente di determinare il tipo di relazione, come riportato di seguito:

  • OneToMany

  • ManyToMany

  • NoRelationship

• <SkuRule> (RibbonDiffXml)
  Utilizzare questo tipo di regola per visualizzare un elemento della barra multifunzione per una versione specifica dello SKU di Microsoft Dynamics 365, come illustrato di seguito:

  • OnPremise

  • Online

  • Spla

• <ValueRule> (RibbonDiffXml)
  Utilizzare questa regola per controllare il valore di un campo specifico nel record visualizzato nel modulo.

  Nota

  Per i comandi definiti per la sottogriglia per i moduli utilizzando l'esperienza utente aggiornata, le regole di valore non possono essere utilizzate nelle regole di visualizzazione. Utilizzare questo elemento in <EnableRule> (RibbonDiffXml) per nascondere un elemento.

Vedere anche

Personalizzare i comandi e la barra multifunzione
Definire le regole di abilitazione della barra multifunzione
Definire le azioni della barra multifunzione

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright