Definieren von Menüband-Anzeigeregeln

 

Veröffentlicht: November 2016

Gilt für: Dynamics CRM 2015

Wenn Sie Menübandelemente konfigurieren, können Sie bestimmte Regeln definieren, die steuern, wann die Menübandelemente angezeigt werden.

• Verwenden Sie das /RuleDefinitions/DisplayRules/<DisplayRule> (RibbonDiffXml)-Element, um Regeln zu definieren, die steuern, wann das Menübandelement angezeigt werden soll.

• Verwenden Sie das /CommandDefinitions/CommandDefinition/DisplayRules/<DisplayRule> (RibbonDiffXml)-Element, um spezifische Anzeigeregeln einer Befehlsdefinition zuzuordnen.

Steuern, wann Menübandelemente angezeigt werden

Durch die Definition von Anzeigeregeln in Regeldefinitionen können Sie dieselbe Anzeigeregel für viele Befehlsdefinitionen verwenden. Wenn mehrere Anzeigeregeln für eine Befehlsdefinition definiert sind, müssen alle der Anzeigeregeln als "true" ausgewertet werden, damit das Menübandelement angezeigt wird.

Alle Anzeigeregeln bieten ein optionales Attribut, um anzugeben, ob der Standardwert der Regel "true" oder "false" ist, und ein optionales InvertResult-Attribut, das ermöglicht, dass ein negatives Ergebnis zurückgegeben wird, wenn das getestete Element "true" zurückgibt.

Das /RuleDefinitions/DisplayRules/DisplayRule-Element unterstützt die folgenden Regeltypen:

• <CommandClientTypeRule> (RibbonDiffXml)
  Gibt eine Regel an, die den Typ der verwendeten Darstellung erkennt.

  Die Type-Werte entsprechen dem Folgenden:

  Wert	Präsentation
  Modern	Die Befehlsleiste wird mithilfe von Microsoft Dynamics CRM für Tablets dargestellt.
  Refresh	Die Befehlsleiste wird mithilfe der aktualisierten Benutzeroberfläche angezeigt.
  Legacy	Das Menüband wird in Formularen für Entitäten, die nicht aktualisiert wurden, oder in einer Listenansicht in Microsoft Dynamics CRM für Outlook angezeigt.

• <CrmClientTypeRule> (RibbonDiffXml)
  Ermöglicht die Definition von Regeln abhängig vom Typ des verwendeten Clients. Die Type-Optionen lauten wie folgt:

  • Web

  • Outlook

• <CrmOfflineAccessStateRule> (RibbonDiffXml)
  Verwenden Sie diese Kriterien, um ein Menübandelement abhängig davon anzuzeigen, ob Microsoft Dynamics CRM für Microsoft Office Outlook mit Offlinezugriff derzeit im Offlinemodus ist.

• <CrmOutlookClientTypeRule> (RibbonDiffXml)
  Verwenden Sie diese Regel, wenn Sie eine Schaltfläche für den spezifischen Microsoft Dynamics CRM für Outlook-Typ anzeigen möchten. Die Type-Optionen lauten wie folgt:

  • CrmForOutlook

  • CrmForOutlookOfflineAccess

• <CrmOutlookClientVersionRule> (RibbonDiffXml)
  Erkennt die Version von Microsoft Dynamics CRM für Microsoft Office Outlook.

  Gültige Werte:

  • 2003

  • 2007

  • 2010

• <EntityPrivilegeRule> (RibbonDiffXml)
  Verwenden Sie diese Art von Regel, um Menübandelemente anzuzeigen, wenn ein Benutzer spezielle Rechte für eine Entität besitzt. Sie müssen die Berechtigungstiefe und die gewünschte Berechtigung angeben, die Sie überprüfen möchten.

• <EntityPropertyRule> (RibbonDiffXml)
  Ermöglicht die Definition von Regeln abhängig von den booleschen Werten der spezifischen Entitätseigenschaften. Die PropertyName-Optionen lauten wie folgt:

  • DuplicateDetectionEnabled

  • GridFiltersEnabled

  • HasStateCode

  • IsConnectionsEnabled

  • MailMergeEnabled

  • WorksWithQueue

  • HasActivities

  • IsActivity

  • HasNotes

• <EntityRule> (RibbonDiffXml)
  Entitätsregeln lassen die Evaluierung der aktuellen Entität zu. Dies ist hilfreich, wenn Sie benutzerdefinierte Aktionen definieren, die für die Entitätsvorlage gelten, statt für bestimmte Entitäten. Beispielsweise möchten Sie möglicherweise ein Menübandelement für alle Entitäten hinzufügen, mit Ausnahme einiger bestimmter Entitäten. Es ist einfacher, die benutzerdefinierte Aktion für die Entitätsvorlage zu definieren, die für alle Entitäten gilt, und dann eine Entitätsregel zu verwenden, die die Entitäten herausfiltert, die ausgeschlossen werden sollen.

  Die Entitätsregel enthält auch ein optionales Kontextattribut, um anzugeben, ob die Entität im Formular oder in einer Liste angezeigt wird (HomePageGrid). Das optionale AppliesTo-Attribut kann auf PrimaryEntity oder SelectedEntity festgelegt werden, um zu unterscheiden, ob die Entität in einem Unterraster angezeigt wird.

