Freigeben über

Parameter mit dem Menüband an eine URL übergeben

  • Artikel

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Menübandaktionen werden im <Actions> (RibbonDiffXml)-Element eines<CommandDefinition> (RibbonDiffXml)-Elements definiert. Es gibt mehrere Möglichkeiten, kontextbezogene als Microsoft Dynamics 365-Informationen als Abfragezeichenfolgenparameter an eine URL zu vermitteln, indem das Menüband verwendet wird.

Das PassParams-Attributm verwenden, um dynamische Werte festzulegen

Das Übermitteln von Parametern an ene Ziel-URL unter Verwendung des PassParams-Attributs stellt der Ziel-Anwendung Informationen zum Kontext des Benutzers oder des Datensatzes bereit. Alle Parameter werden übermittelt, wenn das Menübandsteuerelement konfiguriert wurde, indem das Attribut PassParams verwendet wurde. In der folgenden Tabelle werden die übermittelten Parameter aufgeführt:

Parameter

Name

Beschreibung

typename

Entitätsname

Name der Entität. Bei benutzerdefinierten Entitäten zählen dazu beispielsweise Anpassungspräfix, z. B. new_entityname.

type

Entitätstypcode

Eine ganze Zahl, die eindeutig die Entität in der aktuellen Organisation identifiziert.

Hinweis

Entity Type Code-Werte werden durch die Reihenfolge bestimmt, in der eine Entität in einer Organisation erstellt wurde.Entity Type Codes für benutzerdefinierte Entitäten sind gewöhnlich in verschiedenen Organisationen verschieden.

id

Objekt-GUID

Globally Unique Identifier (GUID), der einen Datensatz darstellt.

orgname

Organisationsname

Eindeutiger Name der Organisation.

userlcid

Benutzersprachcode

Die Sprachcode-ID, die vom aktuellen Benutzer verwendet wird.

orglcid

Organisationssprachcode

Die Sprachcode-ID, die die Ausgangssprache für die Organisation darstellt.

Sprachcodes sind vierstellige oder fünfstellige Gebietsschema-IDs. Gültige Gebietsschema-ID-Werte finden Sie unter Gebietsschema-ID-Diagramm (LCID).

Hinweis

Es ist empfehlenswert, den Entitätsnamen statt des Entitätstypcodes zu verwenden, da der Entitätstypcode möglicherweise je nach Microsoft Dynamics 365 Installation verschieden ist.

Beispiel

Im folgenden Beispiel wird die URL ohne Parameter veranschaulicht:

http://myserver/mypage.aspx

Das folgenden Beispiel veranschaulicht die Parameter, die enthalten sind, wenn das Menübandsteuerelement für die Firmenentität dargestellt wird, für eine Organisation namens "AdventureWorksCycle ", wenn die Sprache des Benutzers und die Organisationsausgangssprache Englisch ist, und die GUID für den Firmendatensatz DBD5DBFB-0666-DC11-A5D9-0003FF9CE217 ist:

http://myserver/mypage.aspx?orgname=AdventureWorksCycle&userlcid=1033&orglcid=1033&type=1&typename=account&id=%7BDBD5DBFB-0666-DC11-A5D9-0003FF9CE217%7D

Verwenden eines Abfragelzeichenfolgenparameters in der URL

Sie können einen querystring-Parameter in das URL-Attribut einschließen. Dies kann sehr nützlich sein, wenn Sie ene bestimmten Microsoft Dynamics 365-Datensatz öffnen oder anzeigen, indem Sie Öffnen von Formularen, Ansichten, Dialogen und Berichten mit einer URL verwenden.

Hinweis

Sie können das Menüband nicht importieren, wenn die URL das kaufmännischen Und-Zeichen (&) enthält., das verwendet wird, um mehrere querystring-Parameter in der URL zu trennen. Dieses Zeichen macht die XML-Datei ungültig. Sie müssen das kaufmännische Und-Zeichen im URL-Attributwert mit "&amp;" umgehen.

Lesen von übergebenen Parametern

Übergebene Parameter werden in der Regel auf der ASPX-Zielseite unter Verwendung der Eigenschaft HttpRequest.QueryString gelesen.Weitere Informationen:HttpRequest.QueryString-Eigenschaft

Hinweis

Wenn das Ziel Ihrer URL eine Webressource ist, kann sie lediglich die Parameter übernehmen, die im Thema Parameter an HTML-Webressourcen übergeben identifiziert werden. Die einzige Möglichkeit, benutzerdefinierte Werte zu übermitteln ist, sie in den data-Parameter einzuschließen. Spezielle Behandlung ist erforderlich, um mehrere Werte in einem einzigen Parametern einzuschließen.Weitere Informationen:Beispiel: Mehrere Werte über den Datenparameter an eine Webressource übergeben

Siehe auch

Anpassen von Befehlen und des Menübands
Öffnen von Formularen, Ansichten, Dialogen und Berichten mit einer URL
<Url> (RibbonDiffXml)
Definieren von Menüband-Registerkartenanzeigenregeln
Beispiel: Exportieren von Menübanddefinitionen

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright