トリガー

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

概要

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

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

注:

トリガーはコネクションによって異なります。コネクションを削除すると、関連付けられているトリガーもすべて削除されます。

前提条件

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

• Integration Service is enabled and provisioned for your tenant.
• You have already set up an Unattended or Non-production Robot in your Orchestrator instance.
• モダン フォルダーを使用している (クラシック フォルダー内のプロセスは、トリガーを定義するときに表示されない)
• Users who work with triggers have the necessary permissions in Orchestrator. To create a trigger, a user must have the Triggers - Create permission in the target folder. For more information on permissions, see Configuring access for accounts in the Orchestrator user guide.

How triggers work

Polling-based triggers such as Record Created or Incident Created are available for multiple UiPath connectors. This type of trigger detects new records by using a polling mechanism against the target application's public APIs.

The triggers operate as follows:

1. Polling interval - Integration Service polls the target system at a set interval (by default every five minutes). The polling interval is set at connection level, therefore changing the polling interval affects all the triggers associated with that connection.

2. API-based detection - During each polling cycle, Integration Service queries the relevant object/table using the vendor's standard REST APIs.

3. Incremental record identification - New records are identified using API query parameters, most commonly based on:

   • Record creation timestamp (for example, sys_created_on)
   • In some scenarios, modification timestamps

   Integration Service stores the most recent creation timestamp (or equivalent marker) from the last successful polling cycle. On the next poll, the query resumes from that stored value, ensuring continuity and preventing duplicate processing.

   For example, a query to poll for new incidents in ServiceNow could look as follows: GET https://{instance}.service-now.com/api/now/v1/table/incident?sysparm_query=sys_created_on>={last_max_created_date}

   注:

   Additional parameters such as pagination, limits, offsets, or field expansion may be included to support filtering and data shaping. These do not change the core polling logic.

ポーリング間隔の更新

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

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

The polling interval is set at connection level. This means you can have only one polling interval per connection, even though you create several triggers per connection. Changing the polling interval affects all the triggers associated with a connection.

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

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

1. Integration Service で [ コネクション ] タブに移動します。
2. 特定の接続を選択して、接続の詳細ページを開きます。ポーリング間隔は、トリガーが追加されたコネクションに対してのみ表示されます。
3. [ ポーリング間隔を更新 ] ウィンドウを開く時間間隔を選択します。
4. 利用可能なオプションの 1 つを選択するか、カスタム間隔 (分単位または時間単位) を設定できます。ポーリング間隔は 1 分を超え、24 時間または 1440 分以下である必要があります。
5. [ 更新して確認] を選択します。

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

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

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

Attemptsの履歴表には、次の情報が表示されます。

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

注:

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

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

トリガーを管理する

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

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

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

1. [トリガー] タブを開きます。
2. 変更するトリガーの名前の上にマウス カーソルを置きます。[編集] ボタンが表示されます。

または、リストからトリガーを選択して詳細を表示することもできます。[編集] ボタンはトリガー名の右側にあります。3. [編集 ] ボタンを選択すると、トリガーの新しい名前を選択できます

トリガーを削除する

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

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

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

イベントの引数

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

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

• UiPathEventConnector - オートメーションを開始したコネクタを特定します。
• UiPathEvent - 発生したイベントの種類を特定します。
• UiPathEventObjectType - イベントによって生成される特定のレコードの種類を定義します。
• UiPathEventObjectId - Provides the unique identifier for the object involved in the event.

注:

This applies only to disconnected triggers. For connected triggers, you should have the entire object already available when you design your process.

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

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

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

トリガー固有の出力

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

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

よくある質問

If a connection breaks, what happens to the triggers associated with that connection?

If a connection becomes disconnected, the associated triggers will temporarily stop running. Once the connection is reconnected successfully, the triggers will automatically resume execution. As an additional step, make sure the trigger is not in a disabled state.

For disconnected triggers, how can I associate the trigger output with my process?

See the Event arguments section for details on how to retrieve data regarding the connector and the event that triggers a process.

Using the UiPathEventObjectId argument, you can add a Get Record or HTTP activity call in your process to fetch the corresponding record data.

注:

This applies only to disconnected triggers. For connected triggers, you should have the entire object already available when you design your process.

How can I change the polling interval for my trigger?

You can modify the polling interval directly from the trigger configuration. Refer to this guide for detailed steps: Updating the Polling Interval.

Can I filter which records trigger my automation?

Yes. You can add Data filters (for connectors that support it) to control which records ultimately kick off your process.

注:

Filters are applied after the records are fetched by Integration Service.

例:

• Create a filter in Studio Web:

  

• Create a filter in Orchestrator:

  

Why is my trigger not firing immediately?

Trigger execution timing can vary depending on the trigger type, data volume, and robot availability.

For polling-based triggers:

• The trigger fetches new or updated records based on the polling interval configured in Integration Service.

• Depending on the volume of data retrieved, Integration Service applies any defined filters or trigger conditions before passing qualifying events to Orchestrator.

• This processing can introduce minor latency, especially when handling large datasets or complex filters.

• After the events are handed over to Orchestrator, the automation starts only if an unattended robot is available at that moment.

• If the polling interval is set too long, a large volume of data may be retrieved at once, potentially slowing down your process. In such cases, consider reducing the interval to improve performance.

  注:

  If your trigger appears delayed, check your polling interval, review filters for efficiency, and ensure that an unattended robot is available to execute the job.

For webhook-based triggers (e.g., HTTP Webhook):

• Webhook triggers are designed to fire almost instantly, as events are sent directly by the external application to Integration Service.
• Since webhooks typically handle one record per transaction, latency is minimal.
• However, if trigger filters or processing logic are applied before the event is handed off to Orchestrator, you may still observe a small delay.

How do I troubleshoot a trigger that's not firing?

• Verify that the associated connection is active.
• Check that the trigger is enabled.
• Verify whether your connection requires a specific scope or role to access the target API endpoint that is being polled.
• Confirm that the filter matches expected data.
• For webhook triggers, confirm the webhook registration is valid on the external application.

When does a trigger pick up records for the first time?

The first run of a trigger begins from the time the trigger is created.

Records created before the trigger was created are not picked up and all records created/updated after the trigger creation timestamp are eligible for processing according to the trigger's filters.

制限事項

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