Freigeben über

Microsoft Dynamics CRM-Daten von einer Seite als Parameter an Menüband-Aktionen übermitteln

  • Artikel

 

Veröffentlicht: November 2016

Gilt für: Dynamics CRM 2015

Wenn Sie eine Aktion in einem Menüband definiert haben, müssen Sie oft Daten vonder Seite entweder an eine JavaScript-Funktion oder ein URL übermitteln. In diesem Thema werden die Optionen für die Verwendung des Elements <CrmParameter> (RibbonDiffXml) zum Abrufen dieser Werte beschrieben.

Rasterwerte

Die meisten der Werte, die für das <CrmParameter> (RibbonDiffXml)-Element verfügbar sind, beziehen sich auf das Arbeiten mit Daten, die in einem Raster oder einem Hierarchiediagramm angezeigt werden. Durch Verwendung derValue-Attributaufzählungsoptionen können Sie problemlos Elemente isolieren, indem Sie folgendermaßen vorgehen:

  • Ausgewählte Elemente

    • SelectedControlSelectedItemCount

    • SelectedControlSelectedItemIds

    • SelectedControlSelectedItemReferences

  • Alle Elemente

    • SelectedControlAllItemCount

    • SelectedControlAllItemIds

    • SelectedControlAllItemReferences

  • Nicht ausgewählte Elemente

    • SelectedControlUnselectedItemCount

    • SelectedControlUnselectedItemIds

    • SelectedControlUnselectedItemReferences

Für jede dieser Gruppierungen können Sie die Anzahl der Elemente und den GUID-Bezeichner sammeln. Wenn Sie die Werte an ein URL übergebenn, können Sie auch EntityReference-Objekte abrufen, die alle Informationen enthalten, die Sie benötigen, um die Objekte eindeutig zu identifizieren. Diese Parameter treffen zu, wenn die angezeigte Seite das das Hauptraster (HomepageGrid) oder ein Unterraster in einem Formular ist. Werden sie zusammen mit dem SelectedEntityTypeName-Parameter verwendet, haben Sie alle Informationen, die Sie an eine andere Anwendung übergeben müssen.

Formularwerte

Mit einem Formularmenüband können Sie die Xrm.Page.data.entity.Attribute-Sammlung und die Xrm.Page.ui.Steuerelemente-Sammlung verwenden, um Werte für bekannte Felder abzurufen. Wenn Sie dagegen den Wert eines ausgewählten Formularfelds übergeben möchten, müssen Sie weitere Skripterstellung ausführen, um den Wert zu erhalten.

Sie können den Parameter PrimaryControlId verwenden, um den Id-Wert für das Steuerelement abzurufen, das den Fokus hat, als das Menübandsteuerelement den Fokus erhielt. Dieses Id ist der Dokumentobjektmodell (DOM) Id-Wert. Um den Datenwert abzurufen, müssen Sie versuchen, diesen Wert zu verwenden, indem Sie Code verwenden wie den im folgenden Beispiel:

var focusFieldValue = Xrm.Page.ui.controls.get(PrimaryControlId).getAttribute().getValue()

Kontextinformationen

Zusätzlich zu den Datenwerten können Sie zusätzliche Kontextinformationen abrufen, indem Sie <CrmParameter> (RibbonDiffXml) verwenden.

Zur bequemlichkeit sind die Value-Attributoptionen OrgName, OrgLcid, und UserLcid verfügbar, ohne dass Sie Xrm.Page.context verwenden müssen, um die getOrgUniqueName, getOrgLcid und getUserId-Methoden zu verwenden. Für eine <Url> (RibbonDiffXml)-Aktion können Sie auch das PassParams-Attribut verwenden, um kontextbezogenene Informationen zu berücksichtigen.

Die Value-Optionen PrimaryEntityTypeName und FirstPrimaryItemId stellen Informationen zu einem Entitätsdatensatz zur Verfügung. Sie können PrimaryItemIds für ein HomepageGrid-Menüband verwenden, um eine Liste aller angezeigten Elemente zu erhalten.

Schließlich können auch den CommandProperties-Wert verwenden, um Details über das Element vom Menübandsteuerelement zu übergeben. Sie können dies verwenden, um Kontextinformationen an eine zentrale Funktion zu senden, in der bestimmte Aktionen basierend auf dem Kontext des Ereignisses bestimmt werden können.

Siehe auch

Anpassen von Befehlen und des Menübands
Parameter mit dem Menüband an eine URL übergeben
<CrmParameter> (RibbonDiffXml)
<JavaScriptFunction> (RibbonDiffXml)
<Url> (RibbonDiffXml)
Definieren von Menübandaktionen
Festlegen benutzerdefinierter Aktionen zur Änderung des Menübands

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright