<ContextualGroup>(RibbonDiffXml)

  • 아티클

 

게시 날짜: 2016년 11월

적용 대상: Dynamics CRM 2015

특정 컨텍스트 내에 표시할 탭의 모음이 들어 있습니다.

구문

<ContextualGroup
 Color=[ "None" | "DarkBlue" | "LightBlue" | "Teal" | "Orange" | "Green" | "Magenta" | "Yellow" | "Purple"]
 Command="String"
 ContextualGroupId="String"
 Id="String"
 Sequence="Integer"
 Title="String" >
  <Tab />
</ContextualGroup>

특성 및 요소

다음 표는 특성, 자식 요소 및 부모 요소를 나열합니다.

특성

특성

설명

유형

사용법

Color(색)

그룹에 대한 색 구성표를 지정합니다.

유효한 값은 다음과 같습니다.

  • 없음

  • 진한 파랑

  • 연한 파랑

  • 진한 청록

  • 주황색

  • Green(녹색)

  • 자홍

  • 노랑

  • 보라색

열거형

선택 참석자

명령

이 컨트롤에 대한 리본 명령의 ID를 지정합니다.

문자열

선택 참석자

ContextualGroupId

Mscrm.VisualizationTools 같은 컨텍스트 그룹을 식별하는 문자열입니다.

문자열

선택 참석자

Id

리본 요소의 정의에 대한 고유 식별자를 지정합니다. 적극 권장되는 명명 규칙은 [solution identifier].[entity].[ribbon].[function].[element name]과 같이 마침표를 사용하여 이름의 부분을 분리하는 것입니다. 예를 들면 MyISV.account.form.SendToOtherSystem.Button과 같습니다.

여러 엔터티에서 사용할 리본 요소를 정의할 때 Id 특성에서 {!EntityLogicalName} 토큰을 사용합니다. 이는 엔터티 논리 이름을 Id 값에 삽입하여 Id 값이 전역적으로 고유하도록 해줍니다.

예를 들어, 거래처 엔터티가 있는 MyISV.{!EntityLogicalName}.form.SendToOtherSystem.Button를 사용하는 경우 Id는 MyISV.account.form.SendToOtherSystem.Button이 됩니다. 연락처 엔터티의 경우 Id는 MyISV.contact.form.SendToOtherSystem.Button이 됩니다.

> [!IMPORTANT] >

전역적으로 고유한 Id 값을 설정하지 않는 경우 리본이 표시되지 않을 수 있습니다.

문자열

필수 참석자

순서

기존 리본 요소보다 높거나 낮은 시퀀스 값을 설정하여 리본 수정 위치를 지정합니다.

정수

선택 참석자

제목

이 요소는 Microsoft Dynamics CRM에서 사용되지 않습니다.

문자열

선택 참석자

자식 요소

Element(요소)

설명

<Tab> (RibbonDiffXml)

리본에 탭을 지정합니다.

부모 요소

Element(요소)

설명

<CommandUIDefinition> (RibbonDiffXml)

CustomAction 요소 내에 포함될 시각적 리본 요소를 지정합니다.

설명

이전에 정의된 ContextualGroup을 내보내면 ContextualGroup 및 포함되어 있는 모든 <Tab> (RibbonDiffXml) 엔터티가 별도의 <CustomAction> (RibbonDiffXml) 요소로 리팩터링되는 것을 볼 수 있습니다. 이는 Microsoft Dynamics CRM 2015 및 Microsoft Dynamics CRM Online 2015 업데이트에서 데이터베이스에 데이터를 저장하는 방식으로 인한 것입니다. 원래 정의의 동작은 바뀌지 않습니다.

예를 들어,다음 의사 코드 조각에 나와 있는 것처럼 ContextualGroup을 추가하기 위해 <CustomAction> (RibbonDiffXml)를 정의하는 경우:

<CustomAction Location='Mscrm.ContextualGroups._children' >   <CommandUIDefinition>      <ContextualGroup Id='CG1'>         <Tab Id='T1'>...</Tab>         <Tab Id='T2'>...</Tab>      </ContextualGroup>   </CommandUIDefinition></CustomAction>

나중에 이 정의를 포함하여 사용자 지정을 내보낼 때 정의가 다음 의사 코드 조각에 나와 있는 것처럼 나타난다고 예상해야 합니다.

<CustomAction Location='Mscrm.ContextualGroups._children' >   <CommandUIDefinition>      <ContextualGroup Id='CG1' />   </CommandUIDefinition></CustomAction><CustomAction Location='CG1._children'>   <CommandUIDefinition>      <Tab Id='T1'>...</Tab>   </CommandUIDefinition></CustomAction><CustomAction Location='CG1._children'>   <CommandUIDefinition>      <Tab Id='T2'>...</Tab>   </CommandUIDefinition></CustomAction>

요소 정보

XPath

 
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/ContextualGroup

스키마 이름

ContextualGroupType

유효성 검사 파일

RibbonWSS.xsd

비워 둘 수 있음

예

참고 항목

명령 및 리본 사용자 지정
Ribbon XML reference

© 2017 Microsoft. All rights reserved. 저작권 정보