창 레이아웃(호스팅된 컨트롤)
게시 날짜: 2016년 11월
적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016
창 레이아웃 호스팅된 컨트롤을 사용하여 Unified Service Desk에 창의 배열을 정의합니다. 창은 다양한 호스팅된 컨트롤을 보유하며 창 레이아웃은 Unified Service Desk 클라이언트 응용 프로그램의 주 화면에 다양한 호스팅된 컨트롤의 배열을 정의합니다.Unified Service Desk에는 탭 방식 레이아웃, 데크 및 스택형 레이아웃 같은 다양한 레이아웃 옵션을 지원하는 여러 가지 미리 정의된 창 유형이 제공됩니다. 자세한 내용은 Unified Service Desk의창 , 창 유형 및 창 레이아웃을 참조하십시오.
창 레이아웃 유형의 호스팅된 컨트롤이 응용 프로그램에 정의되지 않은 경우 기본 창 레이아웃, 표준 기본 창이 자동으로 만들어집니다.창 레이아웃 유형의 호스팅된 컨트롤을 만드는 경우 표준 기본 창에 대한 대체를 구성해야 합니다. 모든 창 레이아웃은 제 위치에서 사용될 수 있지만 표준 기본 창을 정의하는 것이 매우 일반적입니다.
이 섹션의 내용
창 레이아웃 호스팅된 컨트롤 만들기
미리 정의된 UII 작업
미리 정의된 이벤트
창 레이아웃 호스팅된 컨트롤 만들기
새로운 호스팅된 컨트롤을 만드는 동안 새 호스팅된 컨트롤 화면의 필드는 만들려는 호스팅된 컨트롤의 유형에 따라 다릅니다. 이 섹션에서는 창 레이아웃 호스팅된 컨트롤 유형에 고유한 특정 필드에 대한 정보를 제공합니다. 호스팅된 컨트롤을 만드는 방법에 대한 자세한 내용은 호스팅된 컨트롤 만들기 또는 편집를 참조하십시오.
.jpeg "패널 레이아웃 호스팅된 컨트롤")
새 호스팅된 컨트롤 화면에서:
USD 구성 요소 유형 드롭다운 목록에서 창 레이아웃을 선택합니다.
PanelType 드롭다운 목록에서 만들려는 창 레이아웃 유형을 선택합니다.표준 기본 창, 리본 기본 창, 세로 분할, 가로 분할, XAML 및 사용자 정의 중에서 하나를 선택할 수 있습니다. XAML 및 사용자 정의 창 레이아웃은 사용자가 정의하는 사용자 정의 창입니다. 각 창 레이아웃에 대한 자세한 내용은 Unified Service Desk의창 , 창 유형 및 창 레이아웃을 참조하십시오. 선택한 창 유형에 따라 이 페이지의 필드가 변경됩니다.
응용 프로그램이 동적임 목록에서 예 또는 아니요를 선택하여 호스팅된 컨트롤이 동적인지 여부를 결정합니다. 동적 호스팅된 컨트롤은 전역 또는 비전역이 될 수 있습니다. 전역 동적 호스팅된 컨트롤은 처음 요청 시 로드되고 그 후에 숨겨지며 전역 세션, 일반 세션 또는 워크플로 동안 언제든지 요청할 수 있습니다. 비전역 동적 호스팅된 컨트롤은 세션이 시작된 후에만 로드할 수 있으며 각 세션은 응용 프로그램의 다른 인스턴스를 사용합니다. 동적 호스팅된 컨트롤이 워크플로의 일부이고 워크플로가 시작될 때 시작되지 않는 경우 워크플로는 호스팅된 컨트롤을 시작하고 워크플로가 완료될 때 닫힙니다.
사용자가 종료 가능 확인란은 응용 프로그램이 동적임 목록에서 예를 선택한 경우 사용할 수 있게 됩니다. 호스팅된 컨트롤을 사용자가 닫을 수 있는지 지정하려면 선택합니다.
세로 분할, 가로 분할, XAML 또는 사용자 정의를 PanelType 목록에서 선택한 경우 응용 프로그램이 전역임 확인란을 사용할 수 있게 됩니다. 호스팅된 컨트롤을 전역으로 설정하려면 선택합니다. 전역 호스팅된 컨트롤은 고객 세션 외부에 표시할 수 있습니다. 에이전트의 대시보드, 벽 또는 검색 같은 컨트롤은 전역 호스팅된 컨트롤에 일반적으로 사용됩니다. 전역 호스팅된 컨트롤에는 세션 특정 상태가 없으므로 세션을 변경하면 이러한 동일한 전역 호스팅된 컨트롤이 유지됩니다. 확인란을 선택하지 않은 경우 호스팅된 컨트롤은 세션 기반이 됩니다. 세션 기반 컨트롤은 고객 세션의 컨텍스트에서 존재합니다. 사용자가 다른 세션으로 변경하는 경우 이전 세션의 모든 세션 페이지는 숨겨집니다.
세로 분할, 가로 분할, XAML 또는 사용자 정의를 PanelType 목록에서 선택한 경우 표시 그룹 필드를 사용할 수 있게 됩니다. 이 호스팅된 컨트롤을 표시할 창을 지정합니다.Unified Service Desk에서 사용할 수 있는 다양한 창에 대한 정보는 Unified Service Desk의창 , 창 유형 및 창 레이아웃을 참조하십시오.
XAML을 PanelType 목록에서 선택한 경우 창 유형에 대한 XAML 정의를 지정할 XAML 필드가 사용할 수 있게 됩니다.
사용자 정의를 PanelType 목록에서 선택한 경우 어셈블리 URI 및 어셈블리 유형 필드가 사용할 수 있게 됩니다.어셈블리 URI 필드에 어셈블리 이름을 입력합니다.어셈블리 유형 필드에 <AssemblyName>.<ClassName> 값을 지정합니다. 사용자 정의 창 레이아웃을 만드는 방법에 대한 자세한 내용은 사용자 지정 창 레이아웃 만들기을 참조하십시오.
미리 정의된 UII 작업
이는 이 호스팅된 컨트롤 유형을 위해 미리 정의된 작업입니다.
닫기
이 작업은 호스팅된 컨트롤을 닫는 데 사용됩니다.
FireEvent
이 호스팅된 컨트롤에서 사용자 정의 이벤트를 발생시킵니다.
매개 변수 |
설명 |
|---|---|
이름 |
사용자 정의 이벤트의 이름입니다. |
이후의 모든 이름=값 쌍은 이벤트의 매개 변수가 됩니다. 사용자 정의 이벤트를 만드는 방법에 대한 자세한 내용은 사용자 정의 이벤트 만들기를 참조하십시오.
MoveToPanel
이 작업은 런타임에 창 간에 호스팅된 컨트롤을 이동하는 데 사용됩니다.
매개 변수 |
설명 |
|---|---|
앱 |
이동될 호스팅된 컨트롤의 이름입니다. |
창 |
호스팅된 컨트롤의 대상 창입니다. |
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이 기본값으로 전달됩니다. |
SetSize
이 작업은 호스팅된 컨트롤의 너비와 높이를 명시적으로 설정합니다. 이는 창 레이아웃에서 "auto"를 사용할 때 특히 유용합니다.
매개 변수 |
설명 |
|---|---|
너비 |
호스팅된 컨트롤의 너비입니다. |
높이 |
호스팅된 컨트롤의 높이입니다. |
SetVisualProperty
호스팅된 컨트롤의 시각적(UIElement) 속성을 설정합니다. 이 작업 호출은 창 자동 표시 또는 숨기기 같은 UI 자동화에 특히 유용합니다. 이 작업을 효율적으로 사용하려면 XAML 및 Unified Service Desk 레이아웃에 익숙해야 합니다.
매개 변수 |
설명 |
|---|---|
elementname |
Expander, StackPanel 및 Grid 같은 속성을 설정하려는 UI 요소의 이름입니다. 예: elementname=Expander |
propertyname |
Height, Width, Visibility 및 Color 같이 설정하려는 지정된 요소의 속성 이름입니다. 예: propertyname=Visibility |
value |
지정된 속성에 적절한 값을 지정합니다. 이 매개 변수에 지원되는 값 유형은 string, enumeration, integer 또는 bool입니다. value=Visible을 예로 들 수 있습니다. |
이 메시지의 사용 예제는 연습 8: 에이전트 응용 프로그램 내에서 Parature 참조 자료 사용의 3단계: 참조 자료 검색 창을 자동으로 표시하고 숨길 작업 호출 구성를 참조하십시오.
참고
기본적으로 이 작업은 호스팅된 컨트롤의 창 레이아웃 유형에만 노출됩니다.DynamicsBaseHostedControl 클래스에서 파생된 다른 모든 미리 정의된 Unified Service Desk 호스팅된 컨트롤 유형에 SetVisualProperty 작업을 사용하려면 SetVisualProperty라는 UII 작업을 해당 호스팅된 컨트롤에 명시적으로 추가해야 합니다.추가 정보: 호스팅된 컨트롤에 UII 동작 추가
미리 정의된 이벤트
이 호스팅된 컨트롤 유형에 사용할 수 있는 미리 정의된 이벤트는 없습니다.
참고 항목
Unified Service Desk의창 , 창 유형 및 창 레이아웃
UII 작업
이벤트
Unified Service Desk 구성 연습
호스팅된 컨트롤 유형 및 동작/이벤트 참조
TechNet: Microsoft Dynamics CRM용 Unified Service Desk 관리 가이드
Unified Service Desk 2.0
© 2017 Microsoft. All rights reserved. 저작권 정보