전역 관리자(호스팅된 컨트롤)

 

게시 날짜: 2016년 11월

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

전역 관리자 호스팅된 컨트롤 유형은 Unified Service Desk의 핵심이며 호스팅된 컨트롤의 인스턴스는 Unified Service Desk에 필요합니다. 이 호스팅된 컨트롤은 응용 프로그램을 시작할 때 Microsoft Dynamics 365에서 모든 Unified Service Desk 구성 데이터를 로드하고 읽으며 창 탐색 규칙을 해석하고 도구 모음 구성 요소와 에이전트 스크립트에 데이터를 제공하고 세션에 대한 데이터를 관리합니다.전역 관리자 호스팅된 컨트롤 유형의 단일 관리자만 로드할 수 있습니다.

중요

Unified Service Desk, New Environment, CRM Web Client 및 Interactive Service Hub에 대한 세 가지 샘플 응용 프로그램 패키지는 각각의 전역 관리자 호스팅된 컨트롤 유형의 인스턴스로 미리 구성되어 있습니다. 샘플 응용 프로그램에 대한 자세한 내용은 TechNet: Package Deployer를 사용하여 샘플 Unified Service Desk 응용 프로그램을 CRM 서버에 배포를 참조하십시오.

Unified Service Desk에 있는 대부분의 기능에 대한 해석을 제공하는 것 외에 전역 관리자 호스팅된 컨트롤 유형은 시스템에서 다국어 기능도 제공하므로 응용 프로그램에서 여러 언어로 UI 문자열과 메시지를 지역화할 수 있습니다. 자세한 내용은 에이전트 응용 프로그램을 위한 다국어 지원 추가을 참조하십시오. 또한 구성을 통해 일반화하고 적용할 수 있도록 디자인된 검색 공급자도 제공합니다.

이 항목의 내용

전역 관리자 호스팅된 컨트롤 만들기

미리 정의된 UII 작업

미리 정의된 이벤트

전역 관리자 호스팅된 컨트롤 만들기

새로운 호스팅된 컨트롤을 만드는 동안 새 호스팅된 컨트롤 화면의 필드는 만들려는 호스팅된 컨트롤의 유형에 따라 다릅니다. 이 섹션에서는 전역 관리자 호스팅된 컨트롤 유형에 고유한 특정 필드에 대한 정보를 제공합니다. 호스팅된 컨트롤을 만드는 방법에 대한 자세한 내용은 호스팅된 컨트롤 만들기 또는 편집를 참조하십시오.

새 호스팅된 컨트롤 화면의 Unified Service Desk 영역에서 USD 구성 요소 유형 드롭다운 목록에서 전역 관리자를 선택합니다. 또한 이 호스팅된 컨트롤의 정렬 순서 값을 2로 설정하여 연결 관리자 호스팅된 컨트롤을 사용하여 Dynamics 365에 대한 연결이 설정된 후 에이전트 응용 프로그램에 의해 즉시 로드되는지 확인합니다. 기타 일반 필드에 대한 자세한 내용은 호스팅된 컨트롤 만들기 또는 편집를 참조하십시오.

레코드를 저장한 후 언어 서비스 영역은 에이전트의 응용 프로그램 UI에 대한 지역화된 문자열을 추가하기 위한 리소스를 추가하는 경우 사용할 수 있게 됩니다. 언어 리소스를 추가하는 방법에 대한 자세한 내용은 에이전트 응용 프로그램을 위한 다국어 지원 추가를 참조하십시오.

미리 정의된 UII 작업

전역 관리자는 웹 서비스를 통해 Dynamics 365 레코드 데이터를 조작할 수 있는 일련의 미리 정의된 동작을 제공합니다. 이러한 동작은 구성하는 동안 Dynamics 365에서 고급 기능을 수행하는 데 사용할 수 있습니다.

다음 미리 정의된 UII 동작은 전역 관리자 호스팅된 컨트롤 유형에 사용할 수 있습니다.

감사

Unified Service Desk 감사 로그에 감사 항목을 추가합니다. 자세한 내용은 Technet: Unified Service Desk의 감사 구성을 참조하십시오.

