대화형 서비스 허브 페이지(호스팅된 컨트롤)

 

게시 날짜: 2016년 11월

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

대화형 서비스 허브 페이지 호스팅된 컨트롤 유형을 사용하여 Unified Service Desk 내 대화형 서비스 허브 양식을 호스트하면 두 으용 프로그램의 기능을 통합할 수 있습니다. 대화식 서비스 허브는 직관적인 인터페이스를 제공하고 고객과 관련된 매우 중요한 정보를 모두 한 곳에 표시하므로 고객 지원 상담원은 주의가 필요한 사항에 집중할 수 있습니다.

참고

이 기능은 Unified Service Desk 2.1에 소개되었습니다.

대화형 서비스 허브 양식이 대화형 서비스 허브 페이지 호스팅된 컨트롤 내에 로딩되면, 자동으로 데이터에 대한 페이지를 검사하여 자동으로 Unified Service Desk의 대체 매개 변수를 채웁니다.대화형 서비스 허브 페이지 호스팅된 컨트롤 유형은 목록 조작 작업, 빠른 검색을 표시하는 검색 작업 또는 고급 검색 페이지를 포함하여 대화형 서비스 허브 페이지를 처리하는 데 고유한 미리 정의된 많은 UII 작업을 노출합니다.

Unified Service Desk는 대화형 서비스 허브 페이지를 통합 하는 방법을 쉽게 보여 주는 샘플 패키지를 대화형 서비스 허브와 함께 제공합니다. 추가 정보: TechNet: Unified Service Desk 2.1 샘플 응용 프로그램

참고

기존 Dynamics 365 페이지 유형의 호스팅된 컨트롤을 대화식 서비스 허브 페이지 유형으로 변환하여 Dynamics 365 양식 대신에 대화식 서비스 허브 응용 프로그램이 사용하는 상호 작용 환경 양식을 표시할 수 있습니다. 하지만 이 과정에 몇 가지 고려 사항이 있습니다. 자세한 내용은 블로그: Unified Service Desk 내의 상호 작용 중심 양식 지원을 참조하십시오.

이 항목의 내용

대화형 서비스 허브 페이지 호스팅된 컨트롤 만들기

미리 정의된 UII 작업

미리 정의된 이벤트

대화형 서비스 허브 페이지 호스팅된 컨트롤 만들기

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

새 호스팅된 컨트롤 화면에서:

• Unified Service Desk 영역의 USD 컴포넌트 유형 드롭다운 목록에서 대화형 서비스 허브 페이지를 선택합니다.

• 여러 페이지 허용 드롭다운 목록에서 아니요(기본) 선택하여 이 탐색 작업 호출을 수신하거나 Unified Service Desk가 탭으로 라우팅되면 현재 표시된 대화형 서비스 허브 페이지를 바꾸고 브라우저 기록을 업데이트합니다. 여러 페이지 허용 드롭다운 목록에서 예를 선택하여 두 번째 URL이 호출되거나 창 탐색 규칙이 페이지를 탭으로 이동시킬 때 드롭다운 목록을 자동으로 만듭니다. 이렇게 하면 사용자가 이 컨트롤에 추가된 대화형 서비스 허브 페이지 간을 신속하게 검색할 수 있습니다. 또한 예를 선택하면, 추가 필드인 최대 브라우저를 사용하여 드롭다운 목록에 표시되는 최대 페이지 수를 지정할 수 있습니다.

• IE 프로세스는 이 호스팅된 컨트롤 유형에 대한 기본 호스팅 유형이며, 다른 호스팅 유형을 선택할 수 없습니다.Unified Service Desk에서 지원되는 호스팅 메서드에 대한 자세한 내용은 컨트롤에 대한 호스팅 방법 선택을 참조하십시오.

• 응용 프로그램이 전역임 확인란을 선택하여 호스팅된 컨트롤을 전역으로 설정합니다. 전역 호스팅된 컨트롤은 고객 세션 외부에 표시할 수 있습니다. 에이전트의 대시보드, 벽 또는 검색 같은 컨트롤은 전역 호스팅된 컨트롤에 일반적으로 사용됩니다. 전역 호스팅된 컨트롤에는 세션 특정 상태가 없으므로 세션을 변경하면 이러한 동일한 전역 호스팅된 컨트롤이 유지됩니다. 확인란을 선택하지 않은 경우 호스팅된 컨트롤은 세션 기반이 됩니다. 세션 기반 컨트롤은 고객 세션의 컨텍스트에서 존재합니다. 사용자가 다른 세션으로 변경하는 경우 이전 세션의 모든 세션 페이지는 숨겨집니다.

