직원 또는 방문자 건강 데이터 가져오기

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 4분

    • 타사 시스템에서 사용할 데이터에 대한 직원 건강 및 안전 상태 GET 요청을 보냅니다. 직원 또는 방문자의 현재 건강 상태를 확인하기 위한 데이터를 가져옵니다.

    시작하기 전에

    필요한 역할: sn_imt_core.reader

    프로시저

    인스턴스의 테이블 API에 GET 요청을 보냅니다.
    자세한 내용은 테이블 API를 참조하세요.
    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 필드에 다음 문자열 중 하나를 입력하여 올바른 쿼리 매개변수를 포함하는 엔드포인트를 생성할 수 있습니다.

      • user.email=<user-email-address>: 제공된 직원의 이메일 주소를 쿼리합니다.
      • visitor.email=<visitor-email-address>: 제공된 방문자의 이메일 주소를 쿼리합니다.
      특정 사용자의 이메일 주소를 쿼리하는 sysparm_query 값의 예입니다.
    이 예시 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"
    }
  ]
}

    다음을 제외한 모든 필드는 내부 필드입니다.

    속성 설명
    requirements_status 방문자 또는 직원이 직장 복귀를 위한 모든 요구 사항을 완료했는지 여부입니다. 자세한 내용은 건강 및 안전 사용자 기록 생성 및 건강 및 안전 요구 사항 생성 문서를 참조하십시오.
    • 통과됨: 방문자 또는 직원이 직장 복귀를 위한 모든 요구 사항을 완료했습니다.
    • 선택 취소되지 않음: 방문자 또는 직원이 직장 복귀를 위한 모든 요구 사항을 완료하지 않았습니다.

    데이터 유형: 문자열
    방문자 있는 경우 이 기록은 직원이 아닌 방문자를 나타냅니다.
    주:
    방문자 건강 데이터를 반환할 때만 사용됩니다.

    데이터 유형: 객체
    visitor.link 인스턴스의 방문자 기록에 연결합니다.
    주:
    방문자 건강 데이터를 반환할 때만 사용됩니다.

    데이터 유형: 문자열
    방문자.값 방문자 기록의 Sys_id입니다.
    주:
    방문자 건강 데이터를 반환할 때만 사용됩니다.

    데이터 유형: 문자열
    사용자 있는 경우 이 기록은 방문자가 아닌 직원을 나타냅니다.
    주:
    직원 건강 데이터를 반환할 때만 사용됩니다.

    데이터 유형: 객체
    user.link 인스턴스의 사용자 기록에 대한 링크입니다.
    주:
    직원 건강 데이터를 반환할 때만 사용됩니다.

    데이터 유형: 문자열
    사용자.값 사용자 기록의 Sys_id입니다.
    주:
    직원 건강 데이터를 반환할 때만 사용됩니다.

    데이터 유형: 문자열