매개 변수	설명
이름	감사 항목 이름입니다.1로 설정된 값을 사용하여 옵션 영역(설정 > Unified Service Desk > 옵션(이동하려면 어떻게 해야 합니까?)) 아래에 옵션을 추가해야 합니다.
작업	감사 중인 작업을 나타나는 문자열입니다.
TargetApplication	감사에 대한 대상 응용 프로그램을 나타내는 문자열입니다.
CustomerId	고객 ID를 나타내는 문자열입니다.
ContextId	컨텍스트 ID를 나타내는 문자열입니다.
ApplicationId	감사를 위한 호스팅된 컨트롤의 GUID입니다.
AgentState	에이전트 상태를 나타내는 문자열
ActionData	감사 항목을 기록하는 데이터입니다. 이 매개 변수가 명시적으로 제공되지 않는 경우 작업 호출 정의의 Data 필드에 있는 나머지 줄을 모두 사용합니다.

CallDoAction

다른 호스팅된 컨트롤에서 작업을 호출합니다.

매개 변수	설명
panel	이것은 응용 프로그램이 지정되지 않은 경우 활성 응용 프로그램을 찾는 창입니다.
작업	이것은 호스팅된 컨트롤을 호출하는 작업입니다.
데이터	이것은 작업에 전달할 데이터 매개 변수입니다.
응용 프로그램	이것은 작업 호출을 실행하려는 호스팅된 컨트롤 이름입니다. 지정된 경우 panel 매개 변수는 무시됩니다.

ClearAppBar

클라이언트 응용 프로그램에서 지정된 호스팅된 컨트롤을 해제합니다.

매개 변수	설명
ApplicationName	해제할 호스팅된 컨트롤의 이름입니다. 이 매개 변수가 제공되지 않는 경우 클라이언트 응용 프로그램 주 창이 해제됩니다.

ClearEntityList

누적된 검색 결과 목록을 지우고 항상 DoSearch 작업을 호출하기 전에 호출해야 합니다.

매개 변수	설명
global	지우려는 전역 세션에 검색 결과를 연결하려는 경우 True입니다. 시스템에 의해 자동으로 지워지지 않으므로 전역 세션에서 검색 결과를 저장하는 동안 주의해야 합니다. 이 경우 DoSearch 작업을 호출하기 전에 ClearEntityList 작업을 호출해야 합니다.

닫기

호스팅된 컨트롤을 닫습니다.CloseActive 작업과 달리 이 탭이 둘 이상의 페이지를 표시하는 경우 에이전트 응용 프로그램에 있는 탭에 표시되는 모든 페이지를 닫습니다.

CloseActive

지정된 창에서 현재 호스팅된 컨트롤을 닫습니다.

매개 변수	설명
	작업 호출에서 첫 번째 줄은 활성 응용 프로그램을 찾기 위한 창의 이름을 포함해야 합니다. 매개 변수를 지정하지 않은 경우 MainPanel로 가정합니다.

CopyToClipboard

문서 URL을 클립보드에 복사 또는 추가합니다.

매개 변수	설명
데이터	복사하려는 데이터입니다. 대체 매개 변수를 사용할 수도 있습니다.data=[[$context.title]]을 예로 들 수 있습니다.
추가	클립보드에 데이터를 추가할지 여부를 나타냅니다.true 또는 false를 설정합니다. 예: append=false.

CopyToContext

컨텍스트 변수에 한 값 또는 일련의 값을 복사합니다. 컨텍스트 변수를 세션과 serialize할 수 있습니다. 이 작업은 이름=값 쌍을 사용합니다. 이름은 컨텍스트 변수의 이름입니다.

CopyLogicalEntityToContext

데이터 매개 변수의 전체 섹션의 값을 컨텍스트에 복사합니다.

매개 변수	설명
LogicalName	값을 복사해올 데이터 매개 변수의 유형 또는 섹션입니다.

CloseActivity

Dynamics 365에서 활동 레코드를 닫습니다.

매개 변수	설명
Id	닫으려는 활동 레코드의 GUID입니다.
LogicalName	닫으려는 활동의 논리적 이름입니다.
StatusCode	활동 종료 후 최종 상태 코드의 표시 이름입니다.
StateCode	활동 종료 후 최종 상태 코드의 표시 이름입니다.

예를 들어, 전화 통화 활동을 닫으려면 다음을 지정 해야 합니다.

Id=<GUID of the phone activity record>
LogicalName=phonecall
statuscode=Received
statecode=Completed

