イベントをトリガーおよび監視する

以下の例では、特定のアプリケーションを開くための各種ホットキーを使用することによってユーザー イベントを監視し、さまざまなアクションをトリガーする方法を説明しています。たとえば、ユーザーは Windows の電卓アプリを開くホットキーの組み合わせを使用できます。

これは、[ホットキー トリガー]、[イベントを監視]、[イベント情報を取得] などのアクティビティを示します。これらのアクティビティは、UiPath.UIAutomation.Activities パッケージに含まれています。

サンプルと同等のオートメーション プロセスは以下のように構築できます。

1. Studio を開いて、新しいプロセスを作成します。プロセスの既定の名前は Main です。
2. デザイナー パネルに [シーケンス] コンテナーをドラッグします。

3. 次の変数を作成します。

   変数名	変数の型	既定値
   ContinueMonitor	Boolean

4. [シーケンス] コンテナー内に [メッセージをログ] アクティビティをドラッグします。

   • [プロパティ] パネルで、[ログ レベル] ドロップダウン リストからログに記録するレベルを選択します。
   • 式 "Start monitoring..." を Message フィールドに追加します。

5. [メッセージをログ] アクティビティの下に [代入] アクティビティを追加します。

   • [プロパティ] パネルの [保存先] フィールドに変数 ContinueMonitor を追加します。
   • [右辺値 (Value)] フィールドに条件 True を追加します。

6. [イベントを監視] アクティビティを [代入] アクティビティの下に配置します。

   • [プロパティ] パネルで [無限に繰り返す] フィールドに値 ContinueMonitor を追加します。

7. [イベントを監視] アクティビティ内に [ホットキー トリガー] アクティビティをドラッグします。このアクティビティで Windows の電卓アプリを開きます。

   • Alt および Shift のチェックボックスをオンにします。
   • [Key (キー)] フィールドに c を入力します。
   • [プロパティ] パネルで [イベント モード] ドロップダウン リストから [EVENT_BLOCK] オプションを選択します。

8. 別の [ホットキー トリガー] アクティビティをドラッグして、それを以前の [ホットキー トリガー] アクティビティの横に配置します。このアクティビティは、新しいブラウザー タブを開き、ユーザーが以前に選択したテキストを Google で検索します。

   • [Alt] および [Shift] のチェック ボックスをオンにします。
   • [キー] フィールドに g を入力します。
   • [プロパティ] パネルで [イベント モード] ドロップダウン リストから [EVENT_BLOCK] オプションを選択します。

9. 別の [ホットキー トリガー] アクティビティをドラッグして、それを以前の [ホットキー トリガー] アクティビティの横に配置します。このアクティビティは、イベントの監視を停止します。

   • [Alt] および [Shift] のチェック ボックスをオンにします。
   • [キー] フィールドに s を入力します。
   • [プロパティ] パネルで [イベント モード] ドロップダウン リストから [EVENT_BLOCK] オプションを選択します。

10. 新しい [シーケンス] コンテナーを追加し、[ホットキー トリガー] アクティビティの下に配置します。

    • [プロパティ] パネルで、[表示名] フィールドに Event Handler を追加します。

    • 次の変数を作成します。

      変数名	変数の型	既定値
      TriggerHotkey	UiPath.Core.EventInfo
      ContinueMonitor	Boolean

11. [イベント ハンドラー] シーケンス内に [メッセージをログ] アクティビティをドラッグします。

    • [プロパティ] パネルで [ログ レベル] ドロップダウン リストから [Info] オプションを選択します。
    • 式 "Event triggered" を Message フィールドに追加します。

12. [メッセージをログ] アクティビティの下に [イベント情報を取得] アクティビティをドラッグします。

    • [プロパティ] パネルの [結果] フィールドに変数 TriggerHotkey を追加します。
    • [TypeArgument (引数の型)] ドロップダウン リストから [UiPath.Core.EventInfo] を選択します。

13. [条件分岐 (switch)] アクティビティを、[イベント情報を取得] アクティビティの下に配置します。すべてのホットキー トリガーは、このアクティビティ内で記述され、ケースとして扱われます。

    • [プロパティ] パネルで [式] フィールドに値 TriggerHotkey.KeyEventInfo.KeyName.ToLower を追加します。
    • [TypeArgument (引数の型)] ドロップダウン リストから [文字列] を選択します。

14. [条件分岐 (switch)] アクティビティの [新しい case の追加] ボタンをクリックします。

    • [Case 値] フィールドに値 c を追加します。

15. [ケース c] コンテナー内部に [アプリケーションを開く] アクティビティを配置します。これは、[電卓] アプリを開く最初の [ホットキー トリガー] ケースを表します。

    • [プロパティ] パネルで [引数] フィールドに式 "calc.exe" を追加します。
    • 式 "<wnd app='applicationframehost.exe' title='Calculator' />" を Selector (セレクタ) フィールドに追加します。