• <FormEntityContextRule> (RibbonDiffXml)
  Gibt eine Regel an, mit der festgestellt werden kann, ob ein Formularmenüband im Kontext einer bestimmten Entität angezeigt wird.

• <FormStateRule> (RibbonDiffXml)
  Verwenden Sie die Formularstatus-Regel, um den aktuellen Formulartyp zu bestimmen, in dem ein Datensatz angezeigt wird. Die State-Optionen lauten wie folgt:

  • Create

  • Existing

  • ReadOnly

  • Disabled

  • BulkEdit

• <FormTypeRule> (RibbonDiffXml)
  Gibt eine Regel an, die den Typ des Microsoft Dynamics CRM-Formulars feststellt.

  Die Type-Werte entsprechen dem Folgenden:

  Wert	Präsentation
  Main	Ein Entitätsformular, das in der Anwendung angezeigt wird.
  Preview	Das Entitätsvorschauformular, das als erweiterndes Element im Raster angezeigt wird.
  AppointmentBook	Wird mit den Termin-, Arbeitsgerät-, serviceappointment- und systemuser-Entitäten für die Serviceplanungs-Benutzeroberfläche verwendet.
  Dashboard	Das Formular definiert ein Dashboard.
  Quick	Ein Schnellansichtsformular.
  QuickCreate	Ein Formular für die Schnellerfassung.

• <HideForTabletExperienceRule> (RibbonDiffXml)
  Gibt eine Regel an, die einen Fehler zurückgibt, wenn die Webanwendung in einem mobilen Browser auf einem Tabletgerät angezeigt wird.

• <MiscellaneousPrivilegeRule> (RibbonDiffXml)
  Verwenden Sie diese Art von Regel, um nach Rechten zu suchen, die nicht für eine bestimmte Entität gelten, zum Beispiel ExportToExcel, MailMerge oder GoOffline.

• <OrganizationSettingRule> (RibbonDiffXml)
  Verwenden Sie diese Regel, um ein Menübandelement anzuzeigen, wenn bestimmte Organisationseinstellungen aktiviert sind. Die Einstellungsoptionen lauten wie folgt:

  • IsSharepointEnabled

  • IsSOPIntegrationEnabled

  • IsFiscalCalendarDefined

• <OrRule> (RibbonDiffXml)
  Mit dieser Regel können Sie den standardmäßigen UND-Vergleich für mehrere Anzeigeregeltypen überschreiben. Verwenden Sie das OrRule-Element, um mehrere mögliche gültige Kombinationen zu definieren, die zu überprüfen sind.

• <OutlookRenderTypeRule> (RibbonDiffXml)
  Verwenden Sie diese Regel, um ein Menübandelement anzuzeigen, wenn das Menüband in Microsoft Outlook auf eine bestimmte Art angezeigt wird. Die Type-Optionen lauten wie folgt:

  • Web

  • Outlook

• <OutlookVersionRule> (RibbonDiffXml)
  Verwenden Sie dies, um ein Menübandelement für eine bestimmte Version von Microsoft Outlook anzuzeigen. Die Version-Optionen lauten wie folgt:

  • 2003

  • 2007

  • 2010

• <PageRule> (RibbonDiffXml)
  Diese Art von Regel überprüft, ob die URL der Seite angezeigt wird. Sie gibt "true" zurück, wenn die Adresse übereinstimmt.

• <RelationshipTypeRule> (RibbonDiffXml)
  Diese Art von Regel wird auf Datensätze angewendet, die im Raster ausgewählt sind. Mit der Regel können Sie den Typ der Beziehung wie folgt bestimmen:

  • OneToMany

  • ManyToMany

  • NoRelationship

• <SkuRule> (RibbonDiffXml)
  Verwenden Sie diese Art von Regel, um ein Menübandelement für eine bestimmte SKU-Version von Microsoft Dynamics 365 wie folgt anzuzeigen,:

  • OnPremise

  • Online

  • Spla

• <ValueRule> (RibbonDiffXml)
  Verwenden Sie diese Regel, um den Wert eines bestimmten Felds im Datensatz zu suchen, der im Formular angezeigt wird.

  Hinweis

  Bei Befehlen, die für das Unterraster für Formulare mithilfe der aktualisierten Benutzererfahrung definiert werden, können Werteregeln nicht innerhalb von Anzeigeregeln verwendet werden. Verwenden Sie dieses Element innerhalb von <EnableRule> (RibbonDiffXml), um ein Element auszublenden.

Siehe auch

Anpassen von Befehlen und des Menübands
Definieren von Menüband-Aktivierungsregeln
Definieren von Menübandaktionen

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright