従業員または訪問者の健康データの取得

リリースバージョン: Australia

更新日 2026年03月12日

所要時間：4分

GET 要求を送信従業員の安全衛生状況します。データを取得して、従業員または訪問者の現在の健全性ステータスを判定します。

始める前に

必要なロール：sn_imt_core.reader

手順

インスタンスのテーブル API に GET 要求を送信します。

詳細については、「テーブル API」を参照してください。

衛生安全ユーザー [sn_imt_core_health_and_safety_user] テーブルを使用して、エンドポイントをビルドします。
```
https://<your-instance>.servicenow.com/api/now/table/sn_imt_core_health_and_safety_user
```
特定のユーザーのメールアドレスを照会するためのクエリパラメーターを追加します。
API Explorer では、次のいずれかの文字列を [sysparm_query] フィールドに入力して、正しいクエリパラメーターを含むエンドポイントを生成できます。
- user.email=<user-email-address>：指定された従業員のメールアドレスを照会します。
- visitor.email=<visitor-email-address>：指定された訪問者のメールアドレスを照会します。

この例の cURL 要求では、衛生安全ユーザーテーブルを照会し、Abel Tuter のメールアドレスに関連付けられたレコードを返します。

curl "http://<your-instance>.servicenow.com/api/now/table/sn_imt_core_health_and_safety_user?sysparm_query=user.email%3Dabel.tuter%40example.com&sysparm_limit=1" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

タスクの結果

従業員の安全衛生状況アプリケーションは、この要求でメールアドレスに関連付けられた衛生安全ユーザーレコードを返します。JSON ペイロードには、次のデータが含まれています。

{
  "result": [
    {
      "sys_mod_count": "0",
      "sys_updated_on": "2020-07-14 19:58:00",
      "sys_tags": "",
      "type": "employee",
      "sys_id": "33f184491bce9010e3730e16ec4bcb71",
      "sys_updated_by": "system.administrator",
      "manually_created": "true",
      "sys_created_on": "2020-07-14 19:58:00",
      "sys_domain": {
        "link": "https://<my-instance>.servicenow.com/api/now/table/sys_user_group/global",
        "value": "global"
      },
      "requirements_status": "cleared",
      "visitor": "",
      "user": {
        "link": "https://<my-instance>.servicenow.com/api/now/table/sys_user/62826bf03710200044e0bfc8bcbe5df1",
        "value": "62826bf03710200044e0bfc8bcbe5df1"
      },
      "sys_created_by": "system.administrator"
    }
  ]
}

すべてのフィールドは、次のものを除いて社内用です。


プロパティ	説明
requirements_status	訪問者または従業員が職場に戻るためのすべての要件を完了したかどうかを示す。詳細については、「衛生安全ユーザーレコードを作成する」と「衛生安全要件を作成する」を参照。完了 (Cleared)：訪問者または従業員は職場に戻るためのすべての要件を満たしている。未完了 (Not Cleared)：訪問者または従業員は職場に戻るためのすべての要件を満たしていない。データタイプ：文字列
visitor	存在する場合、このレコードは従業員ではなく訪問者を示す。注: 訪問者の健全性データを返すときにのみ使用されます。データタイプ: オブジェクト
visitor.link	インスタンスの訪問者レコードへのリンク。注: 訪問者の健全性データを返すときにのみ使用されます。データタイプ：文字列
visitor.value	訪問者レコードの Sys_id。注: 訪問者の健全性データを返すときにのみ使用されます。データタイプ：文字列
ユーザー	存在する場合は、このレコードは訪問者ではなく従業員を示す。注: 従業員の健康データを返すときにのみ使用されます。データタイプ: オブジェクト
user.link	インスタンスのユーザーレコードへのリンク。注: 従業員の健康データを返すときにのみ使用されます。データタイプ：文字列
user.value	ユーザーレコードの Sys_id。注: 従業員の健康データを返すときにのみ使用されます。データタイプ：文字列