16. [条件分岐 (switch)] アクティビティの [新しい case の追加] ボタンをクリックします。

    • [Case 値] フィールドに値 g を追加します。

17. [シーケンス] コンテナーをドラッグして、[ケース g] コンテナー内部に配置します。これは、以前に選択したテキストの Google 検索を開始する 2 番目の [ホットキー トリガー] ケースを表します。

    • [プロパティ] パネルで、[表示名] フィールドに Google selected text を追加します。

    • 次の変数を作成します。

      変数名	変数の型	既定値
      TextToSearch	GenericValue

18. [待機] アクティビティをドラッグし、Google が選択したテキスト シーケンス内に配置します。

    • [プロパティ] パネルで [期間] フィールドに値 00:00:00.5000000 を追加します。

19. [待機] アクティビティの下に [選択されたテキストをコピー] アクティビティを追加します。

    • [プロパティ] パネルで、[エラー発生時に実行を継続] フィールドに値 True を追加します。
    • Result (値) フィールドに変数 TextToSearch を追加します。
    • [タイムアウト (ミリ秒)] フィールドに値 2000 を追加します。

20. [条件分岐 (if)] アクティビティを、[選択されたテキストをコピー] アクティビティの下にドラッグします。

    • [プロパティ] パネルで [条件] フィールドに式 TextToSearch IsNot Nothing を追加します。

21. [Then] ボックス内に [ブラウザーを開く] アクティビティを配置します。

    • [プロパティ] パネルの [ブラウザーの種類] ドロップダウン リストから [IE] を選択します。
    • 式 "www.google.com" を Url フィールドに追加します。
    • [新しいセッション] オプションのチェック ボックスを選択します。これにより、選択したブラウザーの新しいセッションが開始されます。

22. [Do] シーケンス内に [文字を入力] アクティビティを配置します。

    • [プロパティ] パネルの [ターゲット] ドロップダウン リストから [ターゲット] を選択します。
    • 式 "<webctrl tag='INPUT' aaname='Search' />" を Selector (セレクタ) フィールドに追加します。
    • [準備完了まで待機] ドロップダウン リストから [INTERACTIVE] を選択します。
    • [テキスト] フィールドに変数 TextToSearch を追加します。
    • [アクティベート] オプションのチェック ボックスを選択します。このオプションにより、UI 要素が前面に表示され、テキストが書き込まれる前にアクティブ化されます。
    • [入力をシミュレート] オプションのチェック ボックスを選択します。このオプションにより、対象アプリケーションの技術を使用してキー入力がシミュレートされます。

23. [文字を入力] アクティビティの下に [ホットキーを押下] アクティビティをドラッグします。

    • [プロパティ] パネルで、[キー] フィールドに式 "enter" を追加します。
    • [ターゲット] ドロップダウン リストから [ターゲット] を選択します。
    • 式 "<webctrl tag='INPUT' aaname='Search' />" を Selector (セレクタ) フィールドに追加します。
    • [準備完了まで待機] ドロップダウン リストから [INTERACTIVE] を選択します。
    • [アクティベート] オプションのチェック ボックスを選択します。このオプションにより、UI 要素が前面に表示され、テキストが書き込まれる前にアクティブ化されます。
    • [キー修飾子] ドロップダウン リストから[None (なし)] を選択します。
    • [特殊キー] オプションのチェック ボックスをオンにします。このオプションにより、キーボード ショートカットの特殊キーを使用するかどうかを指定します。

24. [Else] コンテナー内に [メッセージ ボックス] アクティビティをドラッグします。

    • [プロパティ] パネルで、[ボタン] ドロップダウン リストから [OK] ボタンを選択します。
    • 式 "Text could not be copied. Please try again." を [テキスト] フィールドに追加します。
    • [最前面] オプションのチェック ボックスをオンにします。このオプションにより、メッセージ ボックスが常に前面に表示されます。

25. [条件分岐 (switch)] アクティビティの [新しい case の追加] ボタンをクリックします。

    • [Case 値] フィールドに値 s を追加します。

26. [ケース s] コンテナー内部に [代入] アクティビティをドラッグします。これは、イベントの監視を停止する 3 番目の [ホットキー トリガー] ケースを表します。

    • [左辺値 (To)/宛先] フィールドに変数 ContinueMonitor を追加します。
    • [右辺値 (Value)] フィールドに条件 False を追加します。

27. [イベントを監視] アクティビティの下に [メッセージをログ] アクティビティを配置します。

    • [プロパティ] パネルで [ログ レベル] ドロップダウン リストから [Info] オプションを選択します。
    • 式 "Stop monitoring.." を Message フィールドに追加します。

    • ワークフローは次のようになります。

      
      

      

      
      
28. プロセスを実行します。ロボットによって [ホットキー トリガー] が有効化され、設定したキーのショートカットを使用できます。

サンプルをダウンロードする