---
sourceDocument: 요코하마 직원 서비스 관리
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/yokohama/employee-service-management

 Release :

    - yokohama

ft:locale :

    - ko-KR

ft:publication_title :

    - 요코하마 직원 서비스 관리

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. Health and Safety 사용자 \[sn_imt_core_health_and_safety_user\] 테이블을 사용하여 엔드포인트를 구성합니다.  

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

2. 쿼리 매개변수를 추가하여 특정 사용자의 이메일 주소를 쿼리합니다.  
   API 탐색기에서 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 요청은 Health and Safety 사용자 테이블을 쿼리하고 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/IMHX6o1FuSoI4mET7b_RVg "건강 및 안전 사용자 기록을 생성하여 모든 직원과 방문자의 요구 사항 상태를 추적합니다.") 및 [건강 및 안전 요구 사항 생성](https://servicenow-prod.fluidtopics.net/JS74Aa2TA7Dl~5Ozk3q7wQ "직원이 직장으로 복귀하거나 현장을 방문할 준비가 된 시기를 추적하기 위한 요구 사항을 생성합니다. 방문자가 직장에 들어가기 전에 완료해야 하는 요구 사항을 생성할 수도 있습니다.") 문서를 참조하십시오. * 통과됨: 방문자 또는 직원이 직장 복귀를 위한 모든 요구 사항을 완료했습니다. * 선택 취소되지 않음: 방문자 또는 직원이 직장 복귀를 위한 모든 요구 사항을 완료하지 않았습니다. {#query-health-data__ul_qdm_1vp_3mb} 데이터 유형: 문자열 |
| 방문자 | 있는 경우 이 기록은 직원이 아닌 방문자를 나타냅니다. 주: 방문자 건강 데이터를 반환할 때만 사용됩니다. 데이터 유형: 객체 |
| visitor.link | 인스턴스의 방문자 기록에 연결합니다. 주: 방문자 건강 데이터를 반환할 때만 사용됩니다. 데이터 유형: 문자열 |
| 방문자.값 | 방문자 기록의 Sys_id입니다. 주: 방문자 건강 데이터를 반환할 때만 사용됩니다. 데이터 유형: 문자열 |
| 사용자 | 있는 경우 이 기록은 방문자가 아닌 직원을 나타냅니다. 주: 직원 건강 데이터를 반환할 때만 사용됩니다. 데이터 유형: 객체 |
| user.link | 인스턴스의 사용자 기록에 대한 링크입니다. 주: 직원 건강 데이터를 반환할 때만 사용됩니다. 데이터 유형: 문자열 |
| 사용자.값 | 사용자 기록의 Sys_id입니다. 주: 직원 건강 데이터를 반환할 때만 사용됩니다. 데이터 유형: 문자열 |
[ ]

{#query-health-data__table_avk_r4p_3mb}