Definieren von Menüband-Anzeigeregeln

Hinweis

In diesem Thema geht es um klassische Befehle.

Es gibt eine neue Möglichkeit, Befehle zu definieren. Siehe Moderne Befehlsübersicht (Vorschauversion)

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>-Element, um Regeln zu definieren, die steuern, wann das Menübandelement angezeigt werden soll.
• Verwenden Sie das /CommandDefinitions/CommandDefinition/DisplayRules/<DisplayRule>-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 einen optionalen Parameter, um anzugeben, ob der Standardwert der Regel true oder false ist, und einen optionalen InvertResult-Parameter, der 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>

Gibt eine Regel an, die den Typ der verwendeten Darstellung erkennt.

Die Type-Werte entsprechen dem Folgenden:

Value	Präsentation
Modern	Die Befehlsleiste wird mit Dynamics 365 for tablets dargestellt.
Refresh	Die Befehlsleiste wird mithilfe der aktualisierten Benutzeroberfläche angezeigt.
Legacy	Das Menüband wird in Formularen für Tabellen, die nicht aktualisiert wurden, oder in einer Listenansicht in Dynamics 365 for Outlook angezeigt.

<CrmClientTypeRule>

Ermöglicht die Definition von Regeln abhängig vom Typ des verwendeten Clients. Die Type-Optionen lauten wie folgt:

• Web
• Outlook

<CrmOfflineAccessStateRule>

Verwenden Sie diese Kriterien, um ein Menübandelement abhängig davon anzuzeigen, ob Dynamics 365 for Microsoft Office Outlook mit Offlinezugriff derzeit im Offlinemodus ist.

<CrmOutlookClientTypeRule>

Verwenden Sie diese Regel, wenn Sie eine Schaltfläche für den spezifischen Dynamics 365 for Outlook-Typ anzeigen möchten. Die Type-Optionen lauten wie folgt:

• CrmForOutlook
• CrmForOutlookOfflineAccess

<CrmOutlookClientVersionRule>

Erkennt die neueste Version von Microsoft Dynamics 365 for Microsoft Office Outlook.

Gültige Werte:

• 2003
• 2007
• 2010

<EntityPrivilegeRule>

Verwenden Sie diese Art von Regel, um Menübandelemente anzuzeigen, wenn ein Benutzer spezielle Rechte für eine Tabelle besitzt. Sie müssen die Berechtigungstiefe und die gewünschte Berechtigung angeben, die Sie überprüfen möchten.

<EntityPropertyRule>

Ermöglicht die Definition von Regeln abhängig von den booleschen Werten der spezifischen Tabellenseigenschaften. Die PropertyName-Optionen lauten wie folgt:

• DuplicateDetectionEnabled
• GridFiltersEnabled
• HasStateCode
• IsConnectionsEnabled
• MailMergeEnabled
• WorksWithQueue
• HasActivities
• IsActivity
• HasNotes

<EntityRule>

Diese Regel lässt die Evaluierung der aktuellen Tabelle zu. Dies ist hilfreich, wenn Sie benutzerdefinierte Aktionen definieren, die für die Tabellenvorlage gelten, statt für bestimmte Tabellen. Beispielsweise möchten Sie möglicherweise ein Menübandelement für alle Tabellen hinzufügen, mit Ausnahme einiger bestimmter Tabellen. Es ist einfacher, die benutzerdefinierte Aktion für die Tabellenvorlage zu definieren, die für alle Tabellen gilt, und dann eine EntityRule zu verwenden, die die Tabellen herausfiltert, die ausgeschlossen werden sollen.

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

<FormEntityContextRule>

Gibt eine Regel an, mit der festgestellt werden kann, ob ein Formularmenüband im Kontext einer bestimmten Entität angezeigt wird.

<FormStateRule

Verwenden Sie die Formularstatus-Regel, um den aktuellen Formulartyp zu bestimmen, in dem ein Datensatz angezeigt wird. Die State-Optionen lauten wie folgt:

