次の方法で共有

Unified Service Desk の HAT 自動化活動の種類

  • [アーティクル]

ホストされたアプリケーションの自動化に使用できるホストされたアプリケーション ツールキット (HAT) オートメーション活動にはさまざまな種類があります。 HAT 自動化活動を表示して使用するには、HAT 自動化活動の使用を参照してください。

アプリケーション統合フレームワーク (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: パスワード。

Note

カスタム ストアから資格情報を取得するには、開発者は Microsoft.Uii.AifServices.ISsoLookupService インターフェイスを実装するクラスを用意する必要があります。

HostApplication
アプリケーションの UI をホストします。 ホスト モードの決定のために Microsoft Dataverse のサーバー上の Unified Service Desk でホストされたコントロールを構成するときに指定される、アプリケーション ホスト構成データを使用します。 Unified Service Desk でアプリケーションのホスト モードを指定する方法の詳細については、UII のホストされたアプリケーションの作成および管理を参照してください。

DDA 活動

データ駆動アダプター (DDA) 活動によって、バインディングで指定されるコントロールにアクセスできるようになります。 ここではさまざまな DDA 活動を使用できます。

Audit
監査エントリをオートメーションの範囲内から作成します。 このアクションには以下のプロパティがあります。

  • Audit Flag: 監査フラグの名前。

  • Log data: 監査フラグ値の値。

    Unified Service Desk のさまざまな監査フラグについては、Unified Service Desk の監査と診断を構成するを参照してください。

    ControlFinder
    ホストされたアプリケーション内のコントロールを特定します。 コントロールが ControlFound プロパティ内に見つかった場合、このアクションは True を返します。それ以外の場合は、False を返します。 依存する活動を例外ハンドラーを使用して実行する場合は、ExceptionsMask プロパティを設定できます。 このアクションには以下のプロパティがあります。

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

  • ControlName: アプリケーション内のコントロールの名前。

  • ExceptionsMask: コントロールが見つからなかった場合に例外を表示するかどうかを指示します。 既定の設定は False です。

Note

構成したワークフローが UI スレッドをブロックし、ControlFinder 活動の SleepInterval パラメーターと Timeout パラメーターを指定した場合は、アクションは非同期的に実行されるように構成する必要があります。

ExecuteControlAction
コントロールの既定のアクションを実行します。 たとえば、コントロールがボタンの場合、既定のアクションはクリックです。 このアクションには以下のプロパティがあります。

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

  • ControlName: アプリケーション内のコントロールの名前。

    GetControlValue
    アプリケーション内のコントロールから値を取得します。 この値は ControlValue プロパティに返されます。 このアクションには以下のプロパティがあります。

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

  • ControlName: 値を取得する必要があるアプリケーション内のコントロールの名前。

Note

複数行テキスト コントロールで GetControlValue 活動を使用する場合、すべての改行文字は無視され、単一の文字列が返されます。

SetControlValue
アプリケーション内のコントロールの値を設定します。 このアクションには以下のプロパティがあります。

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

  • ControlName: 値を設定する必要があるアプリケーション内のコントロールの名前。

  • ControlValue: 設定する値を入力します。

Note

複数行テキスト コントロールで SetControlValue 活動を使用する場合、すべての改行文字は無視され、単一の文字列が返されます。

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

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

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

Note

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

    AutomationAdapter (app=Contact,action=__SetControlValue__): Posted implicit action exception:  Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: Web browser is busy and cannot be stopped.   

WF/Automation <GUID> exception: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: Web browser is busy and cannot be stopped.
    • ターゲット アプリケーション上で 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 のホストされたアプリケーションの作成および管理を参照してください。

ConfigReader
構成値をオートメーションの範囲内から読み取ります。 この活動は、Unified Service Desk のオプション設定から、またはアプリケーション構成ファイルから構成を読み取ります。 このアクションには以下のプロパティがあります。

  • 文字列としての OptionKey: Unified Service Desk からオプション設定を読み取るために使用します。 各種オプションの詳細については、「Unified Service Desk のオプションを管理する」を参照してください。

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

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

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

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

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

関連項目

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