대체 매개 변수

  • 아티클

 

게시 날짜: 2016년 11월

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

대체 매개 변수는 Unified Service Desk 컨텍스트를 증가시키고 포함하는 응용 프로그램의 실행 동안 캡처된 데이터 요소(데이터 매개 변수라 함)에서 데이터를 가져오기 위해 응용 프로그램 전체에서 사용될 수 있습니다. 컨텍스트는 응용 프로그램이 사용되는 동안 다양한 방식으로 데이터가 검색되므로 자주 변경하는 이름/값 문자열 쌍으로 구성됩니다. 대체 매개 변수는 URL 쿼리 문자열을 지정하고 스크립틀릿의 스크립트 출력을 생성하고 엔터티 검색, 컴퓨터 전화 통신 통합(CTI)에 대한 검색 값을 지정하며 다른 호스팅된 컨트롤에서 호출되는 작업에 대한 입력을 지정하는 등 다양한 작업에 사용됩니다. 대체 매개 변수는 코드를 사용할 필요 없이 Unified Service Desk에서 높은 수준의 구성 또는 사용자 지정이 가능한 주요 요소입니다.

대체 매개 변수를 사용하여 에이전트 응용 프로그램을 구성하는 방법에 대한 자세한 내용은 교체 매개 변수를 사용하여 Unified Service Desk 구성를 참조하십시오.

참고

때때로 대체 매개 변수는 기본적으로 데이터 매개 변수를 표현하므로 대체 매개 변수는 데이터 매개 변수와 교체하여 사용됩니다.

이 항목의 내용

Unified Service Desk에서 대체 매개 변수 보기

시스템 대체 매개 변수

Unified Service Desk에서 대체 매개 변수 보기

클라이언트 응용 프로그램의 디버거 컨트롤을 사용하여 언제든지 사용 가능한 대체 매개 변수 목록을 볼 수 있습니다.

  1. Unified Service Desk 클라이언트를 시작하고 샘플 패키지를 설치한 Microsoft Dynamics 365로 로그인합니다.

  2. Unified Service Desk 클라이언트의 기본 화면에서 오른쪽 위 모서리에 있는 기어 옆의 아래쪽 화살표를 클릭하고 디버그를 선택합니다. 디버거가 나타납니다.

    디버거를 여는 디버그 옵션

  3. 디버거에서 데이터 매개 변수를 클릭하여 대체 매개 변수를 봅니다.

    데이터 매개 변수 탭의 대체 매개 변수

트리 보기는 사용 가능한 변수를 나타내는 데 사용됩니다. 변수를 지정할 때 루트 수준의 이름, 마침표(.), 그런 다음 목록의 이름을 지정합니다. 다음 몇 가지 예를 참조하십시오.

  • [[$Session.IsGlobal]]

  • [[$User.fullname]]

이러한 값은 사용자 Unified Service Desk 클라이언트에서 상호 작용할 때 변경됩니다. 작업 호출은 현재 값을 선택하고 매개 변수 목록 또는 사용될 수 있는 곳에 사용됩니다.Unified Service Desk 컨텍스트 자체가 변경되지 않은 경우에도 변수가 업데이트되면 NotifyContextChange 이벤트가 발생합니다. 이렇게 하면 디스플레이를 업데이트해야 하는 경우 대체 매개 변수의 값을 다시 확인하는 세션 라인 같은 기능을 사용할 수 있습니다.

시스템 대체 매개 변수

시스템 대체 매개 변수는 시스템에 정의되고 채워지는 대체 매개 변수이며 사용자 정의 대체 매개 변수와 구분하기 위해 이름은 $로 시작합니다.$Global을 예로 들 수 있습니다.Unified Service Desk에는 다음 대체 매개 변수가 있습니다.

  • $Context

  • $Debug

  • $Global

  • $Panel

  • $Resources

  • $Return

  • $Session

  • $Settings

  • $Subject

  • $SystemParameters

  • $User

$Context

이 섹션에는 UII(User Interface Integration) 세션 컨텍스트의 콘텐츠가 포함되어 있으며 Unified Service Desk응용 프로그램 전체에서 UII 세션 컨텍스트 변수를 사용하는 편리한 방법을 제공합니다.

