HAT オートメーションの作成

 

公開日: 2016年11月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2013、Dynamics CRM 2015、Dynamics CRM 2016

ホストされたアプリケーション ツールキット (HAT) オートメーション活動を使用して、ホストされたアプリケーション プロジェクトのオートメーションを作成できます。User Interface Integration (UII) 検査を使用して、アプリケーションのコントロールをオートメーションで使用できるようにします。 オートメーションはアプリケーションで定義されたアクションによって起動されますが、セッションで実行されるすべてのアプリケーション内の定義されたコントロールにアクセスできます。 オートメーションは、DoAction または Apppplication Integration Framework (AIF) のコンテキスト活動などの活動を通じて、非オートメーション対応アプリケーションともやり取りすることができます。詳細:HAT オートメーション活動の種類

オートメーションをアプリケーションに追加する前に、アプリケーション内のすべての必要なコントロールの検査を完了していることを確認します。 これを行うには、「UII 検査を使用してホストされたアプリケーションのバインディングを作成する」を参照してください。

このトピックの内容

HAT オートメーションの作成

オートメーションを実行するアクションの構成

オートメーションで HAT のホストされたコントロールを検証

サンプルのオートメーションの表示

HAT オートメーションの作成

  1. HAT を使用して先に作成した、オートメーションの追加先のアプリケーション プロジェクトを開きます。詳細:HAT ソフトウェア ファクトリを使用してホストされたアプリケーションを作成する。 また、別のプロジェクトでワークフローを作成し、HAT を使用して作成した既存のホストされたアプリケーションにそれを追加することができます。

  2. [ソリューション エクスプローラー] で、プロジェクト名を右クリックし、[追加] > [新しい項目] を選択します。

  3. [新しい項目の追加] ダイアログ ボックスの左側のウィンドウで、[Visual C#] > [ワークフロー] を選択して、[活動] をプロジェクトの種類として選択し、適切な名前を指定し、[追加]​​ をクリックします。

    HAT アプリケーションにワークフローを追加します。

  4. そうすることで、プロジェクトの活動ワークフロー (XAML) が追加され、HAT オートメーション活動およびオートメーションをデザインするその他の活動を入れることができるワークフロー活動デザイナー領域で XAML が開始されます。

    HAT 自動化活動のドロップ

  5. HAT 活動を使用してオートメーションを作成し、プロジェクトを保存し、それをビルドします。

    次のステップでは、前に作成した HAT アプリケーションのアクションを構成し、次にそのアクションを作成したところのオートメーションに関連付けます。

オートメーションを実行するアクションの構成

このセクションでは、アプリケーション上のアクションを構成し、それを前のセクションで作成したオートメーションに関連付けます。

  1. HAT アプリケーション プロジェクトがまだ開いていない場合は、それを Visual Studio で開きます。詳細:HAT ソフトウェア ファクトリを使用してホストされたアプリケーションを作成する

  2. [ソリューション エクスプローラー]で、HAT アプリケーション プロジェクト名を右クリックし、[アクションの構成] を選択します。

  3. 必要に応じて、[アクションの構成] ダイアログ ボックスで、アクション名およびその他の詳細を指定します。 これらのフィールドの詳細については、「ホストされたアプリケーションのアクションを構成する」を参照してください。

  4. [オートメーション][モード] リストから、[ワークフロー アセンブリを使用する] または [ワークフロー XAML を使用する] を選択してオートメーションをアクションに関連付けます。

    自動化モードを選択

  5. [ワークフローの選択] をクリックして、オートメーションを指定します。

  6. [ワークフローを選択] ダイアログ ボックスで、プロジェクト名を展開して、アクションに関連付けるワークフロー (.xaml を選択し、[OK] をクリックします。

    ワークフローの選択

  7. 次のように選択した場合:

    1. 手順 4 で [ワークフロー アセンブリを使用する] を選択した場合は、タイプ情報が選択したオートメーション (ワークフロー) の [タイプ] に入力されます。

      選択されたワークフローの情報の入力

      注意

      ワークフロー アセンブリへの絶対パスが タイプ フィールドに明記されないので、ワークフロー アセンブリ ファイルを Unified Service Desk クライアントのインストール ディレクトリにコピーして、ホストされたアプリケーションとオートメーションをテストおよび使用する必要があります。

    2. 手順 4 で [ワークフロー XAML を使用する] を選択した場合は、選択したオートメーション (ワークフロー) の XAML にワークフロー XAML が入力されます。

      選択されたワークフローの XAML

  8. 非同期モードでの実行のオートメーションを必要とする場合は、[非同期] チェック ボックスをオンにします。 オートメーションは、同期して、または 非同期に 実行できます。

    • 同期モードでは、オートメーションは Unified Service Desk ユーザー インターフェイス (UI) のスレッドで実行され、完了するまで UI はブロックされます。 UI をブロックすることは、それによって、アプリケーション UI の状態を分離して更新できるので便利です。 UI が応答しないと思われることを防止するには、オートメーションの実行時間をできる限り短くします。

    • 非同期モードでは、オートメーションは、UI とのやり取りが必要となるまで、Unified Service Desk の UI のスレッドでは実行されません。

  9. [保存] を選択して、オートメーションを起動するアクションを作成します。

  10. プロジェクトを保存してプロジェクトをビルドします ([ビルド] > [ソリューションのビルド])。

オートメーションで HAT のホストされたコントロールを検証

  1. HAT アプリケーションを Microsoft Dynamics 365 サーバー上の Unified Service Desk に展開します。詳細:Unified Service Desk にホストされたアプリケーションを展開する

  2. 必要なファイル (ワークフローおよび HAT アプリケーション アセンブリ) を Unified Service Desk クライアントのアプリケーション ディレクトリ (通常、C:\Program Files\Microsoft Dynamics CRM USD\USD) にコピーします。

  3. Unified Service Desk クライアントを実行し、デバッガーを使用して、HAT のホストされたアプリケーションとオートメーション化したアクションをテストします。[デバッガー] タブで、[アクション コール] タブの上にある下矢印をクリックして、アクション コールおよび User Interface Integration (UII) アクションをテストできる領域を表示します。

  4. [直接アクション] タブをクリックします。

    1. ホストされたコントロールと検証するアクションを選択します。

    2. 実行アイコンをクリックしてそれをテストします。

    自動化のアクションをテストするためにデバッガーを使用

    デバッガー タイプのホストされたコントロールの使用に関する詳細については、「Unified Service Desk 管理者ガイドの Unified Service Desk の問題をデバッグする」を参照してください。

ヒント

オートメーションをデバッグするには、Visual Studio を管理者ロールで起動して、HAT アプリケーション プロジェクトを開き、Unified Service Desk クライアント実行ファイル (UnifiedServiceDesk.exe) をプロジェクトのプロパティで外部起動プログラムとして設定します。 また、プロジェクトのビルド出力パスを Unified Service Desk クライアントのインストール ディレクトリに設定します。 プロジェクトをデバッグするたびに、アセンブリが Unified Service Desk クライアントのインストール ディレクトリにコピーされ、クライアントが起動されます。

サンプルのオートメーションの表示

  1. UII SDK をダウンロードして展開します。

  2. <ExtractedFolder>\UII\SampleCode\UII\Hat\QsAutomationProject フォルダーで、Microsoft.Uii.QuickStarts.QsAutomationProject.csproj ファイルを Microsoft Visual Studio で開きます。

  3. プロジェクトの参照パスを <ExtractedFolder>\UII\Bin\UII フォルダーまたは Unified Service Desk クライアントのアプリケーション ディレクトリ (通常、C:\Program Files\Microsoft Dynamics CRM USD\USD) に設定することによって ([プロジェクト] > [プロジェクト] プロパティ > [参照パス])、プロジェクトの欠落しているアセンブリ参照を修復します。

  4. プロジェクトをビルドして ([ビルド] > [ソリューションのビルド])、サンプルのオートメーション (XAML) を表示します。 プロジェクトが正常にビルドされた後、オートメーションの定義を表示するには、ソリューション エクスプローラーで XAML ファイルをダブルクリックします。

関連項目

HAT 自動化活動の使用
HAT オートメーション活動の種類
ホストされたアプリケーションのアクションを構成する

Unified Service Desk 2.0

© 2017 Microsoft. All rights reserved. 著作権