다음을 통해 공유


HAT 자동화 활동 유형

 

게시 날짜: 2016년 11월

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

호스트형 응용 프로그램을 자동화하는 데 사용할 수 있는 다양한 유형의 호스트형 응용 프로그램 도구 키트(HAT) 자동화 작업이 있습니다.HAT 자동화 작업을 보고 사용하려면 HAT 자동화 활동 사용를 참조하십시오.

이 항목의 내용

AIF(응용 프로그램 통합 프레임워크) 작업 활동

AIF 컨텍스트 활동

DDA 활동

AIF(응용 프로그램 통합 프레임워크) 작업 활동

작업 활동은 UII 작업에 액세스하고 관리하는 기능을 제공합니다. 다음 표에서는 사용할 수 있는 다양한 작업 활동에 대해 설명합니다.

활동

설명

DoAction

동일한 응용 프로그램 또는 다른 호스트형 응용 프로그램에서 작업을 실행합니다. 이 작업에는 다음과 같은 속성이 있습니다.

  • ApplicationName: DoAction을 실행하는 응용 프로그램입니다. 필수.

  • ActionData: 작업을 수행하는 데 필요한 데이터입니다. 선택 사항.

  • ActionNameApplicationName 속성에 지정된 호스트형 응용 프로그램으로 등록된 작업 이름입니다. 필수.

GetActionData

워크플로 또는 자동화를 호출한 작업에서 데이터를 검색합니다. 값은 ActionData 속성에서 반환됩니다.

SetActionData

현재 작업에 데이터를 추가합니다.

ActionData 매개 변수에 작업에 필요한 데이터를 지정합니다.

RegisterActionForEvent

이벤트가 발생할 때마다 시작되는 작업을 등록합니다. 이 작업에는 다음과 같은 속성이 있습니다.

  • ActionApplication: UII 작업이 등록된 응용 프로그램의 이름입니다. 필수.

  • ActionName: 이벤트가 시작될 때 실행되는 응용 프로그램에 대한 작업의 이름입니다. 필수.

  • ApplicationName: 이벤트를 시작하는 응용 프로그램의 이름입니다. 필수.

  • ControlName: 이벤트를 시작하는 컨트롤의 이름입니다. 선택 사항.

  • EventName: 응용 프로그램/컨트롤에서 시작한 이벤트의 이름입니다.

UnRegisterActionForEvent

RegisterActionForEvent 활동을 사용하여 이전에 등록한 작업을 등록 해제합니다. 등록되지 않은 이벤트는 더 이상 실행할 수 없습니다. 이 작업에는 다음과 같은 속성이 있습니다.

  • ActionApplicationName: UII 작업이 등록된 응용 프로그램의 이름입니다.

  • ActionName: 이벤트가 시작될 때 실행되는 응용 프로그램에 대한 작업의 이름입니다.

  • ApplicationName: 이벤트를 시작하는 응용 프로그램의 이름입니다.

  • ControlName: 이벤트를 시작하는 컨트롤의 이름입니다.

  • EventName: 응용 프로그램 또는 컨트롤에서 시작한 이벤트의 이름입니다.

CloseDynamicApp

자동화 내에서 동적 호스트형 응용 프로그램을 닫습니다. 이 작업을 사용하여 Unified Service Desk의 동적 호스트형 응용 프로그램을 프로그래밍 방식으로 닫을 수 있습니다.

ApplicationName 매개 변수에 닫으려는 동적 호스트형 응용 프로그램의 이름을 지정합니다.

동적 호스트형 응용 프로그램에 대한 자세한 내용은 동적 UII 호스트형 응용 프로그램을 참조하십시오.

StartDynamicApp

자동화 내에서 동적 호스트형 응용 프로그램을 시작합니다.

ApplicationName 매개 변수에 시작하려는 동적 호스트형 응용 프로그램의 이름을 지정합니다.

FocusApp

자동화 내에서 응용 프로그램에 포커스를 설정합니다.

ApplicationName 매개 변수에 포커스를 설정하려는 동적 호스트형 응용 프로그램의 이름을 지정합니다.

