保存済み外部トリガーの作成

一連のトリガー定義を、Webhook を介して外部イベントに応答する再利用可能なトリガーとして保存します。指定された条件を満たす構成済みのサードパーティアプリケーションでイベントが発生すると、トリガーが有効になります。

このタスクについて

ワークフロースタジオで既に構成されていて、サポートされているサードパーティスポークで発生するイベントに応答する保存済みトリガーを作成します。サードパーティスポークは、イベントが発生するたびにイベントペイロードをワークフロースタジオに送信します。トリガー定義で、JSON 形式のイベントペイロードとトリガーを開始する条件を指定します。構成したサードパーティスポークからイベントペイロード JSON を取得します。

始める前に

必要なロール：trigger_designer、flow_designer、または admin

サブスクリプションが必要：このステップには、統合ハブのサブスクリプションが必要です。

必要なプラグイン：次の統合ハブプラグインをインストールします。

• ServiceNow 統合ハブ外部トリガー [com.glide.ih.external_trigger]：すぐに利用可能な外部トリガーを使用する場合。

• 外部トリガービルダー [sn_ext_trg_bldr]：保存済み外部トリガーを作成する場合。

注:

さまざまな統合ハブサブスクリプションに含まれるものの詳細については、「法務スケジュール - 統合ハブの概要」を参照してください。

サードパーティアプリケーションスポークの外部トリガーエンドポイントが構成されていることを確認します。サポートされているスポークは次のとおりです。

• Jira スポーク
• GitHub スポーク
• Docusign eSignature スポーク

サードパーティスポークの構成の詳細については、「Set up external trigger endpoints」を参照してください。

重要:

サードパーティアプリケーションのイベントペイロード JSON を手元に用意します。ペイロード JSON をコピーできる場所については、サードパーティの Webhook ドキュメントを参照してください。たとえば、Jira イベントのさまざまなペイロードの形状を示す次のリンク：Executing a webhook (Webhook の実行) を参照してください。

手順

1. 移動先 すべて > プロセスの自動化 > ワークフロースタジオ.
2. Workflow Studio のホームページから、 新規 > トリガー.
3. フォームで、フィールドに入力します。

   表 : 1. [新しいトリガー (New Trigger)] フォーム

   フィールド	説明
   トリガー名	トリガーを識別する名前です。
   トリガータイプ	フローを開始するトリガーのタイプ。[外部 (External)] の [イベント (Webhook) (Event (Webhook))] を選択します。
   説明	トリガーの説明。
   アプリケーション	トリガーを作成するアプリケーションスコープ。 ワークフロースタジオに、サポートされている構成済みのスポークが表示されます。

4. [追加のプロパティを表示する] を選択し、フィールドに入力します。

   表 : 2. [追加のプロパティ (Additional properties)] フォーム

   フィールド	説明
   次からアクセス可能	トリガーデータには、すべてのアプリケーションスコープからアクセスできます。
   カテゴリ	トリガーが表示されるカテゴリ。
   トリガーの注釈	ユーザーがトリガーを選択する前に確認できるトリガーの注釈。

5. [トリガーのビルド (Build trigger)] を選択します。
   ワークフロースタジオにトリガー定義のページが表示されます。[イベントソースのプレビュー (Event source preview)] 領域には、外部トリガーエンドポイントの構成方法に関する情報が表示されます。
6. [パーサー] でフィールドに入力します。

   表 : 3. [パーサー] フォーム

   フィールド	説明
   トリガー出力名	トリガー出力を識別するためのラベル。
   要求ヘッダー	受信要求に含める 1 つ以上のヘッダーを指定するオプションのフィールド。
   クエリパラメーター	受信要求に含める 1 つ以上のパラメーターを指定するオプションのフィールド。

7. JSON エディターの [本文] で、サードパーティアプリケーションからのペイロード JSON を貼り付けます。
   ペイロード JSON をコピーできる場所については、サードパーティの Webhook ドキュメントを参照してください。
8. [オブジェクトの可視化 (Visualize objects)] を選択します。
   エディターに、ペイロード JSON にあるオブジェクトが表示されます。オブジェクトを並べ替えたり、削除したりできます。オブジェクトは、条件で使用するデータピルとして利用できます。 を選択した後のオブジェクトを表示します。
9. 条件エディターで、データピルをドラッグアンドドロップして条件セットを作成します。
   [or] または [and] 演算子を使用して、条件セットに条件を追加します。
10. 要件に従って条件セットを追加するには、[+ 新しい条件セット (+New condition set)] を選択します。
11. 他のユーザーがトリガーを使用できるようにするには、[公開] を選択します。
    注:

    保存済みの外部トリガーを公開後に編集することはできません。