다음을 통해 공유

리본 활성화 규칙 정의

  • 아티클

 

게시 날짜: 2017년 1월

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

리본 요소를 구성할 때 리본 요소를 활성화하는 시기를 제어하는 특정 규칙을 정의할 수 있습니다.<EnableRule> (RibbonDiffXml) 요소는 다음과 같이 사용됩니다.

  • /RuleDefinitions/EnableRules/EnableRule 요소를 사용하여 리본 요소를 활성화해야 하는 시기를 제어하는 규칙을 정의합니다.

  • /CommandDefinitions/CommandDefinition/EnableRules/EnableRule 요소를 사용하여 특정 활성 규칙을 명령 정의에 연결합니다.

활성화란 무엇입니까?

명령 모음을 사용하면 비활성화된 명령이 숨겨져 있습니다. 리본을 사용하면 비활성화된 명령이 표시되지만 이벤트에 응답하지 않습니다.

리본 요소가 활성화되는 시기 제어

규칙을 활성화하는 것은 재사용하기 위해서입니다. 규칙 정의로 활성화 규칙을 정의하면 여러 명령 정의에 대해 동일한 활성화 규칙을 사용할 수 있습니다. 명령 정의에 대해 활성화 규칙을 여러 개 정의하면 활성화되는 리본 요소에 대해 활성화 규칙이 모두 true로 평가됩니다.

모든 활성화 규칙은 규칙의 기본 값이 true 또는 false인지 지정하는 선택적 특성과 테스트할 항목이 true를 반환할 때 부정적 결과를 반환할 수 있는 선택적 InvertResult 특성을 제공합니다.

