簡単な吹き出しを作成および表示する

このチュートリアルでは、吹き出しを作成し、オートメーションの実行中に特定の UI 要素が表示されるたびにその吹き出しを 10 秒間表示する方法について説明します。この例では、天気予報アプリ Windy を例として使用し、そのロゴの横に吹き出しを表示します。吹き出し内の内容は、[吹き出しを表示] アクティビティの Arguments ディクショナリに追加した In 引数を使用します。

前提条件

この例は、以下のアクティビティ パッケージとバージョンを使用して作成されています。

• UiPath.Callout.Activities 25.2.0
• UiPath.System.Activities 25.2.0
• UiPath.UIAutomation.Activities 25.2.1-preview

手順

1. 吹き出しファイルを作成します。
   1. Studio プロジェクトを開き、[新規] ドロップダウンから [フォーム] を選択して、新しいフォームを作成します。

      ここでは、このフォーム ファイルを吹き出しとして使用します。

   2. 吹き出しに Basic callout という名前を付けます。
   3. [コンポーネント] パネルで [基本] セクションを展開し、[ラベル/ヘッダー] コンポーネントを吹き出しファイルにドラッグします。
   4. コンポーネントと吹き出しファイルを保存します。
2. プロジェクトで Main ワークフローを開きます。
   1. [アプリケーション/ブラウザーを使用] アクティビティを追加し、[ブラウザーの URL] フィールドに「https://www.windy.com/」と入力します。
   2. [ローカル トリガーを実行] アクティビティを追加します。これにより、すべてのトリガー ワークフローが有効化され、トリガー イベントが発生したときにそのワークフローを実行できます。
3. 「Show Basic Callout」という名前の新しいワークフローを作成し、[アプリケーション イベント トリガー] アクティビティを追加します。
   1. 監視を開始するために、[画面上でターゲットを指定] を選択し、オートメーションに対して Windy のロゴを指定します。

      この例では、Windy のロゴを指定し、これを監視します。

   2. [イベントの種類] ドロップダウン リストから [出現] を選択します。
   3. [吹き出しを表示] アクティビティを追加します。
      このアクティビティにより、uiform ファイルを選択して特定の UI 要素に対して表示したり、Arguments ディクショナリを使用して uiform ファイルにデータを渡したりできます。
      1. [フォームを選択] ドロップダウン リストから、先ほど作成した吹き出しファイルを選択します。
         この例では、Basic callout を選択します。
      2. [UI 要素] フィールドに、[アプリケーション イベント トリガー] アクティビティに対して指定した UI 要素を入力します。これは、吹き出しをバインドする Windy のロゴです。
         そのターゲット要素にアクセスするために、TriggerEventArgs.TargetElement という式を使用します。TriggerEventArgs はここでは引数であり、ワークフローにトリガー アクティビティを追加すると自動的に生成されます。この場合、この引数は [アプリケーション イベント トリガー] アクティビティによって生成されます。
      3. Arguments ディクショナリを開き、生成されたキーの [値] フィールドに、表示するテキストを入力します。
         この例では、「"Welcome to Windy.com!<br>(this callout will close in 10 seconds)"」というテキストを表示します。
   4. [待機] アクティビティを追加し、値を 10 秒に設定します。
   5. 10 秒後に吹き出しを閉じるために、[フォームを閉じる] アクティビティを追加します。[フォームを選択] ドロップダウン リストから、先ほど作成した吹き出しファイル (例: Basic callout) を選択します。
   6. すべてのトリガー ワークフローの実行を停止するために、[ローカル トリガーを停止] アクティビティを追加します。

      プロジェクトがトリガー ワークフローのみで構成されている場合、このアクティビティは特に重要です。このアクティビティを組み込まないと、トリガーは停止することなく継続的なループで永続的に実行されます。

結果

オートメーションによって Windy の Web サイトが開かれ、ロゴが表示された後に Show basic callout ワークフローがトリガーされます。このワークフローは、吹き出しを 10 秒間表示した後に吹き出しを閉じます。以下のアニメーション画像は、実行時のこのシナリオを示しています。

図 1. Windy のロゴの横に吹き出しを表示する様子を示すアニメーション画像

ワークフローの例

このチュートリアルの手順の実装方法を確認するには、サンプル プロジェクト Display Callout for Windy をダウンロードしてください。