外部イベントソースの管理

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：7分

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

    始める前に

    必要なロール:trigger_designer (外部イベントソースの作成、読み取り、更新、または削除が可能) および trigger_designer_read (trigger_designer ロールが作成する外部イベントソースに対して読み取り専用操作を実行できます)。

    External Trigger Builder プラグインがインスタンスにインストールされていることを確認します。External Trigger Builder v1.0.3 が利用可能な最新バージョンです。

    このタスクについて

    外部イベントソースは、ServiceNow外部のシステムまたはアプリケーションをリッスンする ServiceNow インスタンスのエンドポイントです。ServiceNow外部のアプリケーションがイベントを外部イベントソースに送信すると、トリガー定義で 1 つ以上のフローを開始できます。たとえば、定義した外部トリガー定義と通信する問題追跡ソフトウェアの外部イベントソースを定義します。外部トリガー定義は、問題追跡ソフトウェアで新しい問題が作成されると、イベントソースをリッスンし、フローを開始します。外部イベントソースとトリガー定義の両方が ServiceNow インスタンスで定義されています。外部トリガー定義は、フローを開始するタイミングを ServiceNow インスタンスに指示する一連の条件を提供します。

    外部イベントソースの作成

    ServiceNow外部のアプリケーションまたはシステムで発生するイベントをリッスンするスポークまたはスコープ対象のアプリケーションの外部イベントソースを作成します。外部イベントソースに基づいて、外部イベントソースからの通信を受信し、 ServiceNow インスタンスでフローを開始する外部トリガー定義を作成できます。

    始める前に

    必要なロール:trigger_designer (外部イベントソースの作成、読み取り、更新、または削除が可能) および trigger_designer_read (trigger_designer ロールが作成する外部イベントソースに対して読み取り専用操作を実行できます)。

    External Trigger Builder プラグインがインスタンスにインストールされていることを確認します。

    手順

    1. 移動先 すべて > プロセス自動化 > ワークフロースタジオ.
    2. [統合] タブをクリックします。
    3. スポークをクリックします。
      [ スポーク] タブはデフォルトで選択されています。まだ選択されていない場合は、選択したことを確認します。

      外部イベントソース作成用のスポークの選択。

    4. 左側のパネルで、[イベントソース] をクリックします。
      [イベントソース] メニュー。
    5. [ Create event source] をクリックします。
    6. [イベントソース名] フィールドで、外部イベントソースに一意の名前を付けます。
    7. オプション: [説明] フィールドに、外部イベントソースの説明を入力します。
      [外部イベントソースの作成 (Create external event source)] 画面。
    8. [ Create event source] をクリックします。
      外部イベントソースはドラフト状況で作成されます。
    9. オプション: ドラフトステータスの外部イベントソースを表示します。
      1. [スポーク] タブを選択します。
        [スポーク] タブがクリックされます。
      2. [ドラフト (Drafts)] タブを選択します。
        作成した外部イベントソースが表示されます。
        ヒント:
        外部イベントソースが表示されない場合は、ページを更新し、[ ドラフト ] タブを選択します。
    10. [認証] 見出しの下で、外部アプリケーションが ServiceNow インスタンスに送信する Webhook を認証する方法を選択します。
      次の認証方法を使用できます。
      • 基本
      • OAuth
      • ハッシュ
      • トークン
      ハッシュ認証またはトークン認証方法を選択する場合は、テーブルに表示される情報を指定する必要があります。
      表 : 1. 認証仕様
      認証手法 フィールド 説明
      基本 外部アプリケーションが送信するユーザー名とパスワードを認証することを指定するオプション。
      OAuth 外部アプリケーションからの Webhook を認証するために OAuth メカニズムを使用することを指定するオプション。
      ハッシュ 認証の場所 外部アプリケーションまたはシステムがメッセージを送信するときにハッシュを含める場所を指定するオプション。利用可能な場所は次のとおりです。
      • クエリパラメーター
      • ヘッダー
      パラメーター名 ハッシュを見つけることができるフィールドの名前を指定するオプション。
      ハッシュアルゴリズム ハッシュの計算に使用するアルゴリズムを指定するオプション。利用可能なアルゴリズムは次のとおりです。
      • HmacSHA256
      • HmacSHA384
      • HmacSHA512
      敬称 ハッシュの前に来る可能性のある値を指定するオプション。
      HMAC ユーティリティスクリプト ハッシュを生成または検証するスクリプトを指定するオプション。

      HMAC の詳細については、「 Configure HMAC - Token-based authentication」を参照してください。
      トークン 認証の場所 外部システムがメッセージを送信するときにトークンを含める場所を指定するオプション。利用可能な場所は次のとおりです。
      • クエリパラメーター
      • ヘッダー
      パラメーター名 トークンを見つけることができるフィールドの名前を指定するオプション。
      敬称 トークンの前に来る可能性のある値を指定するオプション。
    11. [公開] をクリックします。
      外部イベントソースは、外部トリガー定義に関連付けることができます。

      外部イベントソースが公開されました。

    12. オプション: 公開された外部イベントソースを表示します。
      1. [スポーク] タブを選択します。
        [スポーク] タブが選択されています。
      2. [ 公開済み] タブを選択します。
      公開した外部イベントソースが表示されます。
      ヒント:
      外部イベントソースが表示されない場合は、ページを更新して [ ドラフト ] タブを選択します。

    次のタスク

    保存された外部トリガーを作成する を作成し、作成した外部イベントソースに関連付けます。

    外部イベントソースの更新

    ドラフトまたは公開ステータスの外部イベントソースを更新します。

    始める前に

    必要なロール:trigger_designer (外部イベントソースの作成、読み取り、更新、または削除が可能) および trigger_designer_read (trigger_designer ロールが作成する外部イベントソースに対して読み取り専用操作を実行できます)。

    External Trigger Builder プラグインがインスタンスにインストールされていることを確認します。

    このタスクについて

    ドラフト状況の外部イベントソースのすべての情報を更新できますが、公開状況ではその名前と説明のみを更新できます。

    手順

    1. 移動先 すべて > プロセス自動化 > ワークフロースタジオ.
    2. [統合] タブをクリックします。
    3. 外部イベントソースが定義されているスポークをクリックします。
      [ スポーク] タブはデフォルトで選択されています。選択されていない場合は、選択したことを確認します。

      外部イベントソース作成用のスポークの選択。

    4. 左側のパネルで、[イベントソース] をクリックします。
      [イベントソース] メニュー。
    5. ドラフト状況のイベントソースを更新するには、次の手順を実行します。
      1. [ ドラフト ] タブをクリックします。
      2. 更新する外部イベントソースをクリックします。
      3. 省略記号ボタン ( 外部イベントソースを更新するための省略記号アイコン)をクリックし、[プロパティ] をクリックします。
      4. [イベントソースのプロパティ] フォームで、情報を更新します。
      5. [Update (更新)] をクリックします。
        外部イベントソースが更新されます。
    6. 公開済みステータスのイベントソースを更新するには、次の手順を実行します。
      1. [ 公開済み ] タブをクリックします。
      2. 更新する外部イベントソースをクリックします。
      3. 省略記号ボタン ( 外部イベントソースを更新するための省略記号アイコン)をクリックし、[プロパティ] をクリックします。
      4. イベントソースのプロパティフォームで、次のフィールドの情報を更新します。
        • イベントソース名
        • 説明
      5. [Update (更新)] をクリックします。
        外部イベントソースが更新されます。

    外部イベントソースの削除

    外部トリガー定義に関連付けられていないドラフトまたは公開ステータスの外部イベントソースを削除します。

    始める前に

    必要なロール:trigger_designer (外部イベントソースの作成、読み取り、更新、または削除が可能) および trigger_designer_read (trigger_designer ロールが作成する外部イベントソースに対して読み取り専用操作を実行できます)。

    External Trigger Builder プラグインがインスタンスにインストールされていることを確認します。

    手順

    1. 移動先 すべて > プロセス自動化 > ワークフロースタジオ.
    2. [統合] タブをクリックします。
    3. 外部イベントソースが定義されているスポークをクリックします。
      [ スポーク] タブはデフォルトで選択されています。選択されていない場合は、選択したことを確認します。

      外部イベントソース作成用のスポークの選択。

    4. 左側のパネルで、[イベントソース] をクリックします。
      [イベントソース] メニュー。
    5. [ 公開済み ] または [ ドラフト ] タブをクリックします。
    6. 削除する外部イベントソースをクリックします。
    7. 省略記号ボタン ( 外部イベントソースを更新するための省略記号アイコン)をクリックし、[プロパティ] を選択します。
    8. [削除] をクリックします。
    9. [イベントソースを削除] ダイアログで、[ 削除] をクリックします。
      外部イベントソースが削除されます。
      注:
      1 つ以上の外部トリガーが関連付けられている外部イベントソースは削除できません。