• Erstellen
• Vorhanden
• Schreibgeschützt
• Deaktiviert
• BulkEdit

<FormTypeRule>

Gibt eine Regel an, die den Typ des Microsoft Dynamics 365-Formulars erkennt.

Die Type-Werte entsprechen dem Folgenden:

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

<HideForTabletExperienceRule>

Gibt eine Regel an, die einen Fehler zurückgibt, wenn die Webanwendung in einem mobilen Browser auf einem Tabletgerät angezeigt wird.

<MiscellaneousPrivilegeRule>

Verwenden Sie diese Art von Regel, um nach Rechten zu suchen, die nicht für eine bestimmte Tabelle gelten, zum Beispiel ExportToExcel, MailMerge oder GoOffline.

<OrganizationSettingRule>

Verwenden Sie diese Regel, um ein Menübandelement anzuzeigen, wenn bestimmte Organisationseinstellungen aktiviert sind. Die Einstellungsoptionen lauten wie folgt:

• IsSharepointEnabled
• IsSOPIntegrationEnabled
• IsFiscalCalendarDefined

<OrRule>

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>

Verwenden Sie diese Regel, um ein Menübandelement anzuzeigen, wenn das Menüband in Outlook auf eine bestimmte Art angezeigt wird. Die Type-Optionen lauten wie folgt:

• Web
• Outlook

<OutlookVersionRule>

Verwenden Sie dies, um ein Menübandelement für eine bestimmte Version von Outlook anzuzeigen. Die Version-Optionen lauten wie folgt:

• 2003
• 2007
• 2010

<PageRule>

Diese Art von Regel überprüft, ob die URL der Seite angezeigt wird. Sie gibt „true“ zurück, wenn die Adresse übereinstimmt.

<ReferencingAttributeRequiredRule>

Eine Regel, die erkennt, ob das verweisende Attribut für eine Entität erforderlich ist.

Dies ist eine sehr spezifische Regel für einen ganz bestimmten Fall. Verwenden Sie diese Regel, wenn auf der Seite ein an eine Beziehung gebundenes Unterraster oder ein zugehöriges Raster vorhanden ist. Diese Regel prüft, ob das in der Beziehung verwendete verweisende Attribut erforderlich ist. Diese Regel wird verwendet, um die Schaltfläche „Vorhandenen Datensatztyp hinzufügen“ auszublenden, wenn ihre Anzeige nicht angebracht ist.

In einer Entitätsbeziehung kann das Suchefeld im zugehörigen Datensatz (das verweisende Attribut) erforderlich sein oder nicht. Beispielsweise ist das Feld „Bezug“ einer Aktivität nicht erforderlich, das Feld „Potenzielle Kundschaft“ einer Verkaufschance jedoch schon. Mit der Schaltfläche „Vorhandene Aktivität hinzufügen“ wird der Wert des Felds „Bezug“ auf den aktuellen Datensatzkontext festgelegt. Dies funktioniert nur, wenn das Feld „Bezug“ noch keinen Wert hat. Alle Verkaufschancen-Datensätze haben einen Wert im Feld „Potenzielle Kundschaft“. Daher ist es nie sinnvoll, die Schaltfläche „Vorhandene Verkaufschance hinzufügen“ anzuzeigen. Diese Regel erkennt, dass das verweisende Attribut erforderlich ist und gibt daher „true“ zurück.

<RelationshipTypeRule>

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>

Verwenden Sie diese Art von Regel, um ein Menübandelement für eine bestimmte SKU-Version von Microsoft Dataverse wie folgt anzuzeigen,:

• OnPremise
• Online
• Spla

<ValueRule>

Verwenden Sie diese Regel, um den Wert eine bestimmte Spalte 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>, um ein Element auszublenden.

Siehe auch

Befehle und das Menüband anpassen
Definieren von Menüband-Aktivierungsregeln
Definieren von Menübandaktionen

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).