Festlegen benutzerdefinierter Aktionen zur Änderung des Menübands

Hinweis

In diesem Thema geht es um klassische Befehle.

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

Der Standard, eine Anwendungsbefehlsleiste oder ein Menüband, wird von den Microsoft Dataverse-Metadaten definiert. Diese standardmäßigen Daten können nicht geändert werden, aber Sie können Definitionen bestimmter Aktionen einschließen, die das Standardmenüband überschreiben.

Typen benutzerdefinierter Aktionen

Es gibt zwei Typen benutzerdefinierte Aktionen für Menübänder:

• <CustomAction>: Definiert eine Aktion zum Hinzufügen oder Ersetzen von Elementen auf dem Menüband.

• <HideCustomAction> : Entfernt ein vorhandenes Menübandelement aus der Verarbeitung für das Menüband.

Benutzerdefinierte Aktionen

Eine benutzerdefinierte Aktion ist eine Anweisung dafür, wie Sie die standardmäßige Menübanddefinition ändern möchten. Sie wird zur Laufzeit ausgewertet auf das Menüband angewendet. Um den Kontext für eine benutzerdefinierte Aktion festzulegen, müssen Sie die Informationen zu dem Speicherort der Elemente einschließen, die Sie ändern möchten. Verwenden Sie den Location Parameter, um anzugeben, wo Ihre Änderung gelten.

Wenn Sie ein neues Menübandelement hinzufügen, verweisen Sie auf das enthaltende Element, etwa eine vorhandene Registerkarte oder Gruppe. Sie können dann das Suffix ._children anfügen, um anzugeben, dass diese benutzerdefinierte Aktion einem vorhandenen Element etwas hinzufügt.

Wenn Sie die Definition eines vorhandenen Elements ändern, entspricht der Location-Wert der ID dieses Elements.

Sie müssen auch einen eindeutigen Bezeichner für die benutzerdefinierte Aktionen angeben. Verwenden Sie den Parameter ID, um diesen Wert festzulegen. Es wird dringend empfohlen, eine Namenskonvention verwenden, die einen eindeutigen Wert garantiert. Aus Gründen der Konsistenz und Lesbarkeit, empfiehlt es sich, einen Punkt verwenden, um konsistente Komponenten voneinander zu trennen. Der erste Element in Ihrer Namenskonvention sollte sich auf den Lösungsherausgeber oder die Lösung beziehen, etwa Contoso.contact.form.CustomButton.CustomAction.

Tipp

Die konsistente Verwendung Ihrer Id-Parameternamenskonventionen erhöht Ihre Produktivität deutlich bei der Bearbeitung von RibbonDiffXml.

Basierend auf den Standortinformationen, die Sie angeben, bestimmt der Sequence-Wert die Reihenfolge der Wiedergabe der Elemente. Wenn ein benutzerdefiniertes Steuerelement zwischen zwei vorhandenen Steuerelementen angezeigt werden soll, müssen Sie einen Reihenfolgenwert auswählen, der zwischen den Reihenfolgenwerten der vorhandenen Elemente liegt.

Benutzerdefinierte Aktionen ausblenden

Ein <HideCustomAction> ist eine Anweisung, die Sie verwenden, wenn Sie ein vorhandenes Menübandelement entfernen möchten, damit es nicht gerendert wird. Dieses Menübandelement wird nicht ausgeblendet, es wird zur Laufzeit entfernt, so dass es nicht im Menüband vorhanden ist.

Das Element HideActionId bietet eine eindeutige ID für die Aktion. Aus Gründen der Konsistenz und Lesbarkeit, sollten Sie derselben Namenskonvention folgen wie für <CustomAction> -Elemente. Der Parameter Ort muss der ID des Menübandelements entsprechen, das Sie entfernen möchten.

Hinweis

Da das HideCustomAction-Element einen angegebenen Knoten aus dem Menüband entfernt, ist das Entfernen von Menübandelementen nicht immer die beste Vorgehensweise.

• Wenn Sie eine Schaltfläche entfernen möchten, die einem bestimmten Recht zugeordnet ist, sollten Sie die Rechte für die Tabelle in den Sicherheitsrollen in Ihrer Implementierung einstellen. Dadurch kann das Standardmenüband angezeigt werden, und Regeln können für Benutzer Menüelemente ausblenden oder deaktivieren, die nicht über die entsprechenden Rechte verfügen.
  • Wenn Sie ein vorhandenes Menübandelement durch ein benutzerdefiniertes Menübandelement ersetzen möchten, können Sie dieses Element überschreiben, indem Sie einen CustomAction.Location-Wert angeben, der dem vorhandenen Element entspricht.
• Um das HideCustomAction-Element entfernen zu können, müssen Sie eine neue aktualisierte Version der gleichen Lösung erstellen, die das HideCustomAction-Element installiert hat. Ein neuer Patch der Lösung kann das HideCustomAction-Element nicht entfernen.

Das einmal hinzugefügte HideCustomAction-Element kann nur durch Erstellen einer neuen aktualisierten Lösung entfernt werden. Stattdessen sollten Menübandschaltflächen mit einem DisplayRule-Element ausgeblendet werden, die immer auf „false“ auswerten. Die Nutzung beider Mscrm.HideOnModern und Mscrm.ShowOnlyOnModern würde immer auf „false“ auswerten. So blenden Sie z. B. eine Deaktivierungsschaltfläche aus:

<CommandDefinition Id="Mscrm.HomepageGrid.Deactivate">
    <EnableRules>
      </EnableRules>
      <DisplayRules>
        <DisplayRule Id="Mscrm.HideOnModern" />
        <DisplayRule Id="Mscrm.ShowOnlyOnModern" />
      </DisplayRules>
      <Actions>
        </Actions>
    </CommandDefinition>

Siehe auch

Befehle und das Menüband anpassen
Übermitteln von -Daten von einer Seite als Parameter für Menüband-Aktionen
Definieren der Skalierung für Menübandelemente

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