<CrmParameter> (RibbonDiffXml)

Artikel
01/14/2016

Gælder for: CRM 2016 on-prem, CRM Online

Repræsenterer data, der hentes fra Microsoft Dynamics CRM-programmet, som kan overføres som en parameter.

Syntaks

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

Attributter og elementer

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

Attributter

Name

Repræsenterer navnet på strengparameteren for en forespørgsel, der er overført for denne værdi, når der bruges et URL-element.

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

String

See Remarks

Value

Angiver den værdi, der skal overføres som en parameter.

Valid values:

Value	Description
CommandProperties	Et objekt med følgende tre egenskaber: SourceControlId, CommandValueId og 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	Et tal, der repræsenterer den entydige objekttype for en bestemt installation af Microsoft CRM.
PrimaryEntityTypeName	En streng, der repræsenterer det entydige navn på et objekt.
PrimaryItemIds	En strengmatrix, der angiver GUID-id'et for det primære element.
FirstPrimaryItemId	Angiver ét GUID-id som en streng for den post, der vises.
PrimaryControl	Et objekt, der henviser til det objekt, der havde fokus, da handlingen Kommando på bånd indtraf.
PrimaryControlId	En streng, der angiver id-værdien for det kontrolelement, der har fokus.
SelectedEntityTypeCode	Et tal, der repræsenterer den entydige objekttype for en post, der er valgt i et gitter. Objektkoden varierer, afhængigt af installationen.
SelectedEntityTypeName	En streng, der repræsenterer det entydige navn på objektet for en post, der er valgt i et gitter.
FirstSelectedItemId	Angiver ét GUID-id som en streng for det første element, der vælges i et gitter.
SelectedControl	Et objekt, der henviser til det objekt, der havde fokus, da handlingen Kommando på bånd indtraf.
SelectedControlSelectedItemCount	Antallet af markerede elementer i et gitter.
SelectedControlSelectedItemIds	En strengmatrix med GUID-id-værdier for alle valgte elementer i et gitter.
SelectedControlSelectedItemReferences	En matrix med EntityReference-objekter, der repræsenterer alle elementer, som er valgt i gitteret. This option is only available when used with the <JavaScriptFunction> (RibbonDiffXml) element.
SelectedControlAllItemCount	Et tal, der viser det samlede antal elementer, der vises i et gitter.
SelectedControlAllItemIds	En strengmatrix, der angiver GUID-id-værdierne for alle elementer, der vises i et gitter.
SelectedControlAllItemReferences	En matrix med EntityReference-objekter, der repræsenterer alle elementerne i gitteret. This option is only available when used with the <JavaScriptFunction> (RibbonDiffXml) element.
SelectedControlUnselectedItemCount	Antallet af ikke-markerede elementer i et gitter.
SelectedControlUnselectedItemIds	En strengmatrix med GUID-id-værdier for alle ikke-valgte elementer i et gitter.
SelectedControlUnselectedItemReferences	En matrix med EntityReference-objekter, der repræsenterer alle elementer, der ikke er valgt i gitteret. This option is only available when used with the <JavaScriptFunction> (RibbonDiffXml) element.
OrgName	Navnet på organisationen.
OrgLcid	Den sprogkode, der repræsenterer udgangssproget for organisationen.
UserLcid	Den sprogkode, der repræsenterer det foretrukne sprog, brugeren har valgt..

Enumeration

Required

Underordnede elementer

Dette element har ingen underordnede elementer.

Overordnede elementer

Element	Description
<JavaScriptFunction> (RibbonDiffXml)	Angiver en handling, der kalder en funktion fra et bestemt JavaScript-bibliotek.
<CustomRule> (RibbonDiffXml)	Angiver en regel, der bruges sammen med en EnableRule-definition, som består af en reference til en funktion i et JavaScript-bibliotek.
<Url> (RibbonDiffXml)	En handling, der bruges til at åbne en webside på en angivet adresse.

Bemærkninger

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.

Bemærk

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.

Bemærk

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.

Elementoplysninger

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

Se også

Andre ressourcer

Tilpasse kommandoer og båndet

Del via