Verfügbare Menübänder

Hinweis

In diesem Thema geht es um klassische Befehle.

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

In diesem Artikel wird beschrieben, wo Menübänder in modellgestützten Apps definiert und geändert werden.

Menübanddefinitionen

Modellgestützte Apps enthalten Standard <RibbonDiffXml> Definitionen für jedes Menüband in der Anwendung. Sie können die aktuelle XML, die das Menübands für Ihre Organisation definiert exportieren und anzeigen, aber Sie können die XML nicht direkt aktualisieren. Sie können das Menüband anpassen, indem Sie definieren, wie es geändert werden soll. Die Änderungsdefinitionen, die Sie angeben, werden zur Laufzeit angewendet, wenn das Menübands in der Anwendung angezeigt wird. Alle Ihre Änderungen werden in den Elementen <CustomAction> oder <HideCustomAction> ausgeführt. Diese Elemente werden über die standardmäßigen Menübanddefinitionen angewendet, die von modellbasierten Apps bereitgestellt werden.

Wenn Sie Ihre Änderungsdefinitionen schreiben, müssen Sie die Definitionen der Standardmenübänder häufig verweisen. Wenn sie beispielsweise ein bestimmtes Menübandelement ausblenden möchten, müssen Sie die eindeutige ID des Elements kennen. Wenn Sie ein neues Menübandelement innerhalb oder neben einem vorhandenen Menübandelement positionieren möchten, müssen Sie die ID-Werte für diese Elemente sowie die Reihenfolge kennen, die die relative Stellung der Elemente steuert.

Wegen dieser Anforderung ist es erforderlich, die Definitionen von vorhandenen Menübandelementen zu verweisen, es ist wichtig, die aktuellen Menübanddefinitionen in Ihrer Organisation zu verstehen. Es gibt zwei Nachrichten, die Sie verwenden können, um XML-Dateien, die den aktuellen Status der Menübänder darstellen, zu exportieren. Die Definitionen enthalten alle Anpassungen, die bereits auf dem System angewendet wurden, damit Sie zuvor angewendete Menübänder anpassen können. Weitere Informationen finden Sie unter Exportieren von Menübanddefinitionen.

Um Ihnen den Einstieg zu erleichtern, können Sie die Standard-Menübanddefinitionen für modellbasierte Apps unter Exportieren von Menübanddefinitionen Beispiel herunterladen. The ExportedRibbonXml-Datei enthält die Ausgabedateien, die Sie für eine Organisation haben würden.

Innerhalb der exportierten XML-Datei enthält die applicationRibbon.xml-Datei alle Menübänder, die nicht für eine bestimmte Tabelle definiert sind. Diese entsprechen der Lösungskomponente Anwendungsmenübänder. Für jede Tabelle finden Sie einen Tabellennamen-ribbon.xml-Datei. Das entspricht der RibbonDiffXml, die in jeder Tabelle enthalten ist. Wenn Sie das Menüband für eine bestimmte Tabelle bearbeiten möchten, sollten Sie die Menüband-XML-Datei für diese Tabelle finden.

Tabellenbänder

Alle Tabelle verwenden eine gemeinsame Menübanddefinition genannt Tabellenmenübandvorlage. Die Tabellemenüband-Vorlagendefinition befindet sich in der applicationribbon.xml Datei. Wenn Sie eine benutzerdefinierte Tabelle erstellen, ist das angezeigte Menüband das das standardmäßige Menüband, das von der Tabellenmenübandvorlage definiert wird. Jede Systemtabelle hat eine separate <RibbonDiffXml>-Definition, die auf der Tabellenmenüband-Vorlagendefinition aufbaut.

Innerhalb der applicationribbon.xml-Datei werden die folgenden Registerkarten angezeigt, die für alle Tabellen gelten:

• Mscrm.Form.{!EntityLogicalName}.MainTab

  Die Registerkarte zeigt den Tabellenanzeigenamen in der Beschriftung an.

• Mscrm.Form.{!EntityLogicalName}.Related

  Die Registerkarte hat die Beschriftung Hinzufügen.

