Poller

Poller 트리거는 주기적으로 데이터 소스를 확인하여 업데이트를 검사합니다. 구성한 후, Poller는 데이터 소스의 폴링 URL을 사용하여 주기적으로 새로운 데이터를 확인합니다. Poller는 실시간 업데이트가 불가능하거나 업데이트 빈도가 낮은 유스케이스에 적합합니다.

개요

Poller는 폴링 개념에 따라 작동하며, 트리거가 주기적으로 새 데이터를 위해 폴링 URL로 요청을 보냅니다. Poller를 구성하여 수신 이벤트 알림을 받고 해당 알림을 기반으로 후속 자동화를 시작할 수 있습니다. 애플리케이션의 폴러 URL은 트리거가 새로운 이벤트를 확인하기 위해 폴링하는 엔드포인트 역할을 합니다.

GET 호출 또는 POST 호출에 대해 Poller를 구성할 수 있습니다. Poller를 구성할 때 헤더 매개변수, 쿼리 매개변수, 컨텍스트 관리 세부 정보 및 JSON 필터를 추가해야 합니다. POST 옵션에는 요청 본문을 추가할 수 있는 기능이 포함되어 있습니다. 이 옵션을 사용하여 이벤트에 추가 데이터가 필요한 폴러 URL로 데이터를 보낼 수 있습니다.

설정

Listener 트리거에서 다음 설정을 사용할 수 있습니다.

Poller의 설정 패널

Name
Poller에 대해 이름 지정
폴링 URL
애플리케이션의 폴링 URL을 지정합니다.
요청 유형
API 요청 유형을 선택합니다. Poller는 GET 및 POST 메서드를 지원합니다.
  • GET - GET 메서드를 사용하여 이벤트 세부 정보를 가져올 수 있습니다.
  • POST - POST 메서드를 사용하여 응답 데이터를 제한할 수 있습니다. POST 메서드는 요청 본문을 추가할 수 있는 규정이 있습니다. 이 옵션은 응답 데이터를 제한하는 필터 역할을 합니다.
요청 본문
POST 메서드에 대한 요청 본문을 입력합니다. 요청 본문은 TXT, JSON, XML, HTML과 같은 형식으로 추가할 수 있습니다.
폴링 간격
새로운 정보를 확인하기 위해 URL을 폴링하는 빈도를 설정합니다. 간격을 분, 시간 또는 일로 설정할 수 있습니다. 간격의 최소 한도는 5분입니다.
인증 모드
트리거의 인증 방식을 지정합니다. 인증 없음 또는 OAuth2 - Control Room에서 관리됨 중에서 선택할 수 있습니다.
연결
선택 버튼을 사용하여 기존 OAuth 연결을 인증 모드로 선택합니다. 연결이 설정되어 있고 활성화되어 있는지 확인합니다.
헤더 추가
폴링 요청에 적용할 수 있는 헤더 매개변수를 지정합니다. 인증 헤더 및 요청 헤더에 포함되어야 하는 기타 고유 매개변수를 추가할 수 있습니다.
헤더 추가 확인란을 활성화하고 헤더 추가를 클릭하여 항목 모달을 엽니다. 항목 모달에서 헤더 매개변수 이름과 값을 지정합니다.
쿼리 매개변수 추가
폴링 요청에 적용할 수 있는 쿼리 매개변수를 지정합니다. 확인란을 활성화하고 헤더 추가를 클릭하여 항목 모달을 엽니다.
쿼리 매개변수 추가 확인란을 활성화하고 쿼리 추가를 클릭하여 항목 모달을 엽니다. 항목 모달에서 쿼리 매개변수 이름과 값을 지정합니다.
컨텍스트 관리
동적 매개변수에 대한 컨텍스트 관리를 정의합니다. 트리거는 컨텍스트를 폴링 체크포인트로 사용하여 마지막 체크포인트 이후에 업데이트된 정보를 가져오도록 합니다. 폴링 URL, 헤더 및 쿼리 매개변수에 대한 컨텍스트 관리를 정의할 수 있습니다. 매개변수를 문자열로 정의하고, 해당 문자열을 사용해 컨텍스트를 정의합니다.
예를 들어, 폴링을 위한 Gmail API는 히스토리 ID를 사용하여 메일함의 변경 사항을 확인합니다. Gmail 받은 편지함에 대한 폴러 트리거를 구성할 때, 히스토리 ID를 https://gmail.googleapis.com/gmail/v1/users/me/history?startHistoryId={{historyID}} 와 같은 폴링 URL에 정의하거나, 키 startHistoryId 및 값 historyID로 쿼리 매개변수를 추가할 수 있습니다. 그런 다음 받은 편지함에 마지막으로 수신된 이메일의 히스토리 ID를 체크포인트로 사용하여 해당 히스토리 ID의 컨텍스트를 구성할 수 있습니다. 응답 페이로드에서 히스토리 ID가 캡처되는 JSON 노드도 컨텍스트 업데이트 필드에 추가해야 합니다. 이렇게 하면 트리거가 실행될 때마다 마지막으로 받은 이메일의 ID를 시작 히스토리 ID로 선택하게 됩니다.
컨텍스트 관리 확인란을 활성화하고 컨텍스트 추가를 클릭하여 항목 모달을 엽니다. 항목 모달에서 컨텍스트 키와 값을 지정합니다. 다음 중 하나를 컨텍스트 업데이트 조건으로 선택할 수 있습니다.
  • JSON 표현식: 이 옵션을 선택하여 응답 페이로드의 JSON 노드를 컨텍스트로 설정합니다.
  • 현재 타임스탬프(Unix): 이 옵션을 선택하여 쿼리 매개변수의 Unix Epoch 타임스탬프를 컨텍스트로 설정합니다.
  • 현재 타임스탬프(ISO 8601): 이 옵션을 선택하면 쿼리 매개변수의 ISO 8601 타임스탬프를 컨텍스트로 설정합니다.
Json 필터
응답 데이터에 대한 필터를 지정합니다. 이 설정을 통해 요구 사항에 따라 데이터를 필터링할 수 있습니다. 예를 들어, JSON 데이터에 1, 5, 10, 25, 30과 같이 다양한 길이의 기록이 포함되어 있는 경우, JSON 필터를 record.length>10 으로 정의할 수 있습니다. 이 필터는 길이가 10 미만인 기록을 제외합니다.
응답
트리거 응답 데이터를 저장할 기록 변수를 선택합니다. 자동화는 트리거 응답 데이터를 키-값 쌍 형식으로 저장합니다. Bot을 실행한 후, 감사 로그 페이지로 이동하여 트리거로 실행된 Bot 이벤트를 선택하면 응답 데이터를 확인할 수 있습니다.