トリガー

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

Orchestrator のトリガー

重要:

2025 年 4 月下旬より、新しい Integration Service のトリガーは Orchestrator でのみ作成できるようになります。

Orchestrator で作成されたトリガーは、Integration Service の [ トリガー ] タブに表示されません。既存の Integration Service のトリガーは、2025 年 7 月 31 日まで (この日付は延長される場合があります) は引き続き実行され、[Integration Service の トリガー ] タブに表示されます。この日以降、既存の Integration Service のトリガーは Orchestrator に移行され、Integration Service の [ トリガー ] タブは削除されます。

この変更は、まず Community ユーザーに対して利用可能になる予定です。その後、組織とテナントのリージョンに応じて段階的に Enterprise ユーザーに対して利用可能になる予定です。変更が最初に発表された日時については、 Integration Service のリリース ノート をご覧ください。

Orchestrator のトリガーがもたらす主な利点

Integration Service のトリガーを Orchestrator に移行することは大きな変更ですが、多くのメリットがあります。このアップデートを推進する主な理由は次のとおりです。

1. アカウントとマシンのマッピング: Orchestrator では、Integration Service によってトリガーされるプロセスをマシンレベルで制御できます。
2. Bot 固有のプロセス実行制御: Orchestrator では、複数の Bot が割り当てられているフォルダー内で、どのロボットがプロセスを実行するかを指定できます。これにより、トリガーされたプロセスを実行する Bot を正確に制御でき、単一の Bot フォルダーなどの回避策が不要になり、実行制御を失うことなく複数の Bot を許可することでスケーラビリティが向上します。
3. 入力引数と動的なプロセス割り当て: Orchestrator では動的な入力引数が使用可能であり、アクティブなプロセス インスタンスの最大数を定義できます。これにより、動的な引数を使用できるようにしてプロセスの重複を減らし、アクティブなプロセスを制限してリソース使用量を最適化し、要求を順次管理するプロセスの効率を向上させます。
4. 長期実行プロセスの管理の改善: Orchestrator で作成されるトリガーには [停止までの時間] と [強制終了までの時間] オプションがサポートされており、指定した期間または条件の後にプロセスを自動的に終了できます。これにより、実行時間の長いプロセスを終了してリソースの過剰使用を防ぎ、応答しないワークフローを停止してタイムリーに実行できるようにします。
5. 編集機能: Orchestrator では既存のトリガーを編集できます。
6. 統合トリガー エクスペリエンス: すべての種類のトリガーを 1 か所で作成および管理できます。
7. 単一のトリガー ビュー: トリガーの作成を Orchestrator に移行すると、Integration Service ベースのすべてのトリガーで 1 つのビューが保持されます。Integration Service ベースのトリガーは、Integration Service から特定のコネクタのトリガーを作成する方法と、Studio からトリガー アクティビティを使用してオートメーションを開始する方法の 2 つの方法で作成できるようになりました。2 つのトリガーで表示される構成情報は、同じイベントをキャプチャしていても若干異なる場合があります。

概要

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

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

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

前提条件

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

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

トリガーを作成する

切断されたイベント トリガーは、Orchestrator から直接作成します。詳しくは、『Orchestrator ユーザー ガイド』の「 イベント トリガー 」セクションをご覧ください。

Orchestrator では、これらのトリガーを直接管理できます。Integration Service では、トリガーを変更するための唯一の選択肢はポーリング間隔を調整することです。ポーリング間隔はコネクション レベルで設定されます。

ポーリング間隔の更新

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

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

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

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

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

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

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

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

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

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

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

大事な：答案の履歴テーブルは、Integration Service で作成され、[トリガー] タブにリストされているトリガーでのみ使用できます。Orchestrator で作成されたトリガーでは、答案の履歴は利用できません。

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

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

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

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

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

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

トリガーを管理する

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

Orchestrator で直接作成したトリガーは、Orchestrator から管理できます。

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

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

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

制限事項

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