Skip To Content

웹후크를 위한 주요 개념

웹후크는 다른 응용프로그램에 이벤트 기반 정보를 HTTPS 요청으로 전달하여 자동화 및 통합된 워크플로를 생성하는 데 사용할 수 있습니다. ArcGIS Enterprise 웹후크 워크플로의 몇 가지 주요 개념은 다음 섹션에서 자세히 설명합니다.

이벤트 트리거

이벤트 트리거는 웹후크를 호출할 API 작업을 지정합니다. 기관 및 피처 서비스 웹후크는 모두 구독할 수 있는 다양한 이벤트 트리거를 지원합니다. 예를 들어 특정 그룹이 업데이트될 때 트리거되도록 기관 웹후크를 설정하거나 피처 서비스 웹후크의 경우 피처 서비스 정의가 업데이트될 때 웹후크가 트리거되도록 선택할 수 있습니다. 그러나 지오프로세싱 서비스 웹후크는 사용자가 구독할 수 있는 이벤트 트리거 목록을 사용하지 않습니다. 지오프로세싱 서비스 웹후크는 지오프로세싱 서비스 작업이 완료될 때마다 페이로드를 반환합니다. 기관 및 피처 서비스 웹후크에 지원되는 이벤트 트리거 목록에 대한 자세한 내용은 이벤트 트리거 항목을 참고하세요.

페이로드

사용자가 이벤트 트리거로 지정된 작업을 수행하면 웹후크는 페이로드라고도 하는 이벤트 정보를 지정된 페이로드 URL로 전달합니다. 각 웹후크 유형에 대한 이벤트 정보는 이벤트 정보 및 이벤트 발생 시간을 포함한 유사한 JSON 스키마로 전달되지만, 기관 및 서비스 웹후크에 대해 반환되는 페이로드 구조 및 등록정보는 웹후크 유형에 따라 다릅니다. 각 웹후크 유형의 페이로드에 대한 자세한 내용은 페이로드를 참고하세요.

페이로드 URL

웹후크가 호출되면 페이로드는 웹후크 수신기에서 일반적으로 제공되는 특정 URL로 전달됩니다. 페이로드 URL은 웹후크를 구성할 때 제공되며 HTTPS POST 요청으로 수신자가 ArcGIS Enterprise에서 연결할 수 있도록 생성 중에 확인됩니다.

수신기

페이로드는 웹후크 수신기로 전달되며, 페이로드를 검색하고 관리자 또는 기관 구성원에게 이벤트가 다시 발생했음을 알립니다. 웹후크 수신기는 페이로드를 수신하고 ArcGIS Enterprise에서 연결할 수 있도록 HTTPS 연결을 통해 통신하도록 구성되어야 합니다. 수신기에 지원되는 몇 가지 옵션으로는 서드 파티 웹 서비스 수신기(Microsoft Power Automate, Zapier, IFFT), 사용자 설정 웹 서비스, ArcGIS Notebook Server, ArcGIS Workflow Manager 등이 있습니다. 사용자 설정 웹 서비스를 생성하거나 서드 파티 수신기를 사용하여 시작하는 방법에 대한 예시는 웹후크 저장소를 참고하세요. Notebook ServerWorkflow Manager 웹후크 생성에 대한 자세한 내용은 ArcGIS Notebooks로 워크플로 자동화웹후크로 작업 생성을 각각 참고하세요.