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

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

このタスクについて

ワークフロースタジオで既に構成されていて、サポートされているサードパーティスポークで発生するイベントに応答する保存済みトリガーを作成します。イベントが発生すると、サードパーティのスポークはイベントペイロードを ワークフロースタジオに送信します。

トリガー定義では、次の項目を指定します。

• JSON 形式のイベントペイロード構造
• トリガーがいつ開始されるかを決定する条件

構成したサードパーティスポークからイベントペイロード JSON を取得します。

始める前に

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

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

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

• ServiceNow 統合ハブ外部トリガー [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. Workflow Studio のホームページから、 新規 > トリガー.
3. フォームで、フィールドに入力します。

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

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

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

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

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

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

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

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

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

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

タスクの結果

トリガーが作成され、公開されます。トリガーはどのフローでも使用できます。フローへのトリガーの追加については、「 保存されたトリガーを使用」を参照してください。

• 外部イベントソースの管理
  ServiceNow外のアプリケーションで発生するイベントをリッスンするスポークまたはスコープ対象アプリケーションの外部イベントソースを作成および管理します。次に、外部トリガー定義を作成し、外部イベントソースに関連付けることができます。外部トリガー定義で指定したイベントが発生すると、 ServiceNow インスタンスで 1 つ以上のフローが開始されます。