• Mscrm.Form.{!EntityLogicalName}.Developer

  Die Registerkarte hat die Beschriftung Anpassen.

• Mscrm.HomepageGrid.{!EntityLogicalName}.MainTab

  Die Registerkarte zeigt den mehrfachen Anzeigenamen der Tabelle in der Beschriftung an.

• Mscrm.HomepageGrid.{!EntityLogicalName}.View

  Die Registerkarte hat die Beschriftung Ansicht.

• Mscrm.HomepageGrid.{!EntityLogicalName}.Related

  Die Registerkarte hat die Beschriftung Hinzufügen.

• Mscrm.HomepageGrid.{!EntityLogicalName}.Developer

  Die Registerkarte hat die Beschriftung Anpassen.

• Mscrm.SubGrid.{!EntityLogicalName}.ContextualTabs

  Wenn ein Unterraster in einem Formular oder einem Diagramm den Fokus hat, wird die Kontextregisterkarte mit der Bezeichnung Listentools angezeigt.

  • Mscrm.SubGrid.{!EntityLogicalName}.MainTab

    Die Registerkarte zeigt den mehrfachen Anzeigenamen der Tabelle.

  Wenn Sie die Menübanddefinitionen für eine bestimmte Tabelle anzeigen, sehen Sie, dass der Name der Tabelle in der Regel das Token {!EntityLogicalName} ersetzt. Wenn Sie das Token {!EntityLogicalName} in der Menübanddefinition für eine bestimmte Tabelle finden, bedeutet das, das es für diese Ressourcen keine bestimmte Definition gibt und sie einfach die Definition der Tabellenmenübandvorlage verwendet. Wenn Sie Menübänder für eine bestimmte Tabelle definieren, sollten Sie immer den tatsächlichen Tabellennamen verwenden. Menübandänderungen für eine bestimmte Tabelle müssen im Knoten //ImportExportXml/Entities/Entity/RibbonDiffXml definiert werden.

  Sie können Änderungen, die für alle Tabelle gelten, indem die Änderungen an den Anwendungsmenübänden definieren, die das Token {!EntityLogicalName} anstelle eines logischen Namen der Tabelle im RibbonDiffXml-Knoten ersetzen. Änderungen an Anwendungsmenübänden, die für alle Tabelle definiert werden, müssen im Knoten im ImportExportXml/RibbonDiffXml definiert werden. Sie können nicht im Knoten RibbonDiffXml für eine bestimmte Tabelle definiert werden.

Rastermenübänder

Das Tabellenrastermenüband ist eine Sammlung von Registerkarten, die einen ID-Attributwertanfang mit Mscrm.HomepageGrid.<entity logical name> haben. So lautet die Registerkarte mit dem Text Firmen in einem Firmentabellenraster beispielsweise Mscrm.HomepageGrid.account.MainTab. Alle Registerkarten, die auf dem Firmatabellenraster angezeigt werden, enthalten einen ID-Wert, der mit Mscrm.HomepageGrid.account beginnt.

Unterrastermenübänder

Das Tabellenunterrastermenüband ist eine Kontextgruppe mit einer Sammlung von Registerkarten, die einen ID-Attributwertanfang mit Mscrm.SubGrid.<entity logical name> haben. So lautet die Registerkarte mit dem Text Firmen in einem Firmentabellenunterraster beispielsweise Mscrm.SubGrid.account.MainTab.

Wenn eine Liste mit den Datensätzen für eine Tabelle in einem Unterraster im Formular einer anderen Tabelle oder einem Diagramm angezeigt wird, gibt es nur drei Steuerelemente, die direkt über oder in dem Unterraster verfügbar sind. Die Verhaltensweisen für diese Steuerelemente kann geändert werden, indem die Befehle geändert werden, denen sie zugeordnet sind.