AIF 컨텍스트 활동

컨텍스트 활동은 자동화에서 AIF 컨텍스트에 액세스하는 것을 허용합니다. 다음 표에서는 사용할 수 있는 다양한 컨텍스트 활동에 대해 설명합니다.

활동

설명

GetContext

컨텍스트에서 지정된 키의 값을 검색합니다. 값은 ContextValue 속성에서 반환됩니다.

ContextKey 속성에 검색할 컨텍스트의 키를 지정합니다.

SetContext

컨텍스트에서 지정된 키의 값을 설정합니다. 이 작업에는 다음과 같은 속성이 있습니다.

  • ContextKey: 설정할 컨텍스트의 키입니다.

  • ContextData: 선택적으로 ContextKey에 지정된 컨텍스트를 설정할 데이터를 입력합니다.

GetCredential

지정된 응용 프로그램의 컨텍스트에서 사용자 자격 증명을 검색합니다. 이 작업에는 다음과 같은 속성이 있습니다.

  • ApplicationName: 응용 프로그램의 이름입니다.

  • UserName: 사용자 이름입니다.

  • Password: 암호입니다.

참고

사용자 지정 저장소에서 자격 증명을 검색하려면 개발자는 ISsoLookupService 인터페이스를 구현하는 클래스를 제공해야 합니다.

HostApplication

응용 프로그램의 UI를 호스팅합니다.Microsoft Dynamics 365 서버의 Unified Service Desk에서 호스팅된 컨트롤을 구성하는 동안 지정된 응용 프로그램 호스팅 구성 데이터를 사용하여 호스팅 모드를 결정합니다.Unified Service Desk에서 응용 프로그램의 호스팅 모드를 지정하는 방법에 대한 자세한 내용은 UII 호스트형 응용 프로그램 만들기 및 관리을 참조하십시오.

DDA 활동

데이터 기반 어댑터(DDA) 활동은 바인딩에 지정된 컨트롤에 대한 액세스를 제공합니다. 다음 표에서는 다양한 DDA 활동을 설명합니다.

활동

설명

ControlFinder

호스트형 응용 프로그램에서 컨트롤을 찾습니다. 작업은 컨트롤이 ControlFound 속성에서 발견되는 경우 True를 반환하고, 그렇지 않으면 False를 반환합니다. 예외 처리기를 사용하여 종속 활동을 실행하려는 경우 ExceptionsMask 속성을 설정할 수 있습니다. 이 작업에는 다음과 같은 속성이 있습니다.

  • ApplicationName: 컨트롤을 호스팅하는 응용 프로그램의 이름입니다. 필수.

  • ControlName: 응용 프로그램에 있는 컨트롤의 이름입니다.

  • ExceptionsMask: 컨트롤을 찾을 수 없는 경우 예외를 표시할지 여부를 나타냅니다. 기본 설정은 False입니다.

참고

구성한 워크플로가 UI 스레드를 차단하고 있고 ControlFinder 활동에 대해 SleepInterval 및 Timeout 매개 변수를 지정한 경우 작업을 동기적으로 실행하도록 구성해야 합니다.

ExecuteControlAction

컨트롤의 기본 작업을 실행합니다. 예를 들어, 컨트롤이 단추인 경우 기본 작업은 클릭입니다. 이 작업에는 다음과 같은 속성이 있습니다.

  • ApplicationName: 컨트롤을 호스팅하는 응용 프로그램의 이름입니다.

  • ControlName: 응용 프로그램에 있는 컨트롤의 이름입니다.

GetControlValue

응용 프로그램에서 컨트롤의 값을 검색합니다. 값은 ControlValue 속성에서 반환됩니다. 이 작업에는 다음과 같은 속성이 있습니다.

  • ApplicationName: 컨트롤을 호스팅하는 응용 프로그램의 이름입니다.

  • ControlName: 응용 프로그램에서 값을 검색할 컨트롤의 이름입니다.

참고

여러 줄 텍스트 컨트롤과 함께 GetControlValue 활동을 사용할 때는 모든 줄 바꿈 문자는 무시되고 단일 문자열이 반환됩니다.

