---
sourceDocument: Yokohama 従業員サービス管理 (ESM)
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/employee-service-management

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama 従業員サービス管理 (ESM)

ft:clusterId :

    - emplsm

bundleId :

    - emplsm

workflow :

    - Employee


---

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

# 従業員または訪問者の健康データの取得 {#ariaid-title1}

* リリースバージョン: Yokohama
* 
* 更新日 2025年01月30日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分

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

## 始める前に

必要なロール：sn_imt_core.reader

## 手順

インスタンスのテーブル API に GET 要求を送信します。  
詳細については、「[テーブル API](https://www.servicenow.com/docs/access?context=c_TableAPI&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)」を参照してください。

1. 衛生安全ユーザー \[sn_imt_core_health_and_safety_user\] テーブルを使用して、エンドポイントをビルドします。  

       https://<your-instance>.servicenow.com/api/now/table/sn_imt_core_health_and_safety_user

2. 特定のユーザーのメールアドレスを照会するためのクエリパラメーターを追加します。  
   API Explorer では、次のいずれかの文字列を \[sysparm_query\] フィールドに入力して、正しいクエリパラメーターを含むエンドポイントを生成できます。
   * <kbd class="ph userinput">user.email=&lt;user-email-address&gt;</kbd>：指定された従業員のメールアドレスを照会します。
   * <kbd class="ph userinput">visitor.email=&lt;visitor-email-address&gt;</kbd>：指定された訪問者のメールアドレスを照会します。

   {#query-health-data__ul_glp_mhq_3mb}

{#query-health-data__substeps_ctd_bwh_3mb}  
この例の 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"
        }
      ]
    }

すべてのフィールドは、次のものを除いて社内用です。  
{#query-health-data__table_avk_r4p_3mb__entry__2}

| 財産 | 説明 |
|-|-|
| requirements_status | 訪問者または従業員が職場に戻るためのすべての要件を完了したかどうかを示す。詳細については、「[衛生安全ユーザーレコードを作成する](https://servicenow-prod.fluidtopics.net/nGWe4MfP2nWHfNbcPfbuvw "すべての従業員と訪問者の要件ステータスを記録する衛生安全ユーザーレコードを作成します。")」と「[衛生安全要件を作成する](https://servicenow-prod.fluidtopics.net/Ep~PD_xnMcCxOADzeIgdWg "要件を作成して、従業員が職場に戻る準備または現場を訪問する準備ができたかを記録します。訪問者が職場に入室する前に満たさなければならない要件を作成することもできます。")」を参照。 * 完了 (Cleared)：訪問者または従業員は職場に戻るためのすべての要件を満たしている。 * 未完了 (Not Cleared)：訪問者または従業員は職場に戻るためのすべての要件を満たしていない。 {#query-health-data__ul_qdm_1vp_3mb} データタイプ：文字列 |
| visitor | 存在する場合、このレコードは従業員ではなく訪問者を示す。 注: 訪問者の健全性データを返すときにのみ使用されます。 データタイプ: オブジェクト |
| visitor.link | インスタンスの訪問者レコードへのリンク。 注: 訪問者の健全性データを返すときにのみ使用されます。 データタイプ：文字列 |
| visitor.value | 訪問者レコードの Sys_id。 注: 訪問者の健全性データを返すときにのみ使用されます。 データタイプ：文字列 |
| user | 存在する場合は、このレコードは訪問者ではなく従業員を示す。 注: 従業員の健康データを返すときにのみ使用されます。 データタイプ: オブジェクト |
| user.link | インスタンスのユーザーレコードへのリンク。 注: 従業員の健康データを返すときにのみ使用されます。 データタイプ：文字列 |
| user.value | ユーザーレコードの Sys_id。 注: 従業員の健康データを返すときにのみ使用されます。 データタイプ：文字列 |
[ ]

{#query-health-data__table_avk_r4p_3mb}