• 표시 그룹 필드가 이 호스팅된 컨트롤을 표시할 창을 표시합니다.MainPanel은 이 호스팅된 컨트롤 유형에 가장 일반적입니다.Unified Service Desk에서 사용할 수 있는 다양한 창에 대한 정보는 Unified Service Desk의창 , 창 유형 및 창 레이아웃을 참조하십시오.

• 응용 프로그램이 동적임 목록에서 예 또는 아니요를 선택하여 호스팅된 컨트롤이 동적인지 여부를 지정합니다. 동적 호스팅된 컨트롤은 에이전트가 UI 또는 프로그래밍 방식의 코드로 호스팅된 컨트롤을 주문형으로 시작하거나 닫을 수 있습니다. 추가 정보: Dynamic Unified Service Desk 호스팅된 컨트롤

  예를 선택하는 경우, 사용자가 닫을 수 있음 확인란을 사용할 수 있게 됩니다. 사용자가 이 호스팅된 컨트롤을 닫을 수 있도록 하려면 이 확인란을 선택합니다.

기타 일반 필드에 대한 자세한 내용은 호스팅된 컨트롤 만들기 또는 편집를 참조하십시오.

미리 정의된 UII 작업

이는 이 호스팅된 컨트롤 유형을 위해 미리 정의된 작업입니다.

참고

호스팅된 컨트롤의 대화형 서비스 허브 페이지 유형은 호스팅된 컨트롤의 Dynamics 365 페이지 유형에서 지원하는 모든 UII 동작을 지원합니다. 그러나 일부 UII의 경우 대화형 서비스 허브 페이지 유형 호스팅된 컨트롤의 인스턴스를 처음 만들어 저장할 때에는 사용할 수 없습니다. 이후 업데이트를 통해 호스팅된 컨트롤 인스턴스에 누락 UII 동작을 추가합니다.

AssociatedView

그러면 대화형 서비스 허브의 특정 관련 보기를 로드합니다. 이러한 뷰는 일반적으로 탐색 모음에서 엔터티 레코드 이름 옆의 아래쪽 화살표를 클릭하고 관련 엔터티를 선택하여 액세스합니다.

매개 변수	설명
navItemName	표시하려는 관련 엔터티입니다. 예: Cases
Id	관련 엔터티 레코드를 표시할 기본 엔터티 레코드의 ID입니다.
tabset	Dynamics 365의 영역입니다. 예: areaSales 또는 areaService

종료

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

CloseActive

이 작업은 이 호스팅된 컨트롤 내에 있는 활성 창을 닫는 데 사용됩니다. 활성 창이 호스팅된 컨트롤에 표시되는 유일한 창인 경우 호스팅된 컨트롤 자체가 닫힙니다. 호스팅된 컨트롤에 대해 여러 페이지를 허용하지 않겠다고 선택했을 경우(여러 페이지 허용 = 아니요) 이 작업은 닫기 작업과 동일합니다.

CloseAndPrompt

이 작업은 호스팅된 컨트롤을 닫지만 닫기 전에 변경 내용을 저장할지 취소할지 묻습니다.

찾기

지정된 엔터티의 빠른 검색 목록 보기로 이동합니다.

매개 변수	설명
	데이터 매개 변수는 표시하려는 빠를 검색 목록 보기의 엔터티 논리 이름을 지정해야 합니다. 다음과 같은 몇 가지 특별한 서비스 케이스 값이 있습니다. case 또는 incident를 사용하여 서비스 케이스에 대한 빠른 검색 목록 보기를 표시합니다. advfind를 사용하여 고급 검색 보기를 표시합니다. activities 또는 activity를 사용하여 활동에 대한 빠른 검색 목록 보기를 표시합니다.

FireEvent

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

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

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

GetSelectedCount

이 작업은 선택된 항목의 수를 검색합니다.GetSelectedIds 작업을 사용하여 엔터티에 대한 ID의 실제 목록을 가져옵니다.

매개 변수	설명
	데이터 매개 변수는 선택한 ID를 검색할 목록 이름을 지정해야 합니다.

반환 값은 선택한 항목의 수량을 나타내는 수를 포함합니다.

GetSelectedIds

이 작업은 목록에서 선택한 ID를 검색하는 데 사용됩니다.

매개 변수	설명
	데이터 매개 변수는 선택한 ID를 캡처할 목록 이름을 지정해야 합니다.

반환 값은 선택한 항목을 포함하는 ID의 세미콜론으로 구분된 목록을 포함합니다.

GoBack

이 작업은 대화형 서비스 허브의 탐색 스택에서 뒤로 가게 하는 대화형 서비스 허브의 뒤로 가기 단추를 클릭하는 것과 동일합니다.

GoHome

이렇게 하면 Dynamics 365에서 사용자가 지정한 홈페이지로 이동합니다.

MoveToPanel

이 작업은 런타임에 창 간에 호스팅된 컨트롤을 이동하는 데 사용됩니다.

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