참고

전역 관리자 호스팅된 컨트롤은 다른 대체 매개 변수의 값을 컨텍스트에 복사할 수 있는 작업을 제공합니다. 이렇게 하면 호출을 전송하거나 나중에 복원 위해 세션을 저장할 때 유용할 수 있습니다. 컨텍스트는 표준 UII 메커니즘을 사용하여 이러한 인스턴스로 서버에 저장할 수 있습니다.

$Debug

이는 디버그 창에서 호출되는지 확인하기 위해 스크립틀릿 내에서만 사용되는 특수 대체 값입니다. 특히 스크립틀릿이 시스템에서 작업을 수행하도록 할 때 이 매개 변수를 테스트하여 디버깅할 때 부작용을 방지하는 코드 블록을 건너뛰어야 하는지 확인합니다. 다음 스크립틀릿은 거래처 호스팅된 컨트롤을 시작하고 디버그 창이 열리면 탭을 표시합니다.

CRMGlobalManager.GetApp(“Account”);

이는 스크립트가 현재 컨텍스트에서 실행되어 시스템의 현재 상태의 값을 확인하기 때문입니다. 이런 부작용이 발생하지 않도록 하려면 다음을 수행하십시오.

If ([[$Debug]]!= true) CRMGlobalManager.GetApp(“Account”);

이렇게 하면 부작용이 방지되고 디버거에 유용한 정보를 제공합니다.

$Global

이 단원은 Dynamics 365 옵션 및 해당 값으로 구성된 모든 옵션을 표시하기 위해 자동으로 추가됩니다. 그러면 실행을 제어하거나 워크플로 또는 작업 호출에서 만든 동작을 제어하는 데 사용할 수 있으므로 옵션에 쉽게 액세스할 수 있습니다. 모든 감사 플래그는이 섹션에 자동으로 표시됩니다.

$Panel

$Panel 대체 매개 변수는 Unified Service Desk 클라이언트를 마지막으로 시작한 이후 다른 패널로 이동된 모든 호스팅된 컨트롤과 해당 현재 패널 이름을 키-값 쌍으로 포함합니다. 대체 매개 변수는 Unified Service Desk 클라이언트를 마지막으로 시작한 후 최소 하나 이상의 호스팅된 컨트롤이 패널을 변경한 경우에만 사용할 수 있게 됩니다. 현재 에이전트 데스크톱에 로드된 다른 모든 호스팅된 컨트롤과 해당 기존 패널은 이 대체 매개 변수에 사용할 수 없습니다.

$Resources

대체 매개 변수의 이 컬렉션은 전역 관리자에 의해 언어 식별자로 채워집니다. 전역 관리자 호스팅된 컨트롤의 구성에서 다양한 언어 리소스를 지정할 수 있습니다. 이러한 리소스는 .resx 파일 형식을 이용하지만 웹 리소스에 XML 파일로 업로드됩니다. 응용 프로그램을 로드하는 즉시 Unified Service Desk는 Dynamics 365에서 현재 언어 설정을 읽은 다음 전역 관리자 언어 목록에서 이 언어를 조회합니다. 항목이 나열된 경우 언어 식별자의 리소스는 이 $Resources 컬렉션에 로드됩니다.

출력에 언어 중립적 텍스트를 제공하려는 경우 대신 이 $Resources 컬렉션의 대체 매개 변수를 사용할 수 있습니다. 예를 들어, 단추 텍스트에 다음을 사용할 수 있습니다.

[[$Resources.MyButtonName]+]

사용자에 대해 선택한 언어에 따라 해당 지역화된 텍스트가 사용됩니다.

또한 이러한 대체 매개 변수에 유의하는 것도 중요하므로 로드되는 .resx 파일은 대체 매개 변수 구문 자체를 포함할 수 있습니다.$Resources 값을 바꾼 후에 추가 대체 매개 변수에 대해 다시 한 번 확인됩니다. 이런 식으로 언어 특정 문자열을 제공하는 경우에도 응용 프로그램의 나머지의 데이터를 이 문자열로 대체할 수 있습니다.