• Hinzufügen: Das Standardverhalten des Befehls mit der hängt davon ab, ob die Datensätze im Unterraster mit dem aktuellen Datensatz verknüpft sind.

  Wenn die Datensätze mit dem aktuellen Datensatz verknüpft sind, lautet das Standardverhalten: nach vorhandenen Datensätzen suchen. Wenn ein vorhandener Datensatz nicht gefunden werden kann oder wenn der Benutzer einfach einen neuen Datensatz erstellen möchte, kann er Neue hinzufügen auswählen.

  Wenn die Datensätze nicht mit dem aktuellen Datensatz verknüpft sind, lautet das Standardverhalten: einen neuen Datensatz hinzufügen. Falls die Tabelle ein Schnellerfassungsformular besitzt, wird es angezeigt; andernfalls wird ein neues ganzes Formular angezeigt.

  Aktivitäten sind die Ausnahme bei diesem Muster. Der Hinzufügensbefehl verlangt immer zuerst den Typ der Aktivität.

  Hinweis

  Der Offlinemodus in Dynamics 365 for Customer Engagement unterstützt keine n:n-Beziehung bei benutzerdefinierten Tabellen. Deshalb wird die Schaltfläche Neu hinzufügen im Dynamics 365-Offlinemodus nicht auf einem Unterraster angezeigt.

• Liste anzeigen: Der Befehl mit der öffnet die vollständige Liste, in der alle verfügbaren Befehle verwendet werden können.

  Wenn das Unterraster dem aktuellen Datensatz zugeordnet wird, ist das Standardverhalten eines Befehls, die zugeordnete Ansicht zu öffnen.

  Wenn das Unterraster dem aktuellen Datensatz nicht zugeordnet wird, ist das Standardverhalten eines Befehls, die Ansicht in der Hauptlistenansicht zu öffnen.

• Löschen: Das wird auf der rechten Seite der Zeile angezeigt, wenn Personen mit der Maus über die Datensätze in der Liste fahren.

  Für Datensätze mit einer 1: n-Beziehung oder keiner Beziehung, ist das Standardverhalten, den Datensatz zu löschen. Die Löschung wird möglicherweise blockiert, wenn sie aufgrund der Beziehungskonfigurationen nicht zulässig ist. Offene Aktivitäten und Rechnungen sind häufige Beispiele für Datensätze, die möglicherweise aufgrund der Beziehungskonfigurationen nicht gelöscht werden.

  Für Beziehungen, die n:n-Beziehungen anzeigen, ist das Standardverhalten, die Beziehung zu entfernen, die mit den Datensätzen verbunden sind und nicht den Datensatz selbst.

  Sie können das Standardverhalten ändern, indem Sie die Aktionen, die dem Befehl zugewiesen sind mithilfe von <CommandDefinition> ändern, aber Sie können den Namen des Befehls nicht ändern. Beispielsweise können Sie den Löschvorgang ändern, sodass er den Datensatz deaktiviert, anstatt ihn zu löschen.

  Es ist nicht möglich, die angezeigten Symbole für diese Befehle zu ändern. Sie können diese Befehle ausblenden, indem Sie <HideCustomAction> verwenden.

Formularmenübänder

Hinweis

Dieses Feature wird auf der einheitlichen Oberfläche nicht unterstützt.

