<CrmParameter> (RibbonDiffXml)

아티클
12/05/2014

적용 대상: CRM 2015 on-prem, CRM Online

매개 변수로 전달할 수 있는 Microsoft Dynamics CRM 응용 프로그램에서 검색한 데이터를 나타냅니다.

구문

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

특성 및 요소

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

특성

Name

URL 요소를 사용할 때 이 값에 대해 전달되는 쿼리 문자열 매개 변수의 이름을 나타냅니다.

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

String

See Remarks

Value

매개 변수로 전달할 값을 지정합니다.

Valid values:

Value	Description
CommandProperties	SourceControlId, CommandValueId 및 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	특정 Microsoft CRM 배포에 대해 고유한 엔터티 형식을 나타내는 숫자입니다.
PrimaryEntityTypeName	엔터티의 고유 이름을 표시하는 문자열입니다.
PrimaryItemIds	기본 항목의 GUID ID 값을 제공하는 문자열 배열입니다.
FirstPrimaryItemId	표시되는 레코드에 대해 하나의 GUID 식별자를 문자열로 제공합니다.
PrimaryControl	리본 명령 작업이 수행될 때 포커스를 가지고 있던 컨트롤을 참조하는 개체입니다.
PrimaryControlId	포커스를 가진 컨트롤의 ID 값을 제공하는 문자열입니다.
SelectedEntityTypeCode	표에서 선택한 레코드에 대한 엔터티의 고유 유형을 나타내는 숫자입니다. 엔터티 형식 코드는 배포마다 다릅니다.
SelectedEntityTypeName	표에서 선택한 레코드에 대해 엔터티의 고유 이름을 표시하는 문자열입니다.
FirstSelectedItemId	표에서 선택한 첫 번째 항목에 대해 하나의 GUID 식별자를 문자열로 제공합니다.
SelectedControl	리본 명령 작업이 수행될 때 포커스를 가지고 있던 컨트롤을 참조하는 개체입니다.
SelectedControlSelectedItemCount	표에서 선택한 항목의 수입니다.
SelectedControlSelectedItemIds	표에서 선택한 모든 항목에 대한 GUID ID 값의 문자열 배열입니다.
SelectedControlSelectedItemReferences	표에서 선택하지 않은 모든 항목을 나타내는 EntityReference 개체의 배열입니다. This option is only available when used with the <JavaScriptFunction> (RibbonDiffXml) element.
SelectedControlAllItemCount	표에 표시되는 총 항목 수를 표시하는 숫자입니다.
SelectedControlAllItemIds	표에 표시된 모든 항목에 대한 GUID ID 값을 제공하는 문자열 배열입니다.
SelectedControlAllItemReferences	표의 모든 항목을 나타내는 EntityReference 개체의 배열입니다. This option is only available when used with the <JavaScriptFunction> (RibbonDiffXml) element.
SelectedControlUnselectedItemCount	표에서 선택하지 않은 항목의 수입니다.
SelectedControlUnselectedItemIds	표에서 선택하지 않은 모든 항목에 대한 GUID ID 값의 문자열 배열입니다.
SelectedControlUnselectedItemReferences	표에서 선택하지 않은 모든 항목을 나타내는 EntityReference 개체의 배열입니다. This option is only available when used with the <JavaScriptFunction> (RibbonDiffXml) element.
OrgName	조직의 이름입니다.
OrgLcid	조직의 기본 언어를 표시하는 언어 코드입니다.
UserLcid	사용자가 선택한 언어 기본 설정을 표시하는 언어 코드입니다..

Enumeration

Required

하위 요소

이 요소에는 하위 요소가 없습니다.

상위 요소

Element	Description
<JavaScriptFunction> (RibbonDiffXml)	특정 JavaScript 라이브러리에서 함수를 호출하는 작업을 지정합니다.
<CustomRule> (RibbonDiffXml)	JavaScript 라이브러리 내의 함수에 대한 참조로 구성된 EnableRule 정의와 함께 사용되는 규칙을 지정합니다.
<Url> (RibbonDiffXml)	지정된 주소의 웹 페이지를 여는 작업입니다.

설명

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.

참고

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.

참고

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.

요소 정보

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

참고 항목

기타 리소스

명령 및 리본 사용자 지정

다음을 통해 공유