다음을 통해 공유

사용자 지정 작업을 정의하여 리본 수정

  • 아티클

 

게시 날짜: 2017년 1월

적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

기본값, 응용 프로그램 명령 모음 또는 리본이 Microsoft Dynamics 365 메타데이터에서 정의됩니다. 이 기본 데이터는 변경할 수 없지만 기본 리본을 다시 정의하는 특정 작업에 대한 정의를 포함할 수 있습니다.

사용자 지정 작업 유형

리본에 대한 사용자 지정 작업 유형은 두 가지입니다.

사용자 지정 작업

사용자 지정 작업은 기본 리본 정의를 변경하려는 방법에 대한 문입니다. 런타임에 평가되고 리본에 적용됩니다. 사용자 지정 작업에 대한 컨텍스트를 설정하려면 변경할 항목의 위치에 대한 정보가 있어야 합니다.Location 특성을 사용하여 변경 내용을 적용할 위치를 지정합니다.

새 리본 요소를 추가하면 기존 탭이나 그룹과 같이 포함하는 요소를 참조합니다. 그런 다음 접두사 ._children을 포함하여 이 사용자 지정 작업이 기존 항목에 뭔가를 추가함을 나타냅니다.

기존 항목의 정의를 변경하면 Location 값은 해당 항목의 ID를 검색합니다.

사용자 지정 작업에 대한 고유 식별자도 지정해야 합니다.Id 특성을 사용하여 이 값을 설정합니다. 고유한 값을 보증하는 명명 규칙을 사용하는 것이 좋습니다. 일관성과 가독성을 위해 마침표를 사용하여 일관된 구성 요소를 구분하는 것이 좋습니다. 명명 규칙에서 첫 번째 항목은 Contoso.contact.form.CustomButton.CustomAction과 같이 솔루션 게시자 또는 솔루션과 관련된 무엇인가여야 합니다.

팁

Id 특성에 명명 규칙을 일관되게 적용하면 RibbonDiffXml을 편집하는 동안 생산성이 크게 향상됩니다.

제공하는 위치 정보에 따라 Sequence 특성 값은 항목을 렌더링하는 순서를 결정합니다. 두 기존 컨트롤 사이에 사용자 지정 컨트롤을 표시하도록 하려면 기존 항목의 시퀀스 값 사이에서 시퀀스 값을 선택해야 합니다.

사용자 지정 작업 숨기기

<HideCustomAction> (RibbonDiffXml)은 기존 리본 요소가 렌더링되지 않도록 제거하려고 할 때 사용할 문입니다. 이 문은 리본 요소를 숨기지 않고 리본에 존재하지 않도록 실제로 리본 요소를 런타임에 제거합니다.

참고

HideCustomAction 요소는 리본에서 지정된 노드를 제거하므로 이 방식으로 리본 요소를 제거하는 것은 일부 상황에서는 좋은 선택이 아닙니다.

  • 특정 권한에 연결된 단추를 제거하려면 현재 구현의 보안 역할에서 엔터티에 대한 권한을 조정해야 합니다. 그러면 기본 리본이 지연되고 이러한 작업을 수행하는 데 필요한 권한이 없는 사용자에게 리본 요소를 숨기거나 비활성화하는 규칙을 활성화할 수 있습니다.

  • 기존 리본 요소를 사용자 지정 리본 요소로 바꾸려면 기존 요소와 동일한 CustomAction.Location 값을 지정하여 해당 요소를 덮어쓸 수 있습니다.

HideActionId 요소는 작업에 대해 고유 ID를 제공합니다. 일관성 및 가독성을 위해 <CustomAction> 요소에 대해 설명되어 있는 동일한 명명 규칙을 따라야 합니다.위치 특성은 제거할 리본 요소의 Id를 검색해야 합니다.

참고 항목

명령 및 리본 사용자 지정
페이지에서 리본 동작에 매개 변수로 Microsoft Dynamics 365 데이터 전달
리본 요소에 대한 배율 정의

Microsoft Dynamics 365

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