웹후크 이벤트 구성

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 4분

    • 배지 벤더가 웹후크 이벤트를 사용하여 배지 테이블에서 수집한 배지 데이터를 공유할 수 있도록 제공자 구성 테이블에서 웹후크 API 이벤트를 구성합니다.

    시작하기 전에

    필요한 역할: sn_wsd_wc.admin

    이 태스크 정보

    배지 데이터(JSON)는 REST API 탐색기를 ServiceNow 사용하여 처리됩니다. REST API 탐색기를 사용하여 하나 또는 여러 개의 원시 배지 데이터 기록(페이로드)을 공유하고 처리할 수 있습니다. 배지 데이터에 대한 웹후크 이벤트는 단일 또는 여러 JSON 기록의 커넥터 이벤트 테이블에 로드됩니다. 여러 기록이 배열로 전송됩니다. 자세한 내용은 출석 분석 문서를 참조하십시오.

    프로시저

    1. 다음으로 이동 모두 > 워크플레이스 커넥터 > 제공자 커넥터 구성.
    2. 새로 생성을 선택합니다.

      양식에서 필드를 채웁니다.

      표 1. 제공자 커넥터 구성 양식
      필드 설명
      이름 제공자 구성의 이름입니다.
      소스 유형 배지 데이터가 수집되어 대상 직원 출석 테이블에 로드되는 소스입니다.

      웹후크를 선택하여 웹후크 이벤트를 구성합니다.
      토큰 매개변수 이름

      토큰 매개변수 이름 및 토큰 값은 벤더 배지 시스템에서 애플리케이션으로 API 호출을 인증하는 데 사용되는 비밀 키-값 쌍입니다워크플레이스 커넥터. 두 시스템 모두 토큰 이름 값을 갖습니다. 애플리케이션은 토큰 이름을 사용하여 API 요청을 인증합니다.
      토큰 값 토큰 값은 서버가 API 요청을 인증할 수 있도록 API 이벤트를 호출하는 동안 배지 공급업체에서 사용하는 비밀 키입니다.
      활성 제공자 구성이 활성 상태임을 나타내는 옵션입니다.
      커넥터 구성 목록 조회 아이콘( 목록 조회 아이콘. )을 검색하고 선택하여 배지를 선택하는 옵션입니다.

      자세한 내용은 배지 데이터에 대한 커넥터 구성 문서를 참조하십시오.
      콜백 URL 콜백 URL 아이콘( 콜백 URL 아이콘.)을 선택하여 콜백 URL을 잠그거나 편집하는 옵션입니다.
    3. 업데이트를 선택합니다.
    4. 새로 생성된 웹후크 이벤트를 선택합니다.

      콜백 URL 생성 버튼을 사용하여 REST API 요청에 대한 콜백 URL을 생성할 수 있습니다.

    5. 배지 벤더는 다음으로 이동하여 배지 데이터를 JSON 형식으로 공유합니다. 모두 > 시스템 웹 서비스 > REST > REST API 탐색기.
    6. REST API 탐색기 페이지에서 다음을 선택합니다.
      • 네임스페이스: 드롭다운 목록에서 sn_wsd_wc를 선택합니다 .
      • API 이름: 작업 공간 커넥터 웹후크
      • API 버전: v1
    7. 작업 공간 커넥터 웹후크 이벤트 페이지에서 다음 값을 제공합니다.
      • token_name: 2단계에서 사용된 토큰 매개변수 이름입니다. 토큰 이름 값은 배지 공급업체에서 배지 데이터(JSON) 워크플레이스 커넥터를 공유하는 데 사용됩니다. 원시 데이터(페이로드 또는 배지 데이터)가 처리되어 커넥터 이벤트 테이블로 로드됩니다.
      • ni.nolog.id: 2단계에서 생성한 웹후크의 시스템 ID를 복사하여 붙여넣습니다. 창에서 추가 작업 메뉴 아이콘( 추가 작업 메뉴 아이콘 )을 선택합니다.
      • token_value: 2단계에서 제공한 토큰 값입니다. 토큰 값은 서버가 API 요청을 인증할 수 있도록 API 이벤트를 호출하는 동안 배지 공급업체에서 사용하는 비밀 키입니다.
      1. API 요청 본문에서 원시 를 선택하고 배지 데이터(페이로드)를 JSON 형식으로 복사합니다.
        이 배지 데이터는 배지 센서에서 수집됩니다.
      2. 보내기를 선택합니다.
        응답 코드가 200 OK 이고 응답 결과가 성공이면 배지 데이터가 커넥터 이벤트 테이블에 로드됩니다.
        • 커넥터 이벤트 테이블(sn_wsd_wc_connector_events)은 배지 벤더가 공유하는 배지 데이터를 로드합니다. 배지 데이터의 상태는 REST API 탐색기에서 로드될 때 신규 입니다.
        • 예약된 작업 프로세스 웹훅 제공자 데이터 기록 은 1분마다 실행되어 배지 데이터를 커넥터 이벤트 테이블( 신규 상태의 데이터)에서 직원 출석 데이터 테이블로 로드합니다.
      예약된 작업은 웹후크 이벤트에서 소스 데이터를 가져와 필요한 형식으로 데이터를 변환한 다음 대상 직원 출석 데이터 테이블에 배치합니다.
      주:
      예약된 작업에 액세스하려면 워크플레이스 커넥터 다음으로 이동하십시오. 모두 > 시스템 정의 > 예약된 작업. 애플리케이션 열에서 직장 커넥터를 검색합니다. 에 대해 워크플레이스 커넥터두 개의 예약된 작업을 사용할 수 있습니다.
      • 프로세스 제공자 데이터 기록: 벤더 배지 데이터(소스 테이블)에서 데이터를 읽습니다. 배지 데이터를 처리한 후 기록은 이를 직원 출석 데이터 테이블(대상 테이블)로 로드합니다. 자세한 내용은 배지 테이블 데이터 구성 문서를 참조하십시오.
      • 웹훅 제공자 데이터 기록 처리: 커넥터 이벤트 테이블에서 데이터를 읽습니다. 웹후크 이벤트 데이터를 처리하여 직원 출석 데이터 테이블(대상 테이블)에 로드합니다.
      • 데이터가 직원 출석 데이터 테이블로 로드됩니다. 커넥터 이벤트 테이블의 배지 데이터 상태가 처리됨으로 변경됩니다.
      • 직원 출석 데이터 테이블에서 데이터가 출석 분석 테이블로 로드됩니다.
        주:
        처리됨 상태인 커넥터 이벤트 테이블의 배지 데이터 기록은 생성일로부터 2일 후 또는 현재 날짜가 커넥터 이벤트 테이블 [sn_wsd_wc_connector_events]에 의해 제거됩니다. 오류 상태의 데이터는 생성 날짜로부터 7일 후에 제거됩니다. 신규 상태의 데이터는 제거되지 않습니다.