The following table lists the attributes, child elements, and parent elements.
Attributs
Attribute
Description
Type
Usage
Name
Représente le nom d'un paramètre de chaîne de requête transmis pour cette valeur lorsqu'un élément Url est utilisé.
Represents the name of a query string parameter passed using the <Url> (RibbonDiffXml) element.
String
See Remarks
Value
Spécifie la valeur devant être transmise sous la forme d'un paramètre.
Valid values:
Value
Description
CommandProperties
Objet avec les trois propriétés suivantes : SourceControlId, CommandValueId et 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.
PrimaryEntityTypeCode
Nombre représentant le type unique de l'entité pour un déploiement Microsoft CRM spécifique.
PrimaryEntityTypeName
Chaîne représentant le nom unique d'une entité.
PrimaryItemIds
Tableau de chaînes fournissant les valeurs d'ID GUID pour l'élément principal.
FirstPrimaryItemId
Indique un identificateur GUID en tant que chaîne pour l'enregistrement affiché.
PrimaryControl
Objet référençant le contrôle sélectionné lors de l'exécution de l'action de la commande du ruban.
PrimaryControlId
Chaîne fournissant la valeur d'ID du contrôle sélectionné.
SelectedEntityTypeCode
Nombre représentant le type unique de l'entité pour un enregistrement sélectionné dans une grille. Le code de type d'entité varie entre les déploiements.
SelectedEntityTypeName
Chaîne représentant le nom unique de l'entité pour un enregistrement sélectionné dans une grille.
FirstSelectedItemId
Indique un identificateur GUID en tant que chaîne pour le premier élément sélectionné dans une grille.
SelectedControl
Objet référençant le contrôle sélectionné lors de l'exécution de l'action de la commande du ruban.
SelectedControlSelectedItemCount
Nombre d'éléments sélectionnés dans une grille.
SelectedControlSelectedItemIds
Tableau de chaînes des valeurs d'ID GUID pour tous les éléments sélectionnés dans une grille.
SelectedControlSelectedItemReferences
Tableau d'objets EntityReference représentant tous les éléments non sélectionnés dans la grille.
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.
Notes
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.