Share via


<CrmParameter> (RibbonDiffXml)

Si applica a: CRM 2016 on-prem, CRM Online

Rappresenta i dati recuperati dall'applicazione Microsoft Dynamics CRM che è possibile passare come parametro.

Sintassi

<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"]
 />

Attributi ed elementi

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

Attributi

Attribute Description Type Usage

Name

Rappresenta il nome di un parametro stringa di query passato per il valore quando si utilizza un elemento URL.

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

String

See Remarks

Value

Specifica il valore da passare come parametro.

Valid values:

 

Value Description

CommandProperties

Oggetto con le tre proprietà seguenti: SourceControlId, CommandValueId e 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

Numero che rappresenta il tipo univoco dell'entità per una distribuzione specifica di Microsoft CRM.

PrimaryEntityTypeName

Stringa che rappresenta il nome univoco di un'entità.

PrimaryItemIds

Matrice di stringhe che fornisce i valori ID GUID per l'elemento primario.

FirstPrimaryItemId

Fornisce un identificatore GUID come stringa per il record visualizzato.

PrimaryControl

Oggetto che fa riferimento al controllo che presentava lo stato attivo quando si è verificata l'azione del Comando barra multifunzione.

PrimaryControlId

Stringa che fornisce il valore ID del controllo con lo stato attivo.

SelectedEntityTypeCode

Numero che rappresenta il tipo univoco dell'entità per un record selezionato in una griglia. Il codice del tipo di entità varia a seconda della distribuzione.

SelectedEntityTypeName

Stringa che rappresenta il nome univoco dell'entità per un record selezionato in una griglia.

FirstSelectedItemId

Fornisce un identificatore GUID come stringa per il primo elemento selezionato in una griglia.

SelectedControl

Oggetto che fa riferimento al controllo che presentava lo stato attivo quando si è verificata l'azione del Comando barra multifunzione.

SelectedControlSelectedItemCount

Numero di elementi selezionati in una griglia.

SelectedControlSelectedItemIds

Matrice di stringhe di valori ID GUID per tutti gli elementi selezionati in una griglia.

SelectedControlSelectedItemReferences

Matrice di oggetti EntityReference che rappresentano tutti gli elementi selezionati nella griglia.

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

SelectedControlAllItemCount

Numero totale di elementi visualizzati in una griglia.

SelectedControlAllItemIds

Matrice di stringhe che fornisce valori ID GUID per tutti gli elementi visualizzati in una griglia.

SelectedControlAllItemReferences

Matrice di oggetti EntityReference che rappresentano tutti gli elementi nella griglia.

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

SelectedControlUnselectedItemCount

Numero di elementi non selezionati in una griglia.

SelectedControlUnselectedItemIds

Matrice di stringhe di valori ID GUID per tutti gli elementi non selezionati in una griglia.

SelectedControlUnselectedItemReferences

Matrice di oggetti EntityReference che rappresentano tutti gli elementi non selezionati nella griglia.

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

OrgName

Nome dell'organizzazione.

OrgLcid

Codice della lingua che rappresenta la lingua di base per l'organizzazione.

UserLcid

Codice della lingua che rappresenta la preferenza di lingua scelta dall'utente..

Enumeration

Required

Elementi figlio

Questo elemento non presenta elementi figlio.

Elementi padre

Element Description

<JavaScriptFunction> (RibbonDiffXml)

Specifica un'azione tramite cui viene chiamata una funzione da una libreria JavaScript specifica.

<CustomRule> (RibbonDiffXml)

Specifica una regola utilizzata con una definizione EnableRule composta da un riferimento a una funzione in una libreria JavaScript.

<Url> (RibbonDiffXml)

Azione tramite cui viene aperta una pagina Web a un indirizzo specificato.

Note

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.

Nota

  • 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.

Nota

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.

Informazioni elemento

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

Vedere anche

Altre risorse

Personalizzare i comandi e la barra multifunzione

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