활동 레코드를 닫은 후 $Return 시스템 대체 매개 변수는 작업이 성공했는지 여부를 나타내는 부울 값으로 채워집니다.

CreateEntity

Dynamics 365에서 새 레코드를 만듭니다.

매개 변수	설명
LogicalName	만들려는 엔터티의 논리적 이름입니다.

매개 변수 목록에서 다음 각 줄은 만들기 위해 입력할 다른 필드를 정의할 일련의 이름=값 쌍을 포함합니다.

엔터티 참조는 다음과 같이 설명할 수 있습니다.

Param=EntityReference(“logicalname”, “id”)

OptionSetValue는 다음과 같이 지정할 수 있습니다.

Param=OptionSetValue(value)

부울은 다음과 같이 설명할 수 있습니다.

Param=Boolean(value)

PartyList(전자 메일에 사용)는 다음과 같이 설명할 수 있습니다.

Param=PartyList(email[“test@test.com”], er[“contact”, guid])

각각 전자 메일 주소와 엔터티 참조를 나타내기 위해 많은 email 및 er를 사용할 수 있습니다.

문자열 값과 같은 다른 값을 다음과 같이 지정할 수 있습니다.

Param=value

레코드를 만든 후에 $Return 값은 새로 만든 레코드의 GUID로 채워집니다.

CreateSession

세션을 만듭니다.

DeleteEntity

Dynamics 365에서 레코드를 삭제합니다.

매개 변수	설명
Id	삭제할 값의 ID입니다. 이 레코드는 삭제할 레코드의 GUID여야 합니다.
LogicalName	삭제하려는 엔터티의 논리적 이름입니다.

DoRoute

특정 호스팅된 컨트롤의 팝업 창을 시뮬레이션하여 창 탐색 규칙을 테스트하는 데 사용할 수 있습니다. 요구 사항에 따라 창 탐색을 수동으로 트리거하기 위해 프로덕션에서 사용할 수 있습니다.

매개 변수	설명
이름	queueItem의 대상인 엔터티의 ID입니다.
엔터티	팝업 창에 열려 있는 엔터티의 논리적 이름입니다.
id	팝업 창에 열릴 엔터티의 ID입니다.
frame	팝업이 발생하는 프레임입니다.

DoSearch

Unified Service Desk에서 엔터티 검색으로 정의된 FetchXML을 사용하여 Dynamics 365 웹 서비스를 호출합니다. 엔터티 검색 정의에 대한 자세한 내용은 Unified Service Desk에서 엔터티 검색을 사용하여 데이터 검색를 참조하십시오.

매개 변수	설명
name	레코드를 검색하는 데 사용할 엔터티 검색의 이름입니다.
global	지우려는 전역 세션에 검색 결과를 연결하려는 경우 True입니다. 시스템에 의해 자동으로 지워지지 않으므로 전역 세션에서 검색 결과를 저장하는 동안 주의해야 합니다. 이 경우 이 작업을 호출하기 전에 ClearEntityList 작업을 호출해야 합니다.
maxcount	이 호출에서 EntityList 결과에 저장할 레코드의 최대 수입니다.

참고

결과 집합에 대해 페이지 수(페이지당 레코드 수)는 기본적으로 50으로 설정됩니다. 이는 50개 이상의 레코드가 반환되지 않을 페이지에 표시됩니다.DoSearch 작업에 대해 다른 페이지 수 값을 지정하려면 EntitySearchPageCount 옵션에서 새 값을 지정합니다.추가 정보:TechNet: Unified Service Desk에 대한 옵션 관리

DoSearch 작업을 호출하면 $Return 교체 매개 변수는 이 검색의 결과로 EntityList에서 발견되고 저장된 레코드 수를 표시합니다.추가 정보:$Return.

DisplayMessage

사용자에게 메시지 상자를 표시합니다.

매개 변수	설명
텍스트	이것은 메시지 상자에 표시되는 텍스트입니다. 이 매개 변수를 지정하지 않으면 나머지 텍스트(나머지 매개 변수) 또는 빈 문자열이 사용됩니다.
캡션	이것은 메시지 상자에 표시되는 캡션입니다. 캡션이 지정되지 않은 경우 Dynamics 365 메시지가 사용됩니다.

ExecuteOnDataAvailable

