Beispiel: Exportieren von Menübanddefinitionen

Dieses Beispiel zeigt, wie man Multifunktionsleistendefinitionen exportiert. Es verwendet die Meldungen RetrieveApplicationRibbonRequest und RetrieveEntityRibbonRequest. Sie können das Beispiel von hier herunterladen.

Wie man dieses Beispiel ausführt

  1. Um eine lokale Kopie zu erhalten, laden Sie den Beispielbericht herunter, oder klonen Sie ihn.
  2. (Optional) Bearbeiten Sie die cds/App.config-Datei so, dass sie eine Verbindungszeichenfolge festlegt, aus der die Instanz von Common Data Service hervorgeht, zu der Sie eine Verbindung herstellen möchten.
  3. Um das Beispiel auszuführen, öffnen Sie die Beispiellösung in Visual Studio, und drücken Sie F5. Nachdem Sie in der cds/App.config-Datei eine Verbindungszeichenfolge angegeben haben, nutzen alle Beispiele, die Sie ausführen, diese Verbindungsdaten.

Wenn Sie in der cds/App.config-Datei keine Verbindungszeichenfolge angeben, wird bei jeder Ausführung eines Beispiels ein Dialogfeld geöffnet, in dem Sie eingeben müssen, zu welcher Instanz von Common Data Service Sie eine Verbindung herstellen und welche Anmeldeinformationen Sie verwenden möchten. Vorherige Verbindungen werden im Dialogfeld zwischengespeichert, so dass Sie aus zuvor verwendeten Verbindungen auswählen können.

Die Beispiele aus diesem Bericht, die zu ihrer Ausführung eine Verbindung zu einer Instanz von Common Data Service benötigen, enthalten eine verknüpfte Referenz zur cds/App.config-Datei.

Funktionsweise:

Die RetrieveApplicationRibbonRequest-Nachricht soll in einem Szenario verwendet werden, in dem sie Daten enthält, die zum Abrufen der Daten benötigt werden, die den Inhalt und das Verhalten des Anwendungs-Band definieren. Die RetrieveEntityRibbonRequest-Nachricht ist für ein Szenario gedacht, in dem sie Daten enthält, die zum Abrufen von Banddefinitionen für eine Entität benötigt werden.

Wie dieses Beispiel funktioniert

Um das unter Was macht dieses Beispiel, beschriebene Szenario zu simulieren, geht das Beispiel wie folgt vor:

Einrichten

Prüft auf aktuelle Version der Organisation.

Demonstrieren

  1. Die RetrieveApplicationRibbonRequest-Methode ruft das Anwendungs-Band ab.
  2. Die RetrieveEntityRibbonRequest-Methode ruft die System-Entitäts-Menübänder ab

Bereinigung

Für dieses Beispiel ist keine Bereinigung erforderlich

Siehe auch

Befehle und das Menüband anpassen
Parameter mit dem Menüband an eine URL übergeben
Menübandkernschema Menübandtypenschema Menüband-WSS-Schema RetrieveApplicationRibbonRequest
RetrieveEntityRibbonRequest