<CrmParameter> (RibbonDiffXml)

Betrifft: CRM 2016 on-prem, CRM Online

Stellt aus der Microsoft Dynamics CRM-Anwendung abgerufene Daten dar, die als Parameter übergeben werden können.

Syntax

<CrmParameter
 Name = “String”
 Value= ["CommandProperties" |
         "PrimaryEntityTypeCode" |
         "PrimaryEntityTypeName" |
         "PrimaryItemIds" |
         "FirstPrimaryItemId" |
         "PrimaryControl" |
         "PrimaryControlId" |
         "SelectedEntityTypeCode" |
         "SelectedEntityTypeName" |
         "FirstSelectedItemId" |
         "SelectedControl" |
         "SelectedControlSelectedItemCount" |
         "SelectedControlSelectedItemIds" |
         "SelectedControlSelectedItemReferences" |
         "SelectedControlAllItemCount" |
         "SelectedControlAllItemIds" |
         "SelectedControlAllItemReferences" |
         "SelectedControlUnselectedItemCount" |
         "SelectedControlUnselectedItemIds" |
         "SelectedControlUnselectedItemReferences" |
         "OrgName" |
         "OrgLcid" |
         "UserLcid"]
 />

Attribute und Elemente

The following table lists the attributes, child elements, and parent elements.

Attribute

Attribute Description Type Usage

Name

Stellt den Namen eines für diesen Wert übergebenen Abfragezeichenfolgenparameters dar, wenn ein URL-Element verwendet wird.

Represents the name of a query string parameter passed using the <Url> (RibbonDiffXml) element.

String

See Remarks

Value

Gibt den Wert an, der als Parameter übergeben wird.

Valid values:

 

Value Description

CommandProperties

Ein Objekt mit den folgenden drei Eigenschaften: SourceControlId, CommandValueId und MenuItemId

  • SourceControlId : The Id value of the Ribbon control that initiated the event.

  • CommandValueId : A string that is sent with the command event when a button is clicked.

  • MenuItemId: A reference from a control to the Id of a menu item.

Most entities will not return a MenuItemId value. Only the following entities will return this value:

  • BusinessUnit

  • Connection

  • CustomerAddress

  • Equipment

  • Goal

  • InvoiceDetail

  • Mailbox

  • MailMergeTemplate

  • PartnerApplication

  • QueueItem

  • QuoteDetail

  • RoutingRuleItem

  • SalesOrderDetail

  • ServiceAppointment

  • SharePointDocumentLocation

  • SharePointSite

  • Territory

PrimaryEntityTypeCode

Eine Zahl, die den eindeutigen Typ der Entität für eine bestimmte Microsoft CRM-Bereitstellung darstellt.

PrimaryEntityTypeName

Eine Zeichenfolge, die den eindeutigen Namen einer Entität darstellt.

PrimaryItemIds

Ein Zeichenfolgenarray, das die GUID-ID-Werte für das primäre Element angibt.

FirstPrimaryItemId

Enthält einen GUID-Bezeichner als Zeichenfolge für den angezeigten Datensatz.

PrimaryControl

Ein Objekt, das auf das Steuerelement verweist, das den Fokus hatte, als die Menübandbefehl-Aktion ausgeführt wurde.

PrimaryControlId

Eine Zeichenfolge, die den ID-Wert des Steuerelements angibt, das den Fokus hatte.

SelectedEntityTypeCode

Eine Zahl, die den eindeutigen Typ der Entität für einen im Raster ausgewählten Datensatz darstellt. Der Entitätstypcode variiert zwischen Bereitstellungen.

SelectedEntityTypeName

Eine Zeichenfolge, die den eindeutigen Namen der Entität für einen im Raster ausgewählten Datensatz darstellt.

FirstSelectedItemId

Enthält einen GUID-Bezeichner als Zeichenfolge für das erste in einem Raster ausgewählte Element.

SelectedControl

Ein Objekt, das auf das Steuerelement verweist, das den Fokus hatte, als die Menübandbefehl-Aktion ausgeführt wurde.

SelectedControlSelectedItemCount

Die Anzahl ausgewählter Elemente in einem Raster.

SelectedControlSelectedItemIds

Ein Zeichenfolgenarray mit GUID-ID-Werten für alle ausgewählten Elemente in einem Raster.

