エントリ更新の要求の登録

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：4分

    • Webhook を構成することで、各従業員健康診断エントリー要求の結果をサードパーティシステムに送信します。

    始める前に

    発信 webhook コールを送信するには、次のプラグインが必要です。
    • ServiceNow 統合ハブ ランタイム (com.glide.hub.integration.runtime)
    • ワークフロースタジオ アクションステップ - ペイロードビルダー (com.glide.hub.action_step.payload)
    • ServiceNow 統合ハブ アクションステップ - REST (com.glide.hub.action_step.rest)
    これらのプラグインは、Now Support サービスカタログ 経由で要求する必要があります。手順については、「プラグインの要求」を参照してください。
    Webhook を設定すると、従業員または訪問者がエントリを要求するたびに、システムによってサードパーティのエンドポイントに REST 要求が自動的に送信されます。サードパーティシステムのアドミニストレーターと協力して、提供する正しいエンドポイントを決定します。
    注:
    Webhook では、要求に認証ヘッダーが含まれていません。要求を認証するためのクエリーパラメーターを含むエンドポイントを提供していることを確認してください。

    従業員健康診断 のエントリ要求モジュールの詳細については、「入場のための健康診断を実施」を参照してください。

    必要なロール：sn_imt_core.admin または admin

    手順

    1. 移動先 すべて > 従業員の安全衛生状況 > 送信 Webhook.
    2. Webhook [sn_imt_core_webhook] テーブルで、[新規] をクリックします。
    3. フォームのフィールドに入力します。
      表 : 1. Webhook フォーム
      フィールド 説明
      名前 サードパーティエンドポイントの内部識別子。
      イベント 登録するイベント。次のオプションが含まれます。
      • 従業員によるエントリ要求：従業員がエントリを要求するたびに更新を送信します。
      • 訪問者によるエントリ要求：訪問者がエントリを要求するたびに更新を送信します。
      エンドポイント 従業員健康診断 のエントリ要求データを送信するエンドポイント。
      注:
      Webhook では、要求に認証ヘッダーが含まれていません。要求を認証するためのクエリーパラメーターを含むエンドポイントを提供していることを確認してください。
      セキュアなパラメーター 認証トークンなど、安全に処理する必要があるエンドポイントのクエリパラメーター。パラメーターを ?param1=value&param2=othervalue の形式で指定します。
      ヒント:
      データの送信先であるサードパーティシステムで安全に生成された認証トークンを提供しない場合は、次のスクリプトを使用して ServiceNow インスタンスでトークンを生成できます。 
      var secureRandom = GlideSecureRandomUtil;
var secret = secureRandom.getSecureRandomString(30);
gs.log(secret);
      有効 レコードをアクティブに設定するオプション。
    4. [送信] をクリックします。

    タスクの結果

    従業員健康診断 アプリケーションは、従業員がエントリを要求するたびに、サードパーティのエンドポイントに要求エントリデータを送信します。JSON ペイロードには、次のデータが含まれています。 
    {
  "event": "entry.requested",
  "email": "aileen.mottern@example.com",
  "username": "aileen.mottern",
  "user_id": "a8f98bb0eb32010045e1a5115206fe3a",
  "location": "San Antonio",
  "location_id": "108486c7c611227500b093211aa88dcc",
  "access_granted": false,
  "updated": "2020-07-01 22:19:03"
}
    プロパティ 説明
    イベント Webhook テーブルで定義されたイベントのタイプ。

    データタイプ：文字列
    メール 従業員のメールアドレス。

    データタイプ：文字列
    ユーザー名 Health and Safety ユーザー [sn_imt_core_health_and_safety_user] テーブルからの従業員のユーザー名。

    データタイプ：文字列
    user_id Health and Safety ユーザー [sn_imt_core_health_and_safety_user] テーブルからのユーザーレコードの Sys_id。

    データタイプ：文字列
    location 健康診断の場所です。

    データタイプ：文字列
    location_id 場所テーブル [cmn_location] の場所レコードの Sys_id です。

    データタイプ：文字列
    access_granted 健康診断の結果、従業員にアクセス権が付与されたかどうかを示すフラグです。有効な値：
    • true：従業員は健康診断に合格し、アクセス権を付与されました。
    • false：従業員は健康診断に合格できず、アクセス権は付与されませんでした。

    データタイプ：ブーリアン
    updated 従業員または訪問者がエントリを要求した日時です。

    データタイプ：日付/時間