지정된 대체 매개 변수 집합을 사용할 수 있게 될 때까지 하위 작업의 실행을 지연합니다. 대체 매개 변수를 사용할 수 있을 때까지 기다리는 시간을 제한하기 위해 제한 시간 값을 지정할 수 있습니다. 제한 시간 없음을 지정하는 경우 무한정 기다리거나 세션이 종료 될 때까지 대기합니다.추가 정보:블로그: 특수 작업 ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue를 사용하는 방법

매개 변수	설명
밀리초	이 작업이 만료되고 취소되기 전에 대기하는 시간을 나타내는 시간(밀리초)입니다. 나머지 매개 변수는 하위 작업을 실행할 수 있기 전에 존재해야 하는 대체 매개 변수를 포함해야 합니다. 데이터 매개 변수 예: milliseconds=5000 [[account.Id]] [[incident.Id]]

중요

이 작업은 모든 호스팅된 컨트롤 유형에 적용됩니다. 기본적으로 이 작업은 호스팅된 컨트롤 유형의 인스턴스를 만들 때 노출되지 않습니다. 호스팅된 컨트롤 유형의 인스턴스가 있는 ExecuteOnDataAvailable 작업을 사용하려면 ExecuteOnDataAvailable이라는 UII 작업을 해당 호스팅된 컨트롤 인스턴스에 명시적으로 추가해야 합니다.추가 정보:호스팅된 컨트롤에 UII 동작 추가

ExecuteOnTimeout

지정된 시간이 경과될 때까지 하위 작업의 실행을 지연합니다. 하위 동작을 실행해야 하는 때를 나타내려면 제한 시간 값이 필요합니다.추가 정보:블로그: 특수 작업 ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue를 사용하는 방법

매개 변수	설명
밀리초	하위 작업이 실행되기 전에 대기하는 시간을 나타내는 시간(밀리초)입니다. 데이터 매개 변수 예: milliseconds=5000

중요

이 작업은 모든 호스팅된 컨트롤 유형에 적용됩니다. 기본적으로 이 작업은 호스팅된 컨트롤 유형의 인스턴스를 만들 때 노출되지 않습니다. 호스팅된 컨트롤 유형의 인스턴스가 있는 ExecuteOnTimeout 작업을 사용하려면 ExecuteOnTimeout이라는 UII 작업을 해당 호스팅된 컨트롤 인스턴스에 명시적으로 추가해야 합니다.추가 정보:호스팅된 컨트롤에 UII 동작 추가

ExecuteOnExpressionTrue

지정된 JavaScript 식이 true를 반환할 때까지 하위 작업의 실행을 지연합니다. 만료되기 전에 대기하는 시간을 제한하기 위해 제한 시간 값을 지정할 수 있습니다. 제한 시간 없음을 지정하는 경우 무한정 기다리거나 세션이 종료 될 때까지 대기합니다.추가 정보:블로그: 특수 작업 ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue를 사용하는 방법

매개 변수	설명
밀리초	이 작업이 만료되고 취소되기 전에 대기하는 시간을 나타내는 시간(밀리초)입니다. 나머지 매개 변수는 평가할 JavaScript 식입니다. 이 식이 true이면 하위 작업이 실행됩니다. 데이터 매개 변수 예: milliseconds=5000 function IsAccountLoaded() { return “[[account.Id]$+]” != “”; } IsAccountLoaded();

중요

이 작업은 모든 호스팅된 컨트롤 유형에 적용됩니다. 기본적으로 이 작업은 호스팅된 컨트롤 유형의 인스턴스를 만들 때 노출되지 않습니다. 호스팅된 컨트롤 유형의 인스턴스가 있는 ExecuteOnExpressionTrue 작업을 사용하려면 ExecuteOnExpressionTrue이라는 UII 작업을 해당 호스팅된 컨트롤 인스턴스에 명시적으로 추가해야 합니다.추가 정보:호스팅된 컨트롤에 UII 동작 추가

ExecuteScriptlet

지정한 스크립트릿을 실행합니다.

매개 변수	설명
	데이터 필드에 실행할 스크립틀릿의 이름을 지정합니다.

FireEvent

이 호스팅된 컨트롤에서 사용자 정의 이벤트를 발생시킵니다.

매개 변수	설명
이름	사용자 정의 이벤트의 이름입니다.