SelectedControlSelectedItemReferences

Ein Array von EntityReference-Objekten, die alle ausgewählten Elemente im Raster darstellen.

This option is only available when used with the <JavaScriptFunction> (RibbonDiffXml) element.

SelectedControlAllItemCount

Eine Zahl, die die Gesamtanzahl der in einem Raster angezeigten Elemente angibt.

SelectedControlAllItemIds

Ein Zeichenfolgenarray, das die GUID-ID-Werte für alle in einem Raster angezeigten Elemente angibt.

SelectedControlAllItemReferences

Ein Array von EntityReference-Objekten, die alle Elemente im Raster darstellen.

This option is only available when used with the <JavaScriptFunction> (RibbonDiffXml) element.

SelectedControlUnselectedItemCount

Die Anzahl nicht ausgewählter Elemente in einem Raster.

SelectedControlUnselectedItemIds

Ein Zeichenfolgenarray mit GUID-ID-Werten für alle nicht ausgewählten Elemente in einem Raster.

SelectedControlUnselectedItemReferences

Ein Array von EntityReference-Objekten, die alle nicht ausgewählten Elemente im Raster darstellen.

This option is only available when used with the <JavaScriptFunction> (RibbonDiffXml) element.

OrgName

Der Name der Organisation.

OrgLcid

Der Sprachcode, der die Ausgangssprache für die Organisation darstellt.

UserLcid

Der Sprachcode, der die vom Benutzer ausgewählte Spracheinstellung darstellt..

Enumeration

Required

Untergeordnete Elemente

Diese Element verfügt nicht über untergeordnete Elemente.

Übergeordnete Elemente

Element Description

<JavaScriptFunction> (RibbonDiffXml)

Gibt eine Aktion an, die eine Funktion von einer bestimmten JavaScript-Bibliothek aufruft.

<CustomRule> (RibbonDiffXml)

Gibt eine mit einer EnableRule-Definition verwendete Regel an, die aus einem Verweis auf eine Funktion in einer JavaScript-Bibliothek besteht.

<Url> (RibbonDiffXml)

Ein Aktion, mit der eine Webseite an einer bestimmten Adresse geöffnet wird.

Anmerkungen

When the CrmParameter is a child of the <Url> (RibbonDiffXml) a Name attribute is required. When the CrmParameter is a child of the <JavaScriptFunction> (RibbonDiffXml) element, the Name attribute is not valid.

Hinweis

  • Value attributes referring to a "Primary..." item refer to the record being viewed in the form.

  • Value attributes referring to the "Selected..." item refer to rows selected within a grid.

When a grid is presented within a form or as an associated view the "Primary.." values refer to the record context in which the grid is displayed. This is true as long as the grid is associated with an entity relationship.

When a grid is displayed independently from any entity relationship, such as in the Homepage grid or if a subgrid is added to a form without being associated with an entity relationship, the "Primary..." values will be null.

Hinweis

Some CrmParameter values pass an EntityReference object. This object contains the following properties:

  • Id: A string of the GUID Id value for the record.

  • Name: A string of the value of the Primary field for the record.

  • TypeCode: A number representing the unique type of entity for the record.

  • TypeName: A string representing the unique name of the entity for the record.

Elementinformationen

XPath

//RibbonDiffXml/CommandDefinitions/CommandDefinition/Actions/JavaScriptFunction/CrmParameter |
//RibbonDiffXml/CommandDefinitions/CommandDefinition/Actions/Url/CrmParameter |
//RibbonDiffXml/RuleDefinitions/EnableRules/EnableRule/CustomRule/CrmParameter |
//RibbonDiffXml/RuleDefinitions/EnableRules/EnableRule/OrRule/Or/CustomRule/CrmParameter |
//RibbonDiffXml/RuleDefinitions/DisplayRules/DisplayRule/CustomRule/CrmParameter |
//RibbonDiffXml/RuleDefinitions/DisplayRules/DisplayRule/OrRule/Or/CustomRule/CrmParameter

Schema Name

  • CrmParameterType

  • CrmNamedParameterType

Validation File

RibbonTypes.xsd

Can be Empty

Yes

Siehe auch

Weitere Ressourcen

Anpassen von Befehlen und des Menübands

Microsoft Dynamics CRM 2016 and Microsoft Dynamics CRM Online
Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.