탐색

이 동작은 대화형 서비스 허브 URL로 이동하는 데 사용됩니다.

매개 변수	설명
URL	이동할 URL입니다. 이것은 필수 매개 변수입니다.
Noscan	이 매개 변수가 제공되고 If True인 경우 데이터 매개 변수는 페이지에서 캡처되지 않습니다.
HideCommandBar	이 매개 변수가 제공되고 True인 경우 대화형 서비스 허브 명령줄을 로딩하지 않고 내부 프레임이 대신 표시됩니다.
HideNavigationBar	이 매개 변수가 제공되고 True인 경우 대화형 서비스 허브 탐색줄을 로딩하지 않고 양식이 대신 표시됩니다.
postdata	HTTPPOST 트랜잭션의 일부로 서버로 전송되는 데이터입니다.POST 트랜잭션은 일반적으로 HTML 페이지에 의해 수집되는 데이터를 전송하는 데 사용됩니다.Unified Service Desk에서 이 데이터는 "http://event/?"를 사용하여 트리거된 모든 이벤트에서 받을 수 있습니다. 예: [[postdata]+] 또는 원래 형식으로 머리글 유형의 인코딩된 문자열로 데이터를 전달할 수 있습니다.
머리글	서버에 보낼 추가 HTTP 헤더를 포함하는 문자열 값입니다.postdata 매개 변수가 Navigate 작업에 사용되면 header 매개 변수에 대한 적절한 값도 지정해야 합니다. 예: Content-Type:application/x-www-form-urlencoded Unified Service DeskPOST 이벤트가 Navigate 작업을 트리거하는 경우 이 매개 변수의 기본값은 header=[[header]+]가 되어야 합니다

New_CRM_Page

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

이 동작에 대한 데이터 매개 변수로 이름의 특성 값=값 쌍을 전달할 수 있습니다. 예를 들면 다음과 같습니다.

LogicalName=incident
title=Sample Case

Open_CRM_Page

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

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

팝업

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

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

RealignWindow

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

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

새로 고침

이 작업은 현재 페이지를 새로 고칩니다.

경로 조정

이 작업은 현재 표시된 URL을 가져오며 현재 호스팅된 컨트롤에서 창 탐색 규칙을 통해 팝업으로 보냅니다.

RunScript

이 작업은 응용 프로그램의 기본 프레임에 JavaScript를 삽입합니다. 이 작업에서는 Dynamics 365 클라이언트 SDK 호출을 사용해서는 안 됩니다. 대신 RunXrmCommand 작업을 사용하십시오.

매개 변수	설명
	데이터 매개 변수는 양식에 삽입할 JavaScript입니다. 참고 대체 매개 변수는 스크립트에 사용할 수 있으며 스크립트를 실행하기 전에 바뀝니다.

RunXrmCommand

이 동작은 Dynamics 365 SDK JavaScript를 대화형 서비스 허브 양식에 삽입하는 데 사용됩니다.

매개 변수	설명
	데이터 매개 변수는 양식에 삽입할 JavaScript입니다. 참고 대체 매개 변수는 스크립트에 사용할 수 있으며 스크립트를 실행하기 전에 바뀝니다.

저장

이 작업은 대화형 서비스 허브 양식에 현재 데이터를 저장합니다.

SaveAll

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

SaveAndClose

이 작업은 대화형 서비스 허브 양식에 현재 데이터를 저장하며 호스팅된 컨트롤을 닫습니다.

SetSize

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

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

미리 정의된 이벤트

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

ActiveClosed

CloseActive 작업을 사용하여 활성 호스팅된 컨트롤이 닫힐 때 발생합니다.

매개 변수	설명
url	닫았을 때 호스팅된 컨트롤에 표시된 URL입니다.

DataReady

대화형 서비스 페이지의 데이터를 대체 매개 변수 목록에 저장한 후에 발생합니다.

매개 변수	설명
url	페이지 URL

NavigationRequested

대화형 서비스 허브 내에서 탐색이 일어나는 경우 발생합니다.

매개 변수	설명
url	탐색된 페이지 URL

RefreshRequested

현재 페이지에서 새로 고침을 요청할 때 발생합니다. 새로 고침은 F5 키를 누르거나 응용 프로그램에서 새로 고침 작업을 호출하여 요청할 수 있습니다.

매개 변수	설명
url	새로 고침을 요청할 때 표시되는 URL입니다.

Saved

대화형 서비스 허브 페이지의 레코드가 저장된 후에 발생합니다.

매개 변수	설명
newId	새로 만든 레코드에 할당된 ID입니다.

참고 항목

호스팅된 컨트롤 유형 및 동작/이벤트 참조
CRM 페이지(호스팅된 컨트롤)

Unified Service Desk 2.0

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