다음을 통해 공유

KM 컨트롤(호스팅된 컨트롤)

  • 아티클

 

게시 날짜: 2016년 11월

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

호스팅된 컨트롤의 KM 컨트롤 유형을 사용하여 에이전트 응용 프로그램의 Microsoft Dynamics 365 또는 Parature에 저장된 참조 자료 문서를 표시합니다. 새로운 호스팅된 컨트롤을 사용하여 서비스 에이전트는 문서를 검색하고 문서를 서비스 케이스와 연결 또는 연결 해제하고 문서에 링크를 복사하며 응용 프로그램을 전환할 필요 없이 전자 메일 또는 채팅을 통해 보낼 수 있습니다.추가 정보:효과적인 고객 서비스를 위한 Dynamics 365 또는 Parature 참조 자료 사용 및 Dynamics 365 또는 Parature 참조 자료를 사용하도록 Unified Service Desk 구성

이 항목의 내용

KM 컨트롤 호스팅된 컨트롤 만들기

미리 정의된 UII 작업

미리 정의된 이벤트

KM 컨트롤 호스팅된 컨트롤 만들기

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

KM 컨트롤 호스팅된 컨트롤

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

  • Unified Service Desk 영역의 USD 구성 요소 유형 드롭다운 목록에서 KM 컨트롤를 선택합니다.

  • 여러 페이지 허용 드롭다운 목록은 이 호스팅된 컨트롤 유형에서 지원되지 않습니다.

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

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

  • 표시 그룹 필드가 이 호스팅된 컨트롤을 표시할 창을 표시합니다. 참조 자료 관리 패키지에서 KM 컨트롤은 RighPanel에 표시되지만 요구 사항에 따라 LeftPanel 또는MainPanel에 표시하도록 선택할 수 있습니다.Unified Service Desk에서 사용할 수 있는 다양한 창에 대한 정보는 Unified Service Desk의창 , 창 유형 및 창 레이아웃을 참조하십시오.

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

미리 정의된 UII 작업

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

연결

Dynamics 365 또는 Parature에 있는 참조 자료 레코드를 KM 컨트롤에 있는 상위 엔터티 레코드와 연결합니다.

매개 변수

설명

entitytypename

참조 자료 레코드를 연결할 상위 엔터티의 논리적 이름입니다.entitytypename=incident을 예로 들 수 있습니다.

recordid

참조 자료 레코드를 연결할 상위 엔터티 레코드의 ID입니다.

articleuniqueid

연결하려는 문서의 고유 ID입니다.articleuniqueid=7924/8112/Article/41을 예로 들 수 있습니다.

articletitle

연결하려는 문서 제목을 나타내는 문자열 값입니다.articletitle=Diffused Sunlight and Weather Conditions을 예로 들 수 있습니다.

articleprivateurl

Parature에서 연결하려는 문서의 개인 URL입니다.articleprivateurl=https://demo.parature.com/ics/km/kmRefEdit.asp?questionID=41을 예로 들 수 있습니다.

참고

이 매개 변수는 기본 Dynamics 365 참조 자료 문서를 사용하는 경우 적용되지 않고 Parature 참조 자료에만 적용됩니다.

articlepublicurl

연결하려는 문서의 공용 URL입니다. 기본 Dynamics 365 참조 자료 문서를 사용 중인 경우 문서는 이미 외부 포털(Dynamics 365에서 참조 자료 관리 설정 대화 상자에서 외부 포털 사용 선택)에 게시되었으므로 이 매개 변수에서 문서 URL를 사용할 수 있습니다.

예: articlepublicurl=https://support.microsoft.com/kb/{kbnum}

닫기

KM 컨트롤 호스팅된 컨트롤을 닫습니다.

분리

KM 컨트롤에 있는 상위 엔터티 레코드에 이미 연결된 참조 자료 레코드를 연결 해제합니다.

매개 변수

설명

articleuniqueid

연결하려는 문서의 고유 ID입니다.articleuniqueid=7924/8112/Article/41을 예로 들 수 있습니다.

relatedentityrecordid

참조 자료 레코드가 연결된 상위 엔터티 레코드의 ID입니다.

entityname

참조 자료 레코드가 연결된 상위 엔터티의 논리적 이름입니다. 예: entitytypename=incident

FireEvent

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

매개 변수

설명

name

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

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

MoveToPanel

런타임에 Unified Service Desk에서 지정된 창으로 호스팅된 컨트롤을 이동합니다.

매개 변수

설명

app

이동될 호스팅된 컨트롤의 이름입니다.

panel

호스팅된 컨트롤을 이동할 대상 창의 이름입니다.

팝업

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

검색

검색 문자열을 매개 변수로 전달하여 KM 컨트롤에서 레코드를 검색합니다.

매개 변수

설명

쿼리

호스팅된 컨트롤에서 검색할 문자열 값입니다. 예: query=contoso. "contoso"라는 단어로 시작하는 이름이 있는 모든 참조 자료 문서를 Dynamics 365 또는 Parature에서 가져옵니다.

결과