Unified Service Desk를 구성하기 위해 지역화된 리소스를 추가하는 자세한 내용은 에이전트 응용 프로그램을 위한 다국어 지원 추가를 참조하십시오.

$Return

일부 작업은 문자열 값을 반환합니다. 이 문자열 값은 작업 호출의 이름을 사용하여 $Return 대체 매개 변수에 배치됩니다. 다음 패턴을 따릅니다.

[[$Return.ActionCallName]]

한 예는 전역 관리자에서 CreateEntity를 호출하는 것입니다. 그러면 Dynamics 365에 레코드가 만들어지고 새 레코드의 GUID를 반환합니다. 이 새 GUID는 $Return 대체 매개 변수 목록에 있게 되며 다음 작업의 입력으로 사용할 수 있습니다.

$Session

$Session 세션은 세션 개수, 활성 세션이 전역인지 여부, 현재 활성 세션 ID 같은 작업 호출에서 필요한 유용한 변수를 노출합니다.StartTime 값은 활동에 시작 시간을 기록하는 데 사용할 수 있습니다. 이 섹션은 자동으로 채워집니다.

$Settings

이 섹션은 현재 사용자에게만 적용되는 사용자 설정을 제공합니다. 이러한 설정은 시작할 때 자동으로 로드되며 런타임에 작업 호출을 사용하여 읽을 수 있습니다. 여기에는 종종 사용자의 테마 선택을 위한 설정을 포함하지만 구성자가 사용하려는 사용자 특성 설정에 대한 액세스를 제공할 수 있습니다.

이러한 사용자 설정은 Unified Service Desk을 구성하는 동안 Dynamics 365에 있는 사용자 설정 영역(설정 > 사용자 설정)에 정의됩니다.

이러한 설정은 시스템에서 다른 매개 변수처럼 사용할 수 있습니다. 전역 관리자 호스팅된 컨트롤은 사용자에게 쓰기 액세스 권한이 있다는 가정하에 서버에 사용자 설정을 기록하는 작업 SaveSetting을 제공합니다. 테마 선택 및 레이아웃과 같은 사용자 특성 기본 설정을 저장하는 데 사용할 수 있습니다.

참고

사용자 설정은 사용자에게 쓰게 액세스 권한이 있다는 가정하에 Dynamics 365 서버에 저장할 수 있습니다.

$Subject

Unified Service Desk의 유용한 기능은 사용자 대신 만든 새로운 서비스 케이스에 있는 주제 트리를 자동으로 채우는 것입니다. 때때로 제목 필드를 자동으로 채우고 싶지만 사용할 올바른 값을 알고 있어야 하며 이 값은 시스템마다 다를 수 있습니다.

이 항목을 사용하여 다음 대체 매개 변수를 사용하여 서비스 케이스를 만들 때 특정 주제를 참조할 수 있습니다.

[[$Subject.Default Subject.Id]][[$Subject.Default Subject.LogicalName]]

$SystemParameters

이 섹션에는 Windows의 고대비 모드의 활성화 여부(true/false)를 표시하는 HighContrast라는 변수를 포함합니다. 이 변수를 사용하여 클라이언트의 테마를 사용자 지정할 때 기본 사용자 지정 색상 또는 시스템 색상(고대비 설정 준수)을 사용할지 결정할 수 있습니다.추가 정보:Customize themes for High Contrast settings

$User

이 대체 매개 변수 그룹은 Dynamics 365에서 현재 사용자의 레코드 내용으로 자동으로 채워집니다. 예를 들어, 관리자가 에이전트 ID를 포함하도록 Dynamics 365 에서 시스템 사용자 엔터티를 확장하는 경우 이 에이전트 ID가 이 목록에 나타납니다. 이는 특별한 사용자 설정을 구성하는 데 사용할 수 있습니다.

참고 항목

교체 매개 변수를 사용하여 Unified Service Desk 구성
Unified Service Desk에서 스크립틀릿을 사용하여 스크립트 실행
Unified Service Desk에서 엔터티 검색을 사용하여 데이터 검색
Unified Service Desk 사용법 알아보기
전역 관리자(호스팅된 컨트롤)

Unified Service Desk 2.0

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