トリガー

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

前提条件

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

• Integration Service はテナントに対して有効化され、プロビジョニングされている。
• [Integration Service] の画面内に [トリガー] タブが表示されている。
• Orchestrator インスタンスで Unattended または NonProduction ロボットが設定済みである。

• モダン フォルダーを使用している (クラシック フォルダー内のプロセスは、トリガーを定義するときに表示されない)

手記： トリガーはモダン フォルダーでのみサポートされています。 クラシック フォルダーは、モダン ユーザー ID のパラダイムをサポートしていません。そのため、コネクション全般やトリガーをサポートできません。

プロセスを作成する

通常どおりに UiPath® Studio でプロセスを作成します。 Integration Service を使用すると、あらゆるプロセスに対して任意のオートメーションをトリガーできます。

レコードの詳細を受信するには、次の手順に従います。

• ワークフローでプロセスを実際にトリガーした、コネクタ、イベント、レコードの種類、またはレコードを確認する場合は、プロセス内で以下の String 型の入力引数を定義します。

  Integration Service が、ジョブの開始時にこれらの引数を自動的に設定します。

  • UiPathEventConnector
  • UiPathEvent
  • UiPathEventObjectType
  • UiPathEventObjectId
    注: 引数の動作と管理方法の詳細については、こちらをご覧ください。
• ジョブの実行時に、トリガーが設定されたレコードを取得・操作するには、 UiPathEventObjectId 入力引数を使用してソース システムからレコードを取得します。

以下に、Integration Service がどのように入力引数値を渡しているか、例を示します。

プロセスをパブリッシュする

通常どおりに、プロセスを Orchestrator にパブリッシュします。 共有フォルダーまたは個人用ワークスペースにパブリッシュできます。 必ず、パッケージからプロセスを作成してください。

トリガーを設定する

トリガーを追加するには、次の手順に従います。

1. Automation Cloud^TM にアクセスします。
2. 左のメニューから [ Integration Service] を選択します。 [Integration Service] のウィンドウには、[コネクタ]、[コネクション]、[トリガー] の 3 つのタブがあります。
3. [ トリガー] タブにアクセスし、[ トリガーを追加 ] ボタンを選択します。
4. それぞれのドロップダウン メニューから、目的の コネクタ と コネクション を選択します。選択した特定のコネクタに対して構成されたコネクションが 1 つしかない場合は、そのコネクションが自動的に選択されます。

5. それぞれのドロップダウン メニューから、目的のイベントとレコードを選択します。

   注: イベントの種類はコネクタによって異なります。
6. 右側で、 実行するプロセスを選択します。

7. ドロップダウンからランタイム ライセンス (トリガーによって起動されるジョブの実行に使用されるランタイム) を選択します。利用可能なオプションは次の通りです。 NonProduction、Unattended、Headless、TestAutomation、AutomationCloud、Serverless、Development

   • 表示されるランタイムのリストは、Orchestrator から受け取った応答、すなわちそのフォルダーに対して「割り当てられた」ランタイム ライセンスに基づきます。選択したランタイムに対して、割り当てられているランタイムの数を示すメッセージが表示されます。
   • 詳細については、『 UiPath Orchestrator ガイド』の「トリガーを管理する 」ページと『概要ガイド』の「 サービス ライセンス」ページの「ランタイム (ロボット ライセンス)」セクションをご覧ください 。
8. [ トリガーを追加] ボタンを選択してトリガーを作成し、アクティブ化します。

または、[コネクション] タブから新しいトリガーを作成できます。そのためには、次の手順に従います。

1. コネクションの [ その他のアクション ] ボタンを選択します。
2. [トリガーを追加] オプションを選択します。
3. それぞれのドロップダウン メニューから、目的のイベントとレコードの種類を選択します。この場合、 コネクタ と コネクション は既に選択されており、変更できません。
4. 右側で、 [実行するプロセス]と、それぞれの [ランタイム ライセンス] を選択します。

5. [ トリガーを追加] ボタンを選択してトリガーを作成し、アクティブ化します。

注:

現在、イベントの監視は 5 分ごとにポーリングするように設定されています。そのため、関連するプロセスが開始されるまでに最大で 5 分かかる場合があります。

ジョブの詳細は、Orchestrator フォルダーの [ジョブ] タブで確認できます。Integration Service から開始したジョブの場合、[Integration Serviceトリガー] がソースとして表示されます。

イベント

コネクタはポーリング メカニズムを通じてイベントをサポートしています。コネクタ カタログ内のほとんどのコネクタにおいて同様にサポートされます。

Integration Service では、以下の 2 種類のイベントがサポートされています。

1. ジェネリック。一般的な作成、更新、削除操作を表します。 汎用イベントを選択する場合は、モニターするイベント・レコードも定義する必要があります。 たとえば、 カレンダー レコードの場合は レコードの作成時 です。

