직원 또는 방문자 건강 데이터 받기
외부 공급업체 시스템에서 사용하기 위한 직원 건강 및 안전 상태 데이터에 대한 GET 요청을 전송합니다. 데이터를 가져와 직원 또는 방문자의 현재 건강 상태를 확인합니다.
시작하기 전에
프로시저
GET 요청을 인스턴스의 테이블 API로 보냅니다.
자세한 내용은 테이블 API를 참조하세요.
-
쿼리 매개변수를 추가하여 특정 사용자의 이메일 주소를 쿼리합니다.
API 익스플로러에서 sysparm_query 필드에 다음 문자열 중 하나를 입력하면 올바른 쿼리 매개변수를 포함하는 엔드포인트를 생성할 수 있습니다.
- user.email=<user-email-address>: 제공된 직원의 이메일 주소를 쿼리합니다.
- visitor.email=<visitor-email-address>: 제공된 방문자의 이메일 주소를 쿼리합니다.
이 예시에서 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'결과
{
"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 | 방문자 또는 직원이 직장 복귀를 위한 모든 요구사항을 완료했는지의 여부입니다. 자세한 내용은 Health and Safety 사용자 기록 생성 및 안전보건 요구사항 생성 문서를 참조하십시오.
데이터 유형: 문자열 |
| visitor | 존재하는 경우 이 기록은 직원 대신 방문자를 나타냅니다. 주: 방문자 건강 상태 데이터를 반환할 때만 사용됩니다. 데이터 유형: 객체 |
| visitor.link | 인스턴스에 있는 방문자 기록에 대한 링크입니다. 주: 방문자 건강 상태 데이터를 반환할 때만 사용됩니다. 데이터 유형: 문자열 |
| visitor.value | 방문자 기록의 sys_id입니다. 주: 방문자 건강 상태 데이터를 반환할 때만 사용됩니다. 데이터 유형: 문자열 |
| user | 존재하는 경우 이 기록은 방문자 대신 직원을 나타냅니다. 주: 직원 건강 상태 데이터를 반환할 때만 사용됩니다. 데이터 유형: 객체 |
| user.link | 인스턴스에 있는 사용자 기록에 대한 링크입니다. 주: 직원 건강 상태 데이터를 반환할 때만 사용됩니다. 데이터 유형: 문자열 |
| user.value | 사용자 기록의 sys_id입니다. 주: 직원 건강 상태 데이터를 반환할 때만 사용됩니다. 데이터 유형: 문자열 |