トリガー

トリガーは、コネクタ プラットフォームからイベントを設定するための統一されたメカニズムです。この機能を使用することで、Orchestrator からオートメーションまたはプロセスを自動的に開始する柔軟性が得られます。

概要

Integration Service のコネクションに基づくイベント トリガーには、次の 2 つの種類があります。

• 接続済み – Studio のトリガー アクティビティで作成され、プロセス内で使用されます。
• 切断 – Orchestrator または Integration Service で作成され、オートメーションの開始に使用されます。

手記： トリガーはコネクションに依存します。コネクションを削除すると、関連するトリガーもすべて削除されます。

前提条件

トリガーを設定する前に、次の条件が満たされていることを確認してください。

• Integration Service はテナントに対して有効化され、プロビジョニングされている。
• Orchestrator インスタンスで Unattended または NonProduction ロボットが設定済みである。
• モダン フォルダーを使用している (クラシック フォルダー内のプロセスは、トリガーを定義するときに表示されない)

ポーリング間隔の更新

コネクタはポーリング メカニズムを通じてイベントをサポートしています。

コネクションにイベント トリガーを設定すると、ポーリング間隔は既定で 5 分に設定されます。

ポーリング間隔は接続レベルで設定されます。つまり、コネクションごとに複数のトリガーを作成しますが、コネクションごとに設定できるポーリング間隔は 1 つのみです。ポーリング間隔を変更すると、コネクションに関連するすべてのトリガーに影響が出ます。

ポーリングは、選択した間隔でコネクションに実行されます。データが取得されると、そのコネクションに対するアクティブなトリガーはすべてデータ セットに適用されます。ポーリング間隔の変更時にポーリングが実行されている場合は、サービスは既存のポーリングが終了するまで待機してから、新しいポーリングを開始します。

ポーリング間隔を更新するには、次のようにします。

1. Integration Service で [ コネクション ] タブに移動します。
2. 特定のコネクションを選択して、コネクションの詳細ページを開きます。

   ポーリング間隔は、トリガーが追加されたコネクションに対してのみ表示されます。

3. 時間間隔を選択して、[ ポーリング間隔の更新 ] ウィンドウを開きます。

4. 利用可能なオプションの 1 つを選択するか、カスタム間隔 (分単位または時間単位) を設定できます。ポーリング間隔は 1 分を超え、24 時間または 1440 分以下である必要があります。

5. [ 更新して確認] を選択します。

トリガーの実行履歴を表示する

トリガーの実行履歴を表示するには、以下の手順を実行します。

1. Integration Service で [ トリガー ] タブを選択します。
2. リストに表示されているトリガーについて、[その他のアクション] メニューを使用して [トリガーを表示] を選択します 。

答案の履歴テーブルには、次の情報が表示されます。

• イベント時刻 – イベントがキャプチャされた日時
• 試行回数
• トリガーの状態 – プロセスが正常に起動されたかどうかを示します。

注: [成功] ステートは、ジョブが正常に起動されたことを示します。ジョブが最後まで正常に実行されたかどうかを反映するものではありません。 ジョブの開始に失敗した場合、[ステート] には [失敗] と表示されます。[失敗] ステートの上にマウス カーソルを置くと、エラー メッセージが表示されます。

ジョブが正常に実行されたかどうかを確認するには、[ ジョブ ログを表示 ] ボタンを選択します。この操作により、Orchestrator にリダイレクトされ、ジョブの実行に必要な情報をすべて確認できます。

トリガーを管理する

Integration Service で作成されたトリガーに対しては、以下の操作を実行できます。

トリガーの名前を変更する

トリガーの名前を変更するには、次の手順に従います。

1. [トリガー] タブを開きます。
2. 変更するトリガーの名前の上にマウス カーソルを置きます。 [編集] ボタンが表示されます。
   または、リストからトリガーを選択して詳細を表示することもできます。[編集] ボタンはトリガー名の右側にあります。
3. [ 編集 ] ボタンを選択すると、トリガーの新しい名前を選択できます

トリガーを削除する

[Integration Service] 画面の [ トリガー] タブに移動します。対象のトリガーに対応する [ その他のアクション ] ボタンを選択し、[ 削除] を選択します。

トリガーのアクティブ化または非アクティブ化

トリガーをアクティブ化または非アクティブ化するには、まずトリガーを選択して詳細を表示する必要があります。 次に、ウィンドウの左上隅にあるスイッチを選択します。

イベントの引数

切断されたトリガーを使用すると、プロセスをトリガーするコネクタとイベントに関するデータを取得できます。

ワークフローでプロセスを実際にトリガーした、コネクタ、イベント、レコードの種類、またはレコードを確認する場合は、プロセス内で String 型の以下の入力引数を定義します。Integration Service は、ジョブの開始時に自動的に値を設定します。

• UiPathEventConnector - オートメーションを開始したコネクタを特定します。
• UiPathEvent - 発生したイベントの種類を特定します。
• UiPathEventObjectType - イベントによって生成される特定のレコードの種類を定義します。
• UiPathEventObjectId - イベントに関係するオブジェクトに対して識別された一意のトークンを提供します。

これらの引数に値を割り当てることはできません。引数はトリガーの実行時に自動的に入力され、Studio の [引数] パネルから 表示 または編集することはできません。引数の動作と管理方法の詳細については、Studio のドキュメント「引数を管理する」をご覧ください。

ジョブ実行時にトリガーされたレコードを取得して操作するには、 UiPathEventObjectId 入力引数を使用してソース システムからレコードを取得します。

以下に、Integration Service が入力引数の値を Orchestrator のログに渡す方法の例を示します。

トリガー固有の出力

接続トリガーには、オブジェクト固有の出力があります。たとえば、[Microsoft OneDrive & SharePoint メールの受信] Office365MessageAttachmentsNamesListトリガーは、FromAddress 、InternetMessageId 、SentDateTime などのプロパティを持つ 型のオブジェクト 出力します。詳しくは、「イベントMicrosoft OneDrive & SharePoint」をご覧ください。

Studio の [式エディター ] を使用して、トリガー出力オブジェクトで利用可能なすべてのプロパティを表示します。

制限事項

トリガーの制限事項については、このガイドの 「トラブルシューティング 」セクションをご覧ください。「 トリガーの制限事項」をご覧ください。