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: アクションを実行するために必要なデータ。 省略可。

  • [ActionName]ApplicationName プロパティで指定されている、ホストされたアプリケーションで登録されるアクションの名前。 必須。

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

Web アプリケーションの移動先の URL を指定します。 たとえば、ユーザーが作業するときに、Navigate 活動を使用して、Web アプリケーションを特定の URL に移動することができます。 このアクションには以下のプロパティがあります。

  • ApplicationName: コントロールをホストするアプリケーションの名前。

  • URL: クエリ文字列とともに URL を指定します。

注意

  • Web ブラウザー上で、Navigate 活動を同時に呼び出さないようにしてください。 呼び出した場合、次のエラーが発生します。

    AutomationAdapter (app=Contact,action=__SetControlValue__): 送信済みの暗黙的アクション例外: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: Web ブラウザーは使用中で停止できません。 WF/Automation <GUID> 例外: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: Web ブラウザーは使用中で停止できません。

  • ターゲット アプリケーション上で Navigate 活動が機能するには、[オートメーション アダプター (HAT)] を使用するようにホストされたアプリケーションを Unified Service Desk で構成し、次のバインディングを [オートメーション 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: Unified Service Desk もオプションを管理する」を参照してください。

  • 文字列としての XPath: アプリケーション構成ファイルを読み取るために使用します。

  • 文字列としての QueryResult: 検索結果。

InitstringReader

InitString コンテンツをオートメーションの範囲内から読み取れるようにします。 このアクションには以下のプロパティがあります。

  • 文字列としての XPath: アプリケーション構成ファイルを読み取るために使用します。

  • 文字列としての QueryResult: 検索結果。

関連項目

HAT オートメーションの作成
UII アプリケーション統合フレームワーク
データ駆動型アダプター (DDA) の使用

Unified Service Desk 2.0

© 2017 Microsoft. All rights reserved. 著作権