이후의 모든 이름=값 쌍은 이벤트의 매개 변수가 됩니다. 사용자 정의 이벤트를 만드는 방법에 대한 자세한 내용은 사용자 정의 이벤트 만들기를 참조하십시오.

GetTemplate

병합된 전자 메일 템플릿의 콘텐츠를 검색합니다.

매개 변수	설명
이름	검색할 템플릿의 이름입니다.
id	병합 작업을 위해 이 템플릿과 연결할 엔터티의 ID입니다.

InvokeCTI

CTI 이벤트 시뮬레이션

매개 변수	설명
유형	전화 통화, 채팅 등 CTI 이벤트 종류입니다.
appname	이 팝업 시뮬레이션에 사용할 데스크톱 관리자 이름
ani	자동 번호 식별(ANI) 또는 호출자의 전화 번호입니다.
dnis	DNIS 또는 전화를 건 번호입니다.
	모든 나머지 매개 변수는 CTI 이벤트 프로세스에 매개 변수로 전달됩니다.

LaunchURL

Unified Service Desk 응용 프로그램이 아닌 Internet Explorer에서 URL을 엽니다.데이터에 URL을 매개 변수로 지정해야 합니다.

LookupQueueItem

시스템에서 queueitem를 조회하여 정보를 얻습니다.

매개 변수	설명
Id	queueItem의 대상인 엔터티의 ID입니다.
EntityType	ID 필드에서 참조되는 엔터티의 형식 또는 논리적 이름입니다.

결과의 queueitem 세부 정보는 queueitem 대체 매개 변수에 저장되고 나중에 참조할 수 있습니다.

MoveApplicationToPanel

클라이언트 응용 프로그램에서 지정된 창으로 호스팅된 컨트롤을 이동합니다.

매개 변수	설명
앱	이동할 호스팅된 컨트롤의 이름입니다.
창	대상 창의 이름입니다.

MoveToPanel

런타임에 창 간에 호스팅된 컨트롤을 이동합니다.

매개 변수	설명
앱	이동될 호스팅된 컨트롤의 이름입니다.
창	호스팅된 컨트롤의 대상 창입니다.

New_CRM_Page

지정된 엔터티의 새 Dynamics 365 레코드를 만들기 위한 페이지를 만들고 페이지를 지정된 호스팅된 컨트롤의 팝업으로 처리합니다. 엔터티 레코드를 만들기 위한 페이지가 표시되는 위치를 결정하기 위해 창 탐색 규칙이 평가됩니다.

매개 변수	설명
LogicalName	새 인스턴스를 만들기 위한 엔터티의 논리적 이름입니다.

참고

나머지 매개 변수는 이름=값 쌍으로 구성 되어야 합니다. 이러한 값은 지정된 엔터티에 대한 새 레코드를 만들기 위해 양식에 미리 입력된 추가 값입니다. 이 동작 사용에 대한 자세한 내용은 연습 7: 에이전트 응용 프로그램에서 에이전트 스크립팅 구성의 4단계를 참조하십시오.

Open_CRM_Page

ID로 지정되고 식별된 엔터티의 기존 인스턴스를 열고 페이지를 지정된 호스팅된 컨트롤의 팝업으로 처리합니다. 팝업을 표시할 위치를 결정하기 위해 창 탐색 규칙이 평가됩니다.

매개 변수	설명
LogicalName	열려는 엔터티의 논리적 이름입니다.
ID	열려는 엔터티 레코드의 ID입니다.

일시 중지

메시지 처리를 차단하지 않고 작업의 실행을 중지합니다. 이 작업은 지정된 시간 동안 현재 스레드를 일시 중단하는 것과는 다릅니다(Thread.Sleep). 그 이유는 작업은 계속 처리되기 때문입니다. 이 작업은 웹 작업이 끝나기를 기다리는 경우에 유용합니다.

매개 변수	설명
밀리초	일시 중지할 시간(밀리초)입니다.

팝업

호스팅된 컨트롤의 URL을 팝업하고 팝업을 적절한 위치로 라우팅하기 위해 창 탐색 규칙을 실행합니다.

매개 변수	설명
url	표시된 컨트롤에서 요청한 팝업인 것처럼 이 URL을 사용하여 이 호스팅된 컨트롤에서 팝업을 라우팅합니다.
frame	이 팝업이 시작되는 프레임입니다.

