フォーム イベント トリガー

UiPath.Forms.Activities.FormTriggerActivity<UiPath.Forms.Activities.FormInfoTriggerEventArgs>

説明

このアクティビティを使用すると、フォーム内で発生するイベントに基づいてワークフローをトリガーできます。たとえば、フォームが閉じられたり、フォーカスが失われたりした場合、特定のボタンがクリックされた場合、特定のテキスト フィールドが変更された場合に、ワークフローをトリガーするよう選択できます。いずれかのワークフローで [フォーム トリガー アクティビティ] を使用している場合、プロジェクトの実行後に TextTriggerEventArgs 型の TriggerEventArgs という名前の引数が [引数] パネルに表示されます。

注:

• このトリガー アクティビティは、ワークフローの最初のアクティビティである必要があります。
• 1 つのワークフローにつき使用できるトリガー アクティビティは 1 つのみです。

プロジェクトの対応 OS

Windows

構成

デザイナー パネル

• フォームを選択 - トリガーの作成の基になるフォーム ファイルを選択します。既存のフォーム ファイルを選択するか、[新しいフォームを作成] をクリックしてフォーム ファイルの作成を開始できます。
• イベント - フォーム内で、開始するトリガーの基にするイベントを選択します。既定のフォーム イベントは次のとおりです。
  • フォームが閉じられた
  • フォームのフォーカスが失われた
  • フォームにフォーカスが置かれた
  • フォームのステートが変更された (最小化/復元)
  • [フォームを選択] で選択したフォーム ファイルに応じて、フォーム ファイルで使用されているフォーム コンポーネントに固有の他のイベントが表示されます。たとえば、 ボタン コンポーネントの場合、[ ボタンのクリック] などのフォーム イベントが表示されます。
• メッセージ ID - uipathApi.sendMessageを使用してフォームから送信されるメッセージの ID です。このプロパティは、カスタム HTML フォームのトリガーを作成する場合にのみ必要です。

[メッセージ ID] プロパティを通じてデータを渡すと、フォーム イベントが送信されます。uiform ファイルでは、定義済みのフォーム イベントを使用できます。ただし、HTML フォームの場合は、 uipathApi.sendMessage JavaScript 関数を使用してフォーム イベントを作成する必要があります。このプロセスでは、HTML ファイル内に 「クリックを却下」などのフォーム イベントを作成する必要があります。このイベントのトリガーを作成するには、[ メッセージ ID ] プロパティにイベント名を指定する必要があります。詳細については、「 カスタム HTML を使用してフォームを設計する」を参照してください。

プロパティ パネル

• 有効化 - [有効化] が [オン] の場合、選択したフォーム イベントが発生するとトリガーが開始します。[有効化] が [オフ] の場合、トリガーは、[トリガーを有効化] アクティビティを使用して明示的に有効化した場合にのみ開始されます。
• スケジュール モード - トリガーが発生した場合のアクションの実行方法を指定します。ドロップダウン メニューから次の 5 つのオプションのいずれかを選択します。
  • Sequential - アクションは 1 つずつ順番に実行されます。
  • Concurrent - アクションの実行が重なる場合があります。
  • OneTime - 1 つのアクションを実行し、監視を終了します。
  • SequentialCollapse - 現在のイベントの実行が完了するまで、今後発生するすべてのイベント (最新のイベントを除く) を無視します。
  • 順次 (drop) - 前のイベントの実行を停止し、次のイベントを開始します。[順次] と [同時] モードでは、ユーザーが実行を停止するか [繰り返しを終了] アクティビティに到達するまで監視が継続します。
• トリガー ID - このトリガーの一意の識別子です。[トリガー ID] は、[トリガーを繰り返し] などの他のアクティビティで使用できます。
• インスタンス名 - フォーム ファイルの 1 つのインスタンスに対してのみトリガーを実行する場合は、このフィールドにインスタンス名を入力します。フォームのすべてのインスタンスに対してトリガーを実行する場合は、このフィールドを空のままにします。