다음을 통해 공유

페이지에서 리본 동작에 매개 변수로 Microsoft Dynamics 365 데이터 전달

  • 아티클

 

게시 날짜: 2017년 1월

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

리본에서 동작을 정의하는 경우 페이지에서 종종 JavaScript 함수 또는 URL로 데이터를 전달해야 합니다. 이 항목에서는 <CrmParameter> (RibbonDiffXml) 요소를 사용하여 이러한 값을 검색하는 옵션에 대해 설명합니다.

표 값

<CrmParameter> (RibbonDiffXml) 요소에 사용할 수 있는 대부분의 값은 표 또는 계층 구조 차트에서 표시되는 데이터 사용과 관련됩니다.Value 특성 열거형 옵션을 사용하면 항목을 쉽게 격리할 수 있습니다.

  • 선택한 항목

    • SelectedControlSelectedItemCount

    • SelectedControlSelectedItemIds

    • SelectedControlSelectedItemReferences

  • 모든 항목

    • SelectedControlAllItemCount

    • SelectedControlAllItemIds

    • SelectedControlAllItemReferences

  • 선택하지 않은 항목

    • SelectedControlUnselectedItemCount

    • SelectedControlUnselectedItemIds

    • SelectedControlUnselectedItemReferences

이러한 각 그룹에 대해 항목 수와 GUID 식별자를 수집할 수 있습니다. 값을 URL에 전달할 경우 표의 개체를 고유하게 식별하는 데 필요한 모든 정보가 포함된 EntityReference 개체도 검색할 수 있습니다. 이러한 매개 변수는 표시되는 페이지가 양식에서 기본 표(HomepageGrid)인지 아니면 양식에서 하위 표인지 적용합니다.SelectedEntityTypeName 매개 변수와 함께 사용하면 다른 응용 프로그램으로 전달해야 하는 모든 정보를 가집니다.

양식 값

양식 리본을 사용하면 Xrm.Page.data.entity.특성 컬렉션과 Xrm.Page.ui.제어 컬렉션을 사용하여 알려진 필드의 값을 검색할 수 있습니다. 하지만 선택한 양식 필드의 값을 전달하려는 경우 값을 가져오기 위해 더 자세한 스크립트를 작성해야 합니다.

리본 컨트롤에 포커스가 있으면 PrimaryControlId 매개 변수를 사용하여 포커스가 있는 컨트롤의 Id 값을 가져올 수 있습니다. 이 Id는 DOM(문서 개체 모델) Id 값입니다. 데이터 값을 가져오려면 다음 예제에 있는 것과 같은 코드를 사용하여 해당 값을 사용해야 합니다.

var focusFieldValue = Xrm.Page.ui.controls.get(PrimaryControlId).getAttribute().getValue()

컨텍스트 정보

데이터 값 외에도 <CrmParameter> (RibbonDiffXml)를 사용하여 추가 컨텍스트 정보를 검색할 수 있습니다.

편의상 Value 특성 옵션 OrgName, OrgLcid 및 UserLcid는 getOrgUniqueName, getOrgLcid 및 getUserId를 사용하기 위해 Xrm.Page.context를 사용할 필요 없이 사용할 수 있습니다.<Url> (RibbonDiffXml) 동작의 경우 PassParams 특성을 사용하여 상황별 정보를 포함할 수 있습니다.

Value 옵션 PrimaryEntityTypeName 및 FirstPrimaryItemId는 엔터티 레코드에 대한 정보를 제공합니다. 표시된 항목 목록을 가져오기 위해 HomepageGrid 리본에 대해 PrimaryItemIds를 사용할 수 있습니다.

마지막으로 CommandProperties 값을 사용하여 리본 컨트롤에서 이벤트에 대한 정보를 전달할 수 있습니다. 이를 사용하여 상황별 정보를 이벤트 컨텍스트에 따라 특정 동작이 결정될 수 있는 중앙 함수에 보낼 수 있습니다.

참고 항목

명령 및 리본 사용자 지정
리본을 사용하여 URL에 매개 변수 전달
<CrmParameter> (RibbonDiffXml)
<JavaScriptFunction> (RibbonDiffXml)
<Url> (RibbonDiffXml)
리본 동작 정의
사용자 지정 작업을 정의하여 리본 수정

Microsoft Dynamics 365

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