Teilen über


Definieren von Menübandaktionen

Hinweis

In diesem Thema geht es um klassische Befehle.

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

Definieren Sie die Aktionen, die durch Befehlsleisten- oder Menübandsteuerelemente in einem <CommandDefinition>-Element in Kombination mit Regeln ausgeführt werden, die steuern, ob das Steuerelement aktiviert bzw. im Menüband angezeigt wird.

Ein Menüband-Steuerelement kann zwei Arten von Aktionen ausführen und umfasst möglicherweise mehrere Aktionen:

  • JavaScript-Funktionen: Ein <JavaScriptFunction>-Element verweist auf eine Funktion, die in einer JavaScript-Webressource definiert wird.

  • Eine URL öffnen: Das Menüband öffnet eine URL mithilfe des Werts aus einem Adressenattribut im <Url>-Element. Zusätzliche Parameter können Informationen dazu übergeben, welche querystring-Parameter übergeben werden und in welchem Modus das Fenster geöffnet wird.

    Sie haben mehrere Möglichkeiten, Parameter an eine URL mithilfe des Menübands zu übergeben. Weitere Informationen: Übergeben von Parametern an eineURL mithilfe des Menübands

Übergeben von Parametern an Menübandaktionen

Verwenden Sie die folgenden Elemente ein, um Daten zu definieren, die an die benutzerdefinierte Aktion übergeben werden sollen:

<BoolParameter>

Gibt einen Wert mit einem Booleschen Datentyp an, der als Parameter übergeben werden kann.

<CrmParameter>
Stellt aus der Microsoft Dynamics 365-Anwendung abgerufene Daten dar, die als Parameter übergeben werden können. Mehr Informationen: Daten von einer Seite als Parameter an Ribbon Actions übergeben

<DecimalParameter>

Gibt einen Wert mit einem Dezimalzahl-Datentyp an, der als Parameter übergeben werden kann.

<IntParameter>

Gibt einen Wert mit einem Ganzzahl-Datentyp an, der als Parameter übergeben werden kann.

<StringParameter>

Gibt einen Wert mit einem Zeichenfolgendatentyp an, der als Parameter übergeben werden kann.

Wenn Parameter an ein <Url>-Element übergeben werden, werden sie als Abfragezeichenfolge übergeben. Daher müssen sie einen Namenswert enthalten, der den "Schlüssel" im Schlüssel/Wert-Paar der Suchzeichenfolge darstellt.

Die Parameter, die an <JavaScriptFunction> übergeben werden, benötigen keinen Namen, aber sie müssen in folgender Reihenfolge eingeschlossen werden, die von der Funktion erwartet wird, und müssen vom richtigen Datentyp sein.

Siehe auch

Befehle und das Menüband anpassen
Anzeigeregeln für Menübänder definieren
Daten von einer Seite als Parameter an Menüband-Aktionen übergeben

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