/RuleDefinitions/EnableRules/EnableRule 요소는 다음 유형의 규칙을 지원합니다.

  • <CommandClientTypeRule> (RibbonDiffXml)
    사용되는 프레젠테이션의 유형을 검색하는 규칙을 지정합니다.

    Type 값은 다음과 일치합니다.

    값

    프레젠테이션

    Modern

    태블릿용 Microsoft Dynamics 365을 사용하여 명령 모음이 표시됩니다.

    Refresh

    업데이트된 사용자 인터페이스를 사용하여 명령 모음이 표시됩니다.

    Legacy

    리본은 업데이트되지 않은 엔터티의 양식 또는 Outlook용 Microsoft Dynamics 365의 목록 보기에 표시됩니다.

  • <CrmClientTypeRule> (RibbonDiffXml)
    사용된 클라이언트 유형에 따라 규칙을 정의할 수 있습니다. 유형 옵션은 다음과 같습니다.

    • Web

    • Outlook

  • <CrmOfflineAccessStateRule> (RibbonDiffXml)
    이 조건을 사용하여 Microsoft Office Outlook용 Microsoft Dynamics 365(오프라인 액세스 가능)가 현재 오프라인인지에 따라 리본 요소를 활성화합니다.

  • <CrmOutlookClientTypeRule> (RibbonDiffXml)
    Outlook용 Microsoft Dynamics 365의 특정 유형에 대한 단추만 표시하려면 이 규칙을 사용합니다. 유형 옵션은 다음과 같습니다.

    • CrmForOutlook

    • CrmForOutlookOfflineAccess

  • <CustomRule> (RibbonDiffXml)
    이 종류의 규칙을 사용하여 부울 값을 반환하는 JavaScript 라이브러리의 함수를 호출합니다.

    참고

    값을 신속하게 반환하지 않는 사용자 지정 규칙은 리본 성능에 영향을 줄 수 있습니다. 완료하는 데 시간이 소요될 수 있는 논리를 수행할 경우 다음 전략을 사용하여 사용자 지정 규칙을 비동기로 만듭니다.

    1. 사용자 지정 개체를 확인하는 규칙을 정의 합니다. 창에 첨부하는 Window.ContosoCustomObject.RuleIsTrue와 같은 개체를 확인할 수 있습니다.

    2. 개체가 있으면 반환됩니다.

    3. 해당 개체가 없으면 개체를 정의하고 값을 false로 설정합니다.

    4. 값을 반환하기 전에 settimeout을 사용하여 비동기 콜백 함수를 실행하여 개체를 다시 설정합니다. 그러면 false를 반환합니다.

    5. 콜백 함수에서 올바를 결과를 확인하기 위해 필요한 작업을 수행한 후 콜백 함수는 개체의 값을 설정하고 refreshRibbon 메서드를 사용하여 리본을 새로 고칩니다.

    6. 리본을 새로 고칠 때 정확한 값 집합과 함께 개체를 검색하고 규칙을 평가합니다.

  • <EntityRule> (RibbonDiffXml)
    엔터티 규칙을 사용하면 현재 엔터티를 평가할 수 있습니다. 따라서 특정 엔터티 대신 엔터티 템플릿에 적용할 사용자 지정 작업을 정의하는 경우 유용합니다. 예를 들어 몇 가지 특정 엔터티를 제외하고 모든 엔터티에 리본 요소를 추가하려고 합니다. 모든 엔터티에 적용되는 엔터티 템플릿에 대해 사용자 지정 작업을 정의한 후 엔터티 규칙을 사용하여 제외되어야 하는 항목을 필터링하면 간단합니다.

    엔터티 규칙에는 엔터티를 양식으로 표시할지 아니면 목록으로 표시할지를 지정하는 선택적 컨텍스트 특성(HomePageGrid)도 포함됩니다. 선택적 AppliesTo 특성은 엔터티를 하위 표에 표시할지 여부를 구분하기 위해 PrimaryEntity 또는 SelectedEntity로 설정할 수 있습니다.

  • <FormStateRule> (RibbonDiffXml)
    FormState 규칙을 사용하여 레코드를 표시하는 양식의 현재 유형을 확인합니다. 상태 옵션은 다음과 같습니다.

    • Create

    • Existing

    • ReadOnly

    • Disabled

    • BulkEdit

  • <OrRule> (RibbonDiffXml)
    OrRule을 사용하면 여러 활성화 규칙 유형에 대해 기본 AND 비교를 다시 정의할 수 있습니다.OrRule 요소를 사용하여 확인할 몇 가지 가능한 유효한 조합을 정의합니다.

  • <OutlookItemTrackingRule> (RibbonDiffXml)
    이 요소에 대해 TrackedInCrm 특성을 사용하여 레코드가 Microsoft Dynamics 365에서 추적되고 있는지 확인합니다.

  • <OutlookVersionRule> (RibbonDiffXml)
    다음과 같이 특정 버전의 Microsoft Office Outlook에서 리본 요소를 활성화하려면 사용합니다.

    • 2003

    • 2007

    • 2010

  • <PageRule> (RibbonDiffXml)
    이 유형의 규칙은 표시되는 페이지의 URL을 확인합니다.Address가 일치하면 true를 반환합니다.

  • <RecordPrivilegeRule> (RibbonDiffXml)
    현재 사용자에게 특정 레코드에 대한 권한이 있는지 여부를 확인하려면 이 규칙을 사용합니다. 이러한 권한은 현재 사용자와 레코드를 공유하여 다른 사용자로부터 얻은 권한을 포함할 수 있으므로 엔터티 권한과 다릅니다.

  • <SelectionCountRule> (RibbonDiffXml)
    목록에 표시되는 리본에 이러한 종류의 규칙을 사용하여 표에서 레코드의 최대 및 최소 수를 선택할 때 단추를 활성화합니다. 예를 들어 단추를 레코드와 병합하면 리본 컨트롤을 활성화하기 전에 두 개 이상의 레코드를 선택해야 합니다.

  • <SkuRule>(RibbonDiffXml)
    이 종류의 규칙을 사용하여 다음과 같이 특정 SKU 버전의 Microsoft Dynamics 365에서 리본 요소를 활성화합니다.

    • OnPremise

    • Online

    • Spla

  • <ValueRule> (RibbonDiffXml)
    이 규칙을 사용하여 양식에 표시되는 레코드의 특정 필드의 값을 확인합니다.Field 및 Value를 지정하여 확인해야 합니다.

참고 항목

명령 및 리본 사용자 지정
리본 명령 정의
리본 표시 규칙 정의

Microsoft Dynamics 365

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