SetControlValue

응용 프로그램에 있는 컨트롤의 값을 설정합니다. 이 작업에는 다음과 같은 속성이 있습니다.

  • ApplicationName: 컨트롤을 호스팅하는 응용 프로그램의 이름입니다.

  • ControlName: 응용 프로그램에서 값을 설정할 컨트롤의 이름입니다.

  • ControlValue: 설정할 값을 입력합니다.

참고

여러 줄 텍스트 컨트롤과 함께 SetControlValue 활동을 사용할 때는 모든 줄 바꿈 문자는 무시되고 단일 문자열이 반환됩니다.

Navigate

웹 응용 프로그램이 이동하는 URL을 지정합니다. 예를 들어, Navigate 활동을 사용하여 사용자가 작업을 수행할 때 웹 응용 프로그램이 특정 URL로 강제로 이동하도록 할 수 있습니다. 이 작업에는 다음과 같은 속성이 있습니다.

  • ApplicationName: 컨트롤을 호스팅하는 응용 프로그램의 이름입니다.

  • URL: 쿼리 문자열과 함께 URL을 지정합니다.

참고

  • 웹 브라우저에서 Navigate 활동을 동시에 호출해서는 안 됩니다. 동시에 호출할 경우 다음과 같은 오류 메시지가 나타납니다.

    AutomationAdapter(app=Contact,action=__SetControlValue__): 암시적 작업 예외 게시: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: 웹 브라우저를 사용 중이므로 중지할 수 없습니다. WF/자동화  <GUID>  예외: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: 웹 브라우저를 사용중이므로 중지할 수 없습니다.
  • Navigate 활동을 대상 응용 프로그램에서 작동하도록 하려면 Unified Service Desk에서 자동화 어댑터(HAT)를 사용하도록 호스트형 응용 프로그램을 구성하고 자동화 XML 필드에 다음 바인딩을 제공해야 합니다.

    <DataDrivenAdapterBindingsCollection>    <DataDrivenAdapterBindings>       <Type>Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.WebDataDrivenAdapter, Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter</Type>       <Controls/>    </DataDrivenAdapterBindings> </DataDrivenAdapterBindingsCollection>

    Unified Service Desk에서 호스팅된 컨트롤 구성에 대한 자세한 내용은 UII 호스트형 응용 프로그램 만들기 및 관리을 참조하십시오.

Audit

자동화 내에서 감사 항목을 만듭니다. 이 작업에는 다음과 같은 속성이 있습니다.

  • Audit Flag: 감사 플래그의 이름입니다.

  • Log data: 감사 플래그 값의 값입니다.

Unified Service Desk에서 다양한 감사 플래그에 대한 자세한 내용은 Unified Service Desk 관리 가이드에서 Unified Service Desk의 감사 구성을 참조하십시오.

ConfigReader

자동화 내에서 구성 값을 읽습니다. 이 활동은 Unified Service Desk 또는 응용 프로그램 구성 파일의 옵션 설정에서 구성을 읽습니다. 이 작업에는 다음과 같은 속성이 있습니다.

  • 문자열로서의 OptionKey: Unified Service Desk에서 옵션 설정을 읽는 데 사용됩니다. 다양한 옵션에 대한 자세한 내용은 TechNet: 통합 서비스 데스크 옵션 관리를 참조하십시오.

  • 문자열로서의 XPath: 응용 프로그램 구성 파일을 읽는 데 사용됩니다.

  • 문자열로서의 QueryResult: 검색 결과입니다.

InitstringReader

자동화 내에서 InitString 콘텐츠를 읽을 수 있도록 합니다. 이 작업에는 다음과 같은 속성이 있습니다.

  • 문자열로서의 XPath: 응용 프로그램 구성 파일을 읽는 데 사용됩니다.

  • 문자열로서의 QueryResult: 검색 결과입니다.

참고 항목

HAT 자동화 만들기
UII 응용 프로그램 통합 프레임워크
데이터 기반 어댑터 사용(DDA)

Unified Service Desk 2.0

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