保存された外部トリガーを作成する

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

このタスクについて

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

始める前に

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

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

必要なプラグイン:次の Integration Hub プラグインをインストールします。

• ServiceNow Integration Hub 外部トリガー [com.glide.ih.external_trigger]:すぐに利用可能な外部トリガーを使用します。

• 外部トリガービルダー [sn_ext_trg_bldr]:保存された外部トリガーを作成します。

注:

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

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

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

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

重要:

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

手順

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

   表 : 1. 新しいトリガーフォーム

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

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

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

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

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

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

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

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

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