출입 요청 업데이트 구독

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기3분

    • 웹후크를 구성하여 각 직원 건강 검사 출입 요청 결과를 외부 공급업체에 전송합니다.

    시작하기 전에

    아웃바운드 웹후크 호출을 전송하려면 다음과 같은 플러그인이 필요합니다.
    • ServiceNow 통합 허브 Runtime(com.glide.hub.integration.runtime)
    • 워크플로우 스튜디오 Action Step - Payload Builder(com.glide.hub.action_step.payload)
    • ServiceNow 통합 허브 Action Step - REST(com.glide.hub.action_step.rest)
    이러한 플러그인은 Now Support 서비스 카탈로그를 통해 요청해야 합니다. 자세한 내용은 플러그인 요청을 참조하십시오.
    웹후크를 설정할 때 직원 또는 방문자가 입장을 요청할 때마다 시스템에서 자동으로 외부 공급업체 엔드포인트로 REST 요청을 보냅니다. 외부 공급업체 시스템 관리자와 협업하여 제공할 올바른 엔드포인트를 결정하십시오.
    주:
    웹후크에는 요청의 인증 헤더가 포함되지 않습니다. 요청을 인증하는 쿼리 매개변수가 포함된 엔드포인트를 제공해야 합니다.

    직원 건강 검사 출입 요청 모듈에 관한 자세한 내용은 출입을 위한 건강 검사 실시에서 확인하십시오.

    필요한 역할: sn_imt_core.admin 또는 admin

    프로시저

    1. 다음으로 이동 모두 > 직원 건강 및 안전 상태 > 아웃바운드 웹후크.
    2. 웹후크 [sn_imt_core_webhook] 테이블에서 새로 만들기를 클릭합니다.
    3. 양식의 필드에 내용을 입력합니다.
      표 1. 웹후크 양식
      필드 설명
      이름 외부 공급업체 엔드포인트의 내부 식별자입니다.
      이벤트 구독하려는 이벤트입니다. 옵션은 다음과 같습니다.
      • 직원이 요청한 입장: 직원이 입장을 요청할 때마다 업데이트를 보냅니다.
      • 방문자가 요청한 입장: 방문자가 입장을 요청할 때마다 업데이트를 보냅니다.
      엔드포인트 직원 건강 검사 출입 요청 데이터가 전송될 엔드포인트입니다.
      주:
      웹후크에는 요청의 인증 헤더가 포함되지 않습니다. 요청을 인증하는 쿼리 매개변수가 포함된 엔드포인트를 제공해야 합니다.
      보안 매개변수 인증 토큰처럼 안전하게 처리해야 하는 엔드포인트에 대한 쿼리 매개변수입니다. ?param1=value&param2=othervalue 형식으로 매개변수를 제공합니다.
      팁:
      데이터 전송 대상인 외부 공급업체가 안전하게 생성된 인증 토큰을 제공하지 않는 경우 다음 스크립트를 통해 ServiceNow 인스턴스에서 토큰을 생성할 수 있습니다. 
      var secureRandom = GlideSecureRandomUtil;
var secret = secureRandom.getSecureRandomString(30);
gs.log(secret);
      활성 기록을 활성으로 설정할 수 있는 옵션입니다.
    4. 제출을 클릭합니다.

    결과

    직원 건강 검사 애플리케이션은 직원이 입장을 요청할 때마다 외부 공급업체 엔드포인트에 출입 요청 데이터를 전송합니다. JSON 페이로드에는 다음 데이터가 포함되어 있습니다. 
    {
  "event": "entry.requested",
  "email": "aileen.mottern@example.com",
  "username": "aileen.mottern",
  "user_id": "a8f98bb0eb32010045e1a5115206fe3a",
  "location": "San Antonio",
  "location_id": "108486c7c611227500b093211aa88dcc",
  "access_granted": false,
  "updated": "2020-07-01 22:19:03"
}
    속성 설명
    event 웹후크 테이블에 정의된 이벤트 유형입니다.

    데이터 유형: 문자열
    email 직원의 이메일 주소입니다.

    데이터 유형: 문자열
    username Health and Safety 사용자[sn_imt_core_health_and_safety_user] 테이블의 직원 사용자 이름입니다.

    데이터 유형: 문자열
    user_id Health and Safety 사용자[sn_imt_core_health_and_safety_user] 테이블의 사용자 기록 sys_id입니다.

    데이터 유형: 문자열
    location 건강 검사 위치입니다.

    데이터 유형: 문자열
    location_id 위치[cmn_location] 테이블의 위치 기록 sys_id입니다.

    데이터 유형: 문자열
    access_granted 건강 검사 결과로 직원에게 접근 권한이 부여되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
    • true: 직원이 건강 검사를 통과하여 접근 권한을 부여받았습니다.
    • false: 직원이 건강 검사를 통과하지 못하여 접근 권한을 부여받지 못했습니다.

    데이터 유형: 부울
    updated 직원 또는 방문자가 요청한 입장 날짜 및 시간입니다.

    데이터 유형: 날짜/시간