RealignWindow

모니터의 지정된 위치에 호스팅된 컨트롤을 표시합니다. 최대 두 개의 모니터에 호스팅된 컨트롤을 표시할 수 있습니다. 이 작업은 USDFloatingPanel 또는 USDFloatingToolPanel 패널 유형에 배치되도록 구성된 호스팅된 컨트롤 인스턴스에 적용됩니다.

매개 변수	설명
screen	호스팅된 컨트롤을 표시할 화면을 지정합니다. 유효한 값은 1 또는 2입니다. 이 매개 변수를 지정하지 않으면 1이 기본값으로 전달됩니다.
left	호스팅된 컨트롤이 표시되는 대상 모니터 화면의 왼쪽에서 위치(백분율)를 지정합니다. 유효한 값은 0~100입니다. 이 매개 변수를 지정하지 않으면 0이 기본값으로 전달됩니다.
top	호스팅된 컨트롤이 표시되는 대상 모니터 화면의 위쪽에서 위치(백분율)를 지정합니다. 유효한 값은 0~100입니다. 이 매개 변수를 지정하지 않으면 0이 기본값으로 전달됩니다.
width	대상 모니터에서 호스팅된 컨트롤 창의 너비(백분율)를 지정합니다. 유효한 값은 1~100입니다. 이 매개 변수를 지정하지 않으면 100이 기본값으로 전달됩니다.
height	대상 모니터에서 호스팅된 컨트롤 창의 높이(백분율)를 지정합니다. 유효한 값은 1~100입니다. 이 매개 변수를 지정하지 않으면 100이 기본값으로 전달됩니다.

ReadSettings

$Settings 대체 매개 변수에서 이전에 저장된 설정을 읽습니다.

매개 변수	설명
readfromcache	이러한 설정의 로컬에 캐싱된 버전을 읽으려는 경우 True입니다. 그렇지 않으면 False 또는 누락입니다.

RedoScreenPop

마지막 화면을 다시 팝업합니다. 이는 세션 한도에 도달하여 팝에 성공하지 못한 경우 또는 세션을 닫았지만 더 많은 작업이 필요한 경우 유용할 수 있습니다. 이 작업에는 매개 변수가 필요하지 않습니다.

ResetLocalCache

Unified Service Desk에서 구성 캐시를 다시 설정합니다. 다음에 Unified Service Desk를 시작하면 서버에서 구성을 다운로드합니다. 이 작업을 수행하려면 사용자는 msdyusd_usersettings 엔터티에 대한 쓰기 권한이 있어야 합니다.

RouteToQueue

Dynamics 365에 있는 큐로 엔터티가 라우팅됩니다.

매개 변수	설명
대상	대상 큐의 ID입니다. 이것은 destinationqueuename 매개 변수와 함께 사용할 수 없습니다.
destinationqueuename	이것은 엔터티를 라우팅할 큐의 이름입니다.
entitytype	이것은 라우팅할 엔터티의 논리적 이름입니다.
entityid	이것은 큐에 저장할 엔터티의 GUID/ID입니다.

SaveAll

여러 페이지를 표시할 수 있는 호스팅된 컨트롤에 모든 양식을 저장합니다(여러 페이지 허용 = 예). 호스팅된 컨트롤이 단일 페이지만 표시할 수 있는 경우(여러 페이지 허용 = 아니요), 저장 작업과 동일합니다.

SaveSetting

특정 사용자 설정을 저장합니다.

매개 변수	설명
이름	설정 이름입니다. 이 이름은 대체 매개 변수의 $Settings에 표시됩니다.
값	저장할 설정의 값입니다.

SetTheme

레이아웃과 사용자 인터페이스 구성 요소의 모양과 느낌을 수정하기 위해 테마를 적용합니다.추가 정보:응용 프로그램의 모양 사용자 지정

매개 변수	설명
지우기	지정된 테마를 적용하기 전에 현재 테마를 완전히 지우려는 경우 True입니다. 이 매개 변수가 false이거나 지정되지 않은 경우 새로운 테마 정보는 현재 테마와 병합됩니다.
	나머지 매개 변수(다른 매개 변수를 제거한 후 남아 있는 매개 변수)는 사용할 테마 이름을 포함합니다. 이는 XAML 파일(XML로 이름이 바뀌고 웹 리소스로 업로드됨) 웹 리소스 이름, 익명 액세스 서버의 URL 또는 테마를 나타내는 원시 XAML이어야 합니다.

