다음을 통해 공유

표준 웹 응용 프로그램(호스팅된 컨트롤)

  • 아티클

 

게시 날짜: 2016년 11월

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

표준 웹 응용 프로그램 호스트형 컨트롤 유형은 CRM 페이지 유형과 유사하지만 외부 웹 페이지와 같은 비Dynamics 365 페이지를 호스팅하며, 외부 웹 페이지의 관련 기능에 대한 스크립트 삽입을 제공한다는 점에서 다릅니다.CRM 페이지 호스팅된 컨트롤처럼 이러한 페이지는 자동화할 수 있습니다. 선호하는 자동화 방법은 페이지에 이미 정의되어 있거나 DOM을 조작하는 JavaScript 함수의 호출을 포함하여 JavaScript 삽입을 통하는 방법입니다.RunScript 작업은 페이지에서 값을 가져오는 데 사용될 수도 있습니다.

참고

이 호스팅된 컨트롤 유형은 호스트형 응용 프로그램의 UI 자동화 작업을 이용하는 호스트형 응용 프로그램 도구 키트(HAT)를 지원하지 않습니다. HAT은 데이터 기반 어댑터(DDA), 설명 바인딩 및 자동화(Windows 워크플로)로 구성되어 있으며 응용 프로그램을 자동화합니다.추가 정보:UII 자동 어댑터를 사용하여 외부 및 웹 응용 프로그램과 상호 작용

이 항목의 내용

표준 웹 응용 프로그램 호스팅된 컨트롤 만들기

미리 정의된 UII 작업

미리 정의된 이벤트

표준 웹 응용 프로그램 호스팅된 컨트롤 만들기

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

표준 웹 응용 프로그램 호스팅된 컨트롤

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

  • Unified Service Desk 영역의 CTI 데스크톱 관리자 드롭다운 목록에서 표준 웹 응용 프로그램을 선택합니다.

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

  • 호스팅 유형 드롭다운 목록은 이 컨트롤을 호스팅하는 방법을 지정합니다.IE 프로세스 기본값 또는 내부 WPF를 선택할 수 있습니다. 자세한 내용은 컨트롤에 대한 호스팅 방법 선택을 참조하십시오.

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

  • 표시 그룹 필드에서 창이 호스팅된 컨트롤을 표시할 을 지정합니다.Unified Service Desk에서 사용할 수 있는 다양한 창에 대한 정보는 Unified Service Desk의 창을 참조하십시오.

미리 정의된 UII 작업

이는 이 호스팅된 컨트롤 유형에 사용할 수 있는 미리 정의된 UII 작업입니다.

닫기

이 작업은 호스팅된 컨트롤을 닫는 데 사용됩니다.

FireEvent

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

매개 변수

설명

이름

사용자 정의 이벤트의 이름입니다.

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

GoBack

이 작업은 브라우저 인스턴스에서 뒤로 단추를 클릭하는 것과 같습니다.

GoForward

이 작업은 브라우저 인스턴스에서 앞으로 단추를 클릭하는 것과 같습니다.

GoHome

이 작업은 이 브라우저 인스턴스에 대해 지정된 초기 URL로 이동합니다.

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

새 인스턴스를 만들기 위한 엔터티의 논리적 이름입니다.

참고

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

Open_CRM_Page

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

매개 변수

설명

LogicalName

열려는 엔터티의 논리적 이름입니다.

id

열려는 엔터티 레코드의 ID입니다.

팝업

호스팅된 컨트롤의 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이 기본값으로 전달됩니다.

RunScript

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

매개 변수

설명

데이터 매개 변수는 양식에 삽입할 JavaScript입니다.

참고

대체 매개 변수는 스크립트에 사용할 수 있으며 스크립트를 실행하기 전에 바뀝니다.

SetSize

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

매개 변수

설명

너비

호스팅된 컨트롤의 너비입니다.

높이

호스팅된 컨트롤의 높이입니다.

WaitForComplete

이 작업은 URL 로드가 완료될 때까지 처리를 차단하는 데 사용할 수 있습니다.

참고

일부 웹 페이지, 특히 Dynamics 365 페이지에는 여러 프레임이 있습니다. 이 작업은 기본 프레임이 완료될 때까지만 기다립니다.

매개 변수

설명

밀리초

시간 초과되기 전에 기다려야 하는 시간(밀리초)를 나타내는 옵션 매개 변수입니다.

미리 정의된 이벤트

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

BrowserDocumentComplete

페이지가 로드를 끝낼 때 발생합니다.CRM 페이지 유형의 호스팅된 컨트롤에서 이 이벤트는 데이터가 대체 매개 변수 목록에 저장된 후 발생합니다. 여러 프레임이 자신의 BrowserDocumentComplete 이벤트를 개별적으로 발생시키기는 하지만 이 이벤트는 한 번만 발생합니다.

매개 변수

설명

url

로드가 완료된 페이지의 URL입니다.

PopupRouted

팝업이 시스템에 의해 라우팅된 후에 발생합니다.

매개 변수

설명

url

라우팅된 팝업의 URL입니다.

참고 항목

UII 작업
이벤트
미리 정의된 작업 및 호스팅된 컨트롤에 대한 이벤트 보기
호스팅된 컨트롤 만들기 또는 편집
연습 2: 에이전트 응용 프로그램에 외부 웹 페이지 표시
호스팅된 컨트롤 유형 및 동작/이벤트 참조

Unified Service Desk 2.0

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