2. 特定のオブジェクトに対する特定のアクションを表す、定義済みです。 (例 : カレンダーの予定の作成時)。

イベントの詳細については、各コネクタのページをご覧ください。

データ フィルター

トリガーのイベントを定義する際は、さらに細かくフィルター処理設定を追加できます。

[データ フィルター] を使用すると、特定のデータ パターンに一致するトリガーを設定できます。つまり、ロボットの起動回数が減るとともに、オートメーション内に追加のフィルター処理を適用する必要がなくなります。

ポーリング間隔

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

この間隔は、ポーリング間隔を調整する機能を使用してカスタマイズできます。これにより、イベント トリガーが新しいオブジェクト イベントを確認する間隔を選択できます。

重要: コネクションには複数のトリガーを設定できますが、コネクションごとに設定できるポーリング間隔は 1 つのみです。ポーリング間隔を変更すると、コネクションに関連するすべてのトリガーに影響が出ます。

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

ポーリング間隔を変更する

ポーリング間隔は、特定のコネクタのページまたは [ 接続 ] タブから変更できます。

1. Automation Cloud^TM で Integration Service にアクセスします。
2. [コネクタ] ページに移動し、コネクタを選択します。
3. コネクタのページでコネクションを選択して、コネクションの詳細ページを開きます。

4. 次のように、接続名の下にある間隔を選択します。 ポーリング間隔は、トリガーが追加された接続に対してのみ表示されます。

   
   

   

   
   

あるいは、[コネクション] タブからポーリング間隔を設定できます。

1. Integration Service で [コネクション] タブに移動します。
2. 特定のコネクションを選択して、コネクションの詳細ページを開きます。
3. コネクション名の下にある間隔を選択します。
4. [ポーリング間隔を更新] ウィンドウが表示されます。

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

   
   

   

   
   

   誤った値を入力すると、「ポーリング間隔は 1 から 1440 分または 24 時間の自然数でなければなりません」という警告メッセージが表示されます。

6. [ 更新間隔] を選択します。

トリガーの実行履歴

トリガーの実行履歴は、[トリガー] タブでトリガーを選択するだけで表示 できます 。 新しいページでは、 答案の履歴 がインターフェイスの下部に表示されます。

この履歴には、Integration Service が受信したイベントと、プロセスが正常に開始されたかどうかが表示されます。正常に開始した場合、[ステート] 列に [成功] と表示されます。

注: [成功] ステートは、ジョブが正常に起動されたことを示します。ジョブが最後まで正常に実行されたかどうかを反映するものではありません。

重要: ジョブの開始に失敗した場合、[ステート] には [失敗] と表示されます。[失敗] ステートの上にマウス カーソルを置くと、エラー メッセージが表示されます。

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

トリガーを削除する

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

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

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

1. [トリガー] タブを開きます。

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

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

トリガーの詳細表示

トリガーを選択して詳細を表示します。

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

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

制限事項

このセクションでは、Integration Service のトリガーの既知の制限事項を示します。

最大レコード制限

説明

現在、Integration Service のトリガーでは、1 回のトリガーの実行あたりのレコード数の上限が 1,000 件です。 トリガーが設定された時間間隔 (たとえば、1 分や 5 分) 内に 1,000 件を超えるレコードを取得しようとして、ベンダーのシステムがこの制限を超えるレコードを出力した場合、しきい値を超えるレコードはキャプチャされず、失われる可能性があります。

影響

この制限は、トリガーがすべてのレコードを取得できない可能性があるため、大きなデータセットを処理する必要があるワークフローやオートメーションに影響を与える可能性があります。

回避策

私たちは、この制約に対処するために積極的に取り組んでいます。 それまでは、影響を最小限に抑えるために、「 ポーリング間隔」で説明されているように、トリガー間隔を可能な限り短い期間に構成できます。 トリガーの実行頻度を増やすと、複数のトリガー実行ですべてのレコードが確実にキャプチャされます。

トリガーを自動的に無効化する

新規または更新されたイベントのポーリング中に、サードパーティ アプリケーションの問題が原因でトリガーで 100 回連続したエラーが発生すると、トリガーは自動的に無効化されます。 このメカニズムは、システムの安定性を維持するのに役立ちます。

いずれかのトリガーが無効化されると、メール通知が届きます。 エラーの原因となっている根本的な問題を修正した後に、トリガーを手動で再度有効化する必要があります。

トリガーを編集する

現在、既存のトリガーの編集はサポートされていません。 トリガー管理のオプションは、トリガーの作成または削除のみです。 必要な変更を行うには、既存のトリガーを削除し、新しいトリガーを追加する必要があります。