Jede Tabelle kann mehrere Formulare haben. Sie können Änderungen am Formularmenüband für alle Formulare für diese Tabelle definieren, indem Sie Ihre Definition auf Tabellenebene hinzufügen (//ImportExportXml/Entities/Entity/RibbonDiffXml).

Jedes Tabellenformular kann eine bestimmte Menübanddefinition haben. In der exportierten Datei customizations.xml müssen Sie Ihren geändertes <RibbonDiffXml> diesem Speicherort hinzufügen://ImportExportXml/Entities/Entity/FormXml/forms/systemform/form/RibbonDiffXml.

Das Formularmenüband ist eine Sammlung von Registerkarten, die einen ID-Attributwertanfang mit Mscrm.Form.<entity logical name> haben. Beispielsweise ist die Registerkarte mit der Beschriftung Firma auf dem Firmaformular Mscrm.Form.account.MainTab. Alle Registerkarten, die auf dem Firmaenentitätsformular angezeigt werden, enthalten einen ID-Wert, der mit Mscrm.Form.account beginnt.

Standard-Startregisterkarte

Die Standard-Startregisterkarte wird auf dem Haupt-Anwendungsmenüband angezeigt, wenn eine alternative Registerkarte aufgrund des Tabellenkontexts oder einer Anzeigenregel, die sie für bestimmte Seiten unterdrückt, nicht definiert ist. Dieses Register wird z.B. angezeigt, wenn Sie die modellbasierten Apps Hilfe anzeigen. Die ID der Standard-Startregisterkarte ist Mscrm.BasicHomeTab.

Anpassen der globalen Befehlsleiste

Sie können die globale Befehlsleiste (Mscrm.GlobalTab) durch Hinzufügen der Schaltflächen zu Mscrm.GlobalTab anpassen. Die sofort einsatzbereiten Schaltflächen in der globalen Befehlsleiste können derzeit nicht geändert werden, es können jedoch neue Schaltflächen hinzugefügt werden.

Wenn der Standort von CustomAction auf Location="Mscrm.GlobalTab.New.Controls._children festgelegt ist, wird die benutzerdefinierte Schaltfläche in der globalen Befehlsleiste oben auf der Seite angezeigt.

Hinweis

Dieses Feature wird nur auf der einheitlichen Oberfläche unterstützt.

Andere Menübänder

Einige andere Menübandregisterkarten und Kontextgruppen für besondere Zwecken werden von modellgesteuerten Apps definiert. Jede Registerkarte wird einer besonderen <TabDisplayRule> zugeordnet, die steuert, wann sie angezeigt werden. In der folgenden Liste sind diese Registerkarten aufgeführt.

Tabstopp	Stamm-ID	Beschreibung
Seitenregisterkarte "Webressource bearbeiten".	Mscrm.WebResourceEditTab	Zeigt an, wann Webressourcen innerhalb einer Lösung bearbeitet werden.
Registerkarte "Formular-Editor"	Mscrm.FormEditorTab	Stellt die Gruppen Speichern, Bearbeiten und Ansicht von Aktionen für Formulare bereit.
Registerkarte "Formular-Editor einfügen"	Mscrm.FormEditorInsertTab	Stellt Schaltflächen zum Einfügen von Abschnitten, Registerkarten und Steuerelementen in Formularen bereit.
Registerkarten "Dashboard-Homepage"	Mscrm.DashboardTab	Wird im Arbeitsbereich angezeigt.
Kontextgruppe "Visualisierungs-Tool"	Mscrm.VisualizationTools	Wird angezeigt, wenn auf die Schaltfläche Neues Diagramm auf der Registerkarte Diagramme, die im Tabellenrastermenüband angezeigt wird, geklickt wird.
Registerkarte "AptbookTab-Homepage"	Mscrm.AptbookTab	Wird angezeigt, wenn der Servicekalender im Servicebereich angezeigt wird.
Registerkarte "Erweiterte Suche"	Mscrm.AdvancedFind	Wird im Fenster Erweiterte Suche angezeigt.
Registerkarte "Dashboard-Editor"	Mscrm.DashboardEditorTab	Wird angezeigt, wenn ein Dashboard bearbeitet wird.
Registerkarte "Dokumente"	Mscrm.DocumentsTab	Wird angezeigt, wenn SharePoint-Integration für die Organisation aktiviert wurde.
Registerkarte "Diagramm-Editor"	Mscrm.VisualizationDesignerTab	Wird angezeigt, wenn ein Diagramm aus dem Lösungsfenster bearbeitet wird.
Kontextgruppe "Suchwerkzeuge"	Mscrm.ArticleSearch	Wird angezeigt, wenn die KBarticle Tabelle angezeigt wird.

Menübänder für benutzerdefinierte Seiten

Sie können mithilfe von SiteMap benutzerdefinierte Seiten in der Anwendungsnavigation anzeigen. Diese Seiten werden immer die Standard-Startregisterkarte (Mscrm.BasicHomeTab) anzeigen.

Es ist nicht möglich, eine <PageRule> zu verwenden, um benutzerdefinierte Menübandkomponenten auf benutzerdefinierten Seiten anzuzeigen oder zu aktivieren.

Siehe auch

Anpassen des Menübands
Darstellen von Befehlsleisten und Menübändern

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).