워크플로용 웹후크 만들기
웹후크는 워크플로에서 Qlik Cloud 시스템 이벤트를 트리거로 사용할 수 있는 방법을 제공합니다. 웹후크를 만들면 정의된 시스템 이벤트가 발생할 때마다 자동으로 JSON 요청을 웹후크 종료 지점으로 보냅니다. 웹후크를 사용하여 JSON 데이터를 수신할 수 있는 모든 응용 프로그램에 이벤트 데이터를 보낼 수 있습니다.
웹후크 속성
웹후크를 만들려면 웹후크 및 엔드포인트 속성을 구성하고 Qlik Cloud 이벤트 유형을 선택해야 합니다.
속성 | 설명 |
---|---|
이름 | 웹후크의 이름입니다. |
설명(옵션) | 웹후크에 대한 설명입니다. |
URL | 웹후크 엔드포인트에 대한 URL입니다. URL(웹후크 엔드포인트)은 FDQN(정규화된 도메인 이름)이어야 하며 HTTPS 프로토콜을 사용해야 합니다. 엔드포인트는 IP 주소일 수 없습니다. |
비밀(선택 사항) | 웹후크 인증을 위한 비밀입니다. 비밀은 최소 32자, 최대 64자여야 합니다. 웹후크 비밀을 만들면 이는 HTTP 요청에 qlik-signature로 추가되는 해시의 일부입니다. |
헤더(선택 사항) |
HTTP 요청에 추가할 수 있는 헤더입니다. |
각 웹후크는 하나 이상의 이벤트 유형으로 구성됩니다.
리소스 | 이벤트 유형 |
---|---|
앱 | 만들어짐, 삭제됨, 데이터 업데이트됨, 다시 로드됨, 게시됨, 내보냄 정보 메모데이터 업데이트 이벤트가 발생하면 데이터가 새로 고쳐진 것입니다. 다시 로드 이벤트가 발생하면 Qlik Sense 앱 및 관련 데이터 테이블이 다시 로드된 것입니다. |
사용자 | 만들어짐, 삭제됨 |
웹후크는 이벤트 중 하나가 발생할 때까지 기다렸다가 발생하면 이벤트 데이터를 웹후크 엔드포인트로 보냅니다. 데이터는 엔드포인트 URL에 JSON 요청으로 전달됩니다.
앱에 대한 JSON 요청이 이벤트 유형을 삭제함
Request
URL
https://api.blendr.io/v1/widgets/F502987A-AF89-4992-8127-F28794C5A74A?X-Execution-Token=xxxxx
Headers
{
"Content-Type": "application/json",
"Qlik-Signature": "446bd5e3f5b635f491d17557e4bec6ebc61b7bd2bc9cc7b612e4e",
"User-Agent": "Qlik Webhook"
}
Body
{
"cloudEventsVersion": "0.1",
"source": "com.qlik/engine",
"contentType": "application/json",
"eventId": "e65c1481-e8a-4be-a5ca-27dfcde077d7",
"eventTime": "2021-03-08T14:51:29Z",
"eventTypeVersion": "1.0.0",
"eventType": "com.qlik.v1.app.deleted",
"extensions": {
"ownerId": "vNRGrDZIypJzauw59BbpvkRhqbmI",
"tenantId": "oZcMPa_1PwH4FUdrh6839YHHdEJN",
"userId": "vNRGrDZIypJtcGTzauw59BbpqbmI"
},
"data": {
"attributes": {
"id": "0984fec4-aa8c-4253-b1d1-4fd4f9c78",
"name": "New App",
"createdDate": "2021-03-08T14:51:28.888Z",
"modifiedDate": "2021-03-08T14:51:29.316Z",
"owner": "auth0|b62a17c577a4abe6e807b07d18c4d82286352542d633d120100b03fb11",
"ownerId": "vNRGrDZIypJtcGTzauw59BbpvbmI",
"published": false,
"hasSectionAccess": false
}
}
}
웹후크 만들기
관리 콘솔에서 웹후크를 만듭니다. Qlik 응용 프로그램 자동화 인터페이스에서 웹후크를 만들 수도 있습니다. 자세한 내용은 웹후크 작업 (영어로만 제공)을 참조하십시오.
각 테넌트에 대해 최대 100개의 웹후크를 만들 수 있습니다.
다음과 같이 하십시오.
-
관리 콘솔에서 웹후크로 이동합니다.
-
오른쪽 상단에서 새로 만들기를 클릭합니다.
-
웹후크 만들기 대화 상자에서 웹후크 이름을 입력합니다.
-
설명을 추가합니다(선택 사항).
-
타사 통합 응용 프로그램의 URL을 입력합니다.
-
선택적으로 HTTP 요청에 추가할 비밀을 입력합니다.
-
선택적으로 요청에 추가할 HTTP 헤더를 추가합니다.
-
이벤트에서 웹후크의 이벤트 유형을 선택합니다.
-
완료되면 만들기를 클릭합니다.
웹후크가 테이블에 나열됩니다. 새로 만들어진 웹후크는 기본적으로 켜져 있습니다.
웹후크 편집
다음과 같이 하십시오.
-
관리 콘솔에서 웹후크로 이동합니다.
-
편집하려는 웹후크의 경우 행 끝에 있는 버튼을 클릭합니다.
-
편집을 클릭합니다.
웹후크 구성을 변경하는 옵션을 사용하면 편집 패널이 표시됩니다.
-
편집하고 저장을 클릭합니다.
웹후크 삭제
다음과 같이 하십시오.
-
관리 콘솔에서 웹후크로 이동합니다.
-
삭제할 웹후크를 선택합니다.
-
오른쪽 위 모서리에서 삭제를 클릭합니다.
-
선택 사항을 확인하는 팝업 대화 상자가 열립니다. 삭제를 클릭합니다.
웹후크 기록 보기
관리 콘솔의 웹후크에서 웹후크 기록에 액세스합니다.
-
웹후크 기록을 보려면 웹후크 행 끝에 있는 버튼을 클릭합니다.
웹후크 기록이 표시됩니다.
-
이벤트 전달을 수동으로 다시 보내려면 이벤트 행 끝에 있는 버튼을 클릭합니다.
-
이벤트 응답 페이로드를 보려면 이벤트 행 끝에 있는 버튼을 클릭합니다.