SetAppBar

클라이언트 응용 프로그램 주 창의 지정된 가장자리로 호스팅된 컨트롤을 도킹합니다.

매개 변수	설명
ApplicationName	도킹할 호스팅된 컨트롤의 이름입니다. 이 매개 변수를 지정하는 경우 이 호스팅된 컨트롤을 호스팅하는 부모 창이 도킹됩니다.
너비	도킹된 창의 너비(픽셀)입니다. 지정하지 않을 경우 창의 현재 너비가 사용됩니다.
높이	도킹된 창의 높이(픽셀)입니다. 지정하지 않을 경우 창의 현재 높이가 사용됩니다.
가장자리	도킹할 가장자리입니다. 아무것도 지정하지 않을 경우 위쪽을 가정합니다.위쪽, 아래쪽, 왼쪽 또는 오른쪽 중 하나를 지정합니다.

SetEventTimer

시작할 이벤트 타이머를 설정합니다.

매개 변수	설명
이름	이벤트 타이머의 이름입니다.

SetSize

호스팅된 컨트롤의 높이와 너비를 설정합니다. 이는 창 레이아웃에서 "auto"를 사용할 때 특히 유용합니다.

매개 변수	설명
너비	호스팅된 컨트롤의 너비입니다.
높이	호스팅된 컨트롤의 높이입니다.

SetWindowProperty

클라이언트 응용 프로그램의 주 창에 대한 창 상태를 설정합니다.

매개 변수	설명
WindowState	값은 최대화, 최소화 또는 보통 중 하나입니다.

ShellExecute

이 작업은 URL 또는 명령줄을 시작하는 데 사용됩니다. 참고: 사용자는 응용 프로그램을 실행할 권한이 있어야 합니다.

매개 변수	설명
	유일한 매개 변수는 실행할 응용 프로그램의 명령줄이나 URL입니다.

ShowAbout

현재 사용자의 이름, 사용자가 연결된 Dynamics 365 서버와 조직 , Unified Service Desk 클라이언트 응용 프로그램의 버전 번호 및 지원 사이트 URL 같은 정보를 포함하고 있는 Unified Service Desk용 대화 상자에 대한 정보를 표시합니다.

ShowTab

에이전트 응용 프로그램에서 탭(호스팅된 컨트롤)에 포커스를 설정합니다.

매개 변수	설명
	작업 호출에서 첫 번째 줄은 전경에 표시할 호스팅된 컨트롤의 이름을 포함해야 합니다. 호스팅된 컨트롤의 표시 이름은 사용하지 마십시오. 이 작업 호출 사용에 대한 자세한 내용은 연습 2: 에이전트 응용 프로그램에 외부 웹 페이지 표시의 4단계를 참조하십시오.

StopEventTimer

이벤트 타이머를 중지합니다.

매개 변수	설명
이름	중지할 이벤트 타이머의 이름입니다.

Translate

Microsoft Translator를 사용하여 언어 번역을 수행할 수 있습니다.

매개 변수	설명
값	다음 번역할 내용입니다. 이 값은 여러 줄 지원에 대해 사용되지 않을 수 있습니다. 몇 가지 유효한 예: value=$Escaped("my string<br>new line\\\"my text\\\"") value=[[myapp.myparam]^] value=$Escaped([[myapp.myparam]$]) 대체 키에 대한 자세한 내용은 교체 매개 변수를 사용하여 Unified Service Desk 구성을 참조하십시오.
fromlanguage	번역할 소스 언어의 이름입니다. 비어 있는 경우 시스템은 번역하기 전에 번역될 특정 값의 언어를 감지하려고 시도합니다. 유효한 언어 값 목록은 번역기 언어 코드를 참조하십시오.
tolanguage	번역할 대상 언어의 이름입니다. 유효한 언어 값 목록은 번역기 언어 코드를 참조하십시오.
clientId	번역 서비스를 위해 Microsoft Azure에서 가져온 클라이언트 ID입니다.Azure 등록에 대한 자세한 내용은 https://datamarket.azure.com을 참조하십시오.
clientsecret	번역 서비스를 위해 Microsoft Azure에서 가져온 클라이언트 비밀입니다.Azure 등록에 대한 자세한 내용은 https://datamarket.azure.com을 참조하십시오.