호스팅된 컨트롤에 표시할 검색 결과의 수를 나타내는 정수 값입니다. 예를 들어, results=5를 지정하면 5개의 검색 결과가 호스팅된 컨트롤에 표시됩니다. 이 데이터 매개 변수에 대해 값을 제공하지 않거나 잘못된 값을 제공하는 경우 기본값(10)이 사용됩니다. 이 데이터 매개 변수에 허용되는 최대값은 20입니다.

필터

호스팅된 컨트롤에 표시할 참조 자료 문서 유형을 나타내는 정수 값입니다.

  • 1: 모두(기본값)

  • 2: 모든 초안 문서

  • 3: 게시된 모든 문서

  • 4: 게시됨-개인 문서

  • 5: 게시됨-공개 문서

  • 6: 게시된 만료 문서

예를 들어 게시된 참조 자료 문서만 표시하려면 filter=3를 지정합니다.

값을 제공하지 않거나 잘못된 값을 제공하는 경우 기본값(1)이 사용됩니다.

blockClick

호스팅된 컨트롤에서 검색 결과를 클릭할 때 콘텐츠의 인라인 표시를 차단할지 여부를 나타내는 정수 값입니다. 클릭했을 때 콘텐츠를 인라인으로 열려면 0으로 설정하고 콘텐츠를 인라인으로 여는 것을 차단하려면 1로 설정합니다.blocked=1을 예로 들 수 있습니다.

값을 제공하지 않거나 잘못된 값을 제공하는 경우 기본값(0)이 사용됩니다. 콘텐츠를 차단하도록 값을 1로 설정하는 경우에도 ResultOpen 이벤트는 실행됩니다.

정렬

검색 결과에서 참조 자료 문서에 대한 정렬 옵션을 지정하는 정수 값입니다.

  • 1: 관련성(기본값)

  • 2: 등급

  • 3: 보기 개수

  • 4: 마지막으로 수정한 날짜(오래된 항목 먼저)

  • 5: 마지막으로 수정한 날짜(최신 항목 먼저)

예를 들어 등급을 기반으로 문서를 정렬하려면 sort=2를 지정합니다.

값을 제공하지 않거나 잘못된 값을 제공하는 경우 데이터 매개 변수에 대해 기본값(1)이 사용됩니다.

SetArticleContext

KM 컨트롤에 있는 현재 참조 자료 문서에 데이터를 추가합니다.

매개 변수

설명

articleapplication

참조 자료 문서가 표시될 호스팅된 컨트롤의 이름입니다.

articledata

ResultOpen 이벤트에서 전달된 문서 레코드 개체 값입니다.

SetSearchProps

KM 컨트롤에서 참조 자료 문서를 검색하기 위해 다른 유형의 필터를 사용합니다.

매개 변수

설명

showFilter

참조 자료 문서를 검색하기 위해 문서 유형 필터를 사용할지 여부를 나타냅니다. 필터를 숨기려면 0으로 설정하고 필터를 표시하려면 1로 설정합니다. 예: showFilter=1.

값을 제공하지 않거나 잘못된 값을 제공하는 경우 기본값(0)이 사용됩니다.

showLang

참조 자료 문서를 검색하기 위해 언어 필터를 사용할지 여부를 나타냅니다. 필터를 숨기려면 0으로 설정하고 필터를 표시하려면 1로 설정합니다. 예: showLang=1.

값을 제공하지 않거나 잘못된 값을 제공하는 경우 기본값(0)이 사용됩니다.

showDept

참조 자료 문서를 검색하기 위해 부서 필터를 사용할지 여부를 나타냅니다. 필터를 숨기려면 0으로 설정하고 필터를 표시하려면 1로 설정합니다. 예: showDept=1.

값을 제공하지 않거나 잘못된 값을 제공하는 경우 기본값(0)이 사용됩니다.

SetSize

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

매개 변수

설명

width

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

height

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

SetUserCanClose

호스팅된 컨트롤 탭의 오른쪽 위 모서리에 있는 X 아이콘을 클릭하여 호스팅된 컨트롤을 닫을 수 있습니다.

매개 변수

설명

UserCanClose

호스팅된 컨트롤을 닫을 수 있도록 하려면 true로 설정합니다. 그렇지 않으면 false로 설정합니다.

미리 정의된 이벤트

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

PopupRouted

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

매개 변수

설명

url

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

ResultOpen

KM 컨트롤에서 콘텐츠를 읽기 위해 검색 결과를 열 때 발생합니다.

매개 변수

설명

postdata

참조 문서에 대한 양식 필드 및 값을 나타내는 키/값 쌍이 포함된 양식 데이터 개체입니다.

SearchComplete

참조 자료 문서 검색이 완료되고 호스팅된 컨트롤에 검색 결과가 로드된 후에 발생합니다.

SelectionChange

KM 컨트롤에서 결과가 선택될 때 발생합니다. .

매개 변수

설명

postdata

참조 문서에 대한 양식 필드 및 값을 나타내는 키/값 쌍이 포함된 양식 데이터 개체입니다.

참고 항목

효과적인 고객 서비스를 위한 Dynamics 365 또는 Parature 참조 자료 사용
Dynamics 365 또는 Parature 참조 자료를 사용하도록 Unified Service Desk 구성
연습 8: 에이전트 응용 프로그램 내에서 Parature 참조 자료 사용
호스팅된 컨트롤 유형 및 동작/이벤트 참조

Unified Service Desk 2.0

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