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

一連のトリガー定義を再利用可能なトリガーとして保存し、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 スポーク
• Microsoft Azure DevOps Boards スポーク

イベントソースの作成の詳細については、「 外部イベントソースの作成」を参照してください。

重要:

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

手順

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

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

   フィールド	説明
   トリガー名	トリガーを識別する名前です。
   トリガータイプ	フローを開始するトリガーのタイプ。[外部] で、[ イベント (Webhook)] を選択します。
   説明	トリガーの説明。
   アプリケーション	トリガーを作成するアプリケーションスコープ。 ワークフロースタジオ には、サポートされている構成済みのスポークが表示されます。
   イベントソース	イベントを ServiceNow に送信するサードパーティシステム。
   ドメイン	フローのドメインスコープ。ドメインセパレーションの詳細については、「Domain separation explained」を参照してください。

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

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

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

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

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

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

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

    トリガーが公開されると、 出力 ラベル フィールドのみを編集できます。