번역된 값은 $Return 대체 매개 변수 아래 표시됩니다.

UpdateEntity

Dynamics 365에서 레코드를 업데이트합니다.

매개 변수	설명
Id	업데이트할 값의 ID입니다. 이 레코드는 업데이트할 레코드의 GUID여야 합니다.
LogicalName	업데이트하려는 엔터티의 논리적 이름입니다.

매개 변수 목록에서 다음 각 줄은 어데이트하기 위해 입력할 다른 필드를 정의할 일련의 이름=값 쌍을 포함합니다.

엔터티 참조는 다음과 같이 설명할 수 있습니다.

Param=EntityReference(“logicalname”, “id”)

OptionSetValue는 다음과 같이 지정할 수 있습니다.

Param=OptionSetValue(value)

부울은 다음과 같이 설명할 수 있습니다.

Param=Boolean(value)

PartyList(전자 메일에 사용)는 다음과 같이 설명할 수 있습니다.

Param=PartyList(email[“test@test.com”], er[“contact”, guid])

각각 전자 메일 주소와 엔터티 참조를 나타내기 위해 많은 전자 메일과 엔터티를 사용할 수 있습니다.

문자열 값과 같은 다른 값을 다음과 같이 지정할 수 있습니다.

Param=value

작업

이 작업은 큐에서 큐 항목을 선택하고 리본에서 WorkOn 단추를 클릭하는 것과 같습니다. 특정 에이전트에 의해 작동되는 큐 항목을 표시합니다.

매개 변수	설명
Id	queueitem의 ID입니다. 대상 엔터티에 대한 ID를 가져오는 방법에 대한 자세한 내용은 LookupQueueItem을 참조하십시오.
작업	WorkOn 속성을 제거하여 큐로 반환하려는 것임을 관리자가 지정할 수 있는 옵션 매개 변수입니다. 유효한 값: 제거 – WorkOn 속성을 제거하고 다른 사용자가 작업할 큐로 항목을 반환합니다.

미리 정의된 이벤트

이 호스팅된 컨트롤 유형과 관련된 미리 정의된 이벤트는 다음과 같습니다.

DesktopReady

시작 시 모든 바탕 화면 초기화가 완료되었고 Dynamics 365에 연결되었을 때 발생합니다. 이 이벤트는 한 번만 발생하며 이 이벤트를 사용하여 테마를 설정하고 다른 시작 작업을 수행하는 것이 일반적입니다.

SessionActivated

세션이 활성화 될 때마다 발생합니다.

매개 변수	설명
SessionId	현재 활성 세션의 ID입니다.
IsGlobal	이 이벤트기 전역 세션에 적용되는지 여부를 나타냅니다. True 또는 False를 반환합니다.
활성화	True로 설정됩니다.

SessionClosed

세션을 닫을 때 발생합니다.

매개 변수	설명
SessionId	닫힌 세션의 ID입니다.
IsGlobal	이 이벤트기 전역 세션에 적용되는지 여부를 나타냅니다. True 또는 False를 반환합니다.

SessionDeactivated

세션이 비활성화될 때 발생합니다.

매개 변수	설명
SessionId	비활성 세션의 ID입니다.
IsGlobal	이 이벤트기 전역 세션에 적용되는지 여부를 나타냅니다. True 또는 False를 반환합니다.
활성화	False로 설정됩니다.

SessionNew

새 세션이 만들어질 때 발생합니다.

매개 변수	설명
SessionId	새로 만들어진 세션의 ID입니다.
IsGlobal	새 세션이 전역 세션인 경우 True를 반환합니다. 그렇지 않은 경우 False를 반환합니다.

참고 항목

UII 작업
이벤트
미리 정의된 작업 및 호스팅된 컨트롤에 대한 이벤트 보기
작업 및 이벤트용으로 포함된 도움말 보기
Unified Service Desk 구성 연습
호스팅된 컨트롤 유형 및 동작/이벤트 참조
TechNet: Microsoft Dynamics CRM용 Unified Service Desk 관리 가이드

Unified Service Desk 2.0

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