Adobe Workfront Fusion의 인스턴트 트리거(웹후크)
많은 서비스는 서비스에서 특정 변경 사항이 발생할 때마다 즉시 알림을 전송할 수 있도록 웹후크를 제공합니다. 이러한 알림을 처리하려면 인스턴트 트리거를 사용하는 것이 좋습니다. 태그 때문에 Adobe Workfront Fusion에서 이를 쉽게 인식할 수 있습니다.
서비스가 웹후크를 제공하지 않는 경우 폴링 트리거를 사용하여 서비스를 정기적으로 폴링해야 합니다.
Workfront Fusion의 Webhooks에 대한 비디오 소개는 다음을 참조하십시오.
액세스 요구 사항
이 문서의 기능을 사용하려면 다음 액세스 권한이 있어야 합니다.
보유 중인 플랜, 라이선스 유형 또는 액세스 권한을 확인하려면 Workfront 관리자에게 문의하세요.
Adobe Workfront Fusion 라이선스에 대한 자세한 내용은 Adobe Workfront Fusion 라이선스를 참조하세요.
웹후크의 대기열 보기
들어오는 웹후크의 모든 메시지는 웹후크의 큐에 저장됩니다.
-
왼쪽 메뉴에서 웹후크 를 클릭합니다.
-
대기열을 보려는 웹후크를 찾습니다.
-
트럭 아이콘과 받은 웹후크 수가 있는 버튼을 클릭합니다.
note note NOTE 들어오는 Webhook 데이터는 옵션 데이터의 설정 방법과 관계없이 항상 큐에 저장됩니다(의 시나리오 설정 패널 Adobe Workfront Fusion에 설명). 데이터가 시나리오에서 처리되는 즉시 시스템에서 영구적으로 삭제됩니다.
인스턴트 트리거 예약
시나리오에 인스턴스 트리거가 포함된 경우 시나리오가 즉시 실행되도록 예약할 수 있습니다.
이 경우 Workfront Fusion이(가) 서비스에서 새 데이터를 받을 때 시나리오가 즉시 실행됩니다. 시나리오가 실행되면 대기열에 대기 중인 총 보류 중인 웹후크의 수가 계산되고 시나리오는 보류 중인 웹후크의 수만큼 수행되며 주기당 하나의 웹후크를 처리합니다. 자세한 내용은 Adobe Workfront Fusion🔗의 시나리오 실행, 주기 및 단계를 참조하십시오.
-
주기는 시나리오 실행과 동일하지 않습니다. 1개의 시나리오 실행 내에 여러 주기가 있을 수 있습니다.
-
즉각적인 트리거가 즉시 실행되도록 스케줄링된 시나리오를 실행할 경우 다음과 같은 예외가 적용됩니다.
-
두 실행 사이의 간격은 요금제에 따른 최소 간격의 적용을 받지 않습니다.
예를 들어 시나리오의 실행이 완료되면 웹후크의 대기열이 다시 확인됩니다. 보류 중인 웹후크가 있는 경우 시나리오는 즉시 다시 실행되어 보류 중인 모든 웹후크를 다시 처리합니다.
-
최대 주기 수 시나리오 설정이 무시되고 100으로 설정되므로 단일 시나리오 실행 중에 100개 이하의 보류 중인 웹후크가 처리됩니다(한 주기당 이벤트 1개 비율).
-
즉시 이외의 다른 일정 설정을 사용하는 경우 지정한 간격으로 시나리오가 실행됩니다. 간격 동안 큐에 여러 개의 웹 후크를 수집할 수 있으므로 한 시나리오 실행에서 더 많은 웹 후크를 처리하려면 최대 주기 수를 기본 1보다 높은 값으로 설정하는 것이 좋습니다.
- 시나리오 하단의 시나리오 설정 아이콘 을(를) 클릭합니다.
- 표시되는 시나리오 설정 상자에서 최대 주기 수 상자에 숫자를 입력하여 시나리오를 실행할 때마다 실행할 큐의 웹후크 수를 나타냅니다.
비율 제한
현재 속도 제한은 초당 5개의 웹후크입니다. 한도를 초과하면 429 상태 코드가 반환됩니다.
비활성 웹후크 만료
120시간 이상 시나리오에 할당되지 않은 웹후크가 제거됩니다.
Webhook 페이로드
Workfront Fusion이(가) 30일 동안 webhook 페이로드를 저장합니다. 웹후크 페이로드가 생성된 후 30일 이상 지나면 "저장소에서 파일을 읽지 못했습니다." 오류가 발생합니다.
오류 처리
즉시 트리거를 사용하는 시나리오에서 오류가 있는 경우 시나리오는 다음과 같습니다.
- 시나리오를 즉시를 실행하도록 설정한 경우 즉시 중지합니다.
- 시나리오가 예약대로 실행되도록 설정된 경우 3번의 실패 시도 후 중지됩니다(오류 3개).
시나리오 실행 중에 오류가 발생하면 즉시 트리거의 롤백 단계 중에 웹후크가 대기열에 다시 배치됩니다. 이러한 상황에서는 시나리오를 수정하고 다시 실행할 수 있습니다. 자세한 내용은 문서 시나리오 실행, 주기 및 단계 Adobe Workfront Fusion의 롤백을 참조하십시오.
시나리오에 Webhook 응답 모듈이 있으면 오류가 Webhook 응답으로 전송됩니다. Webhook 응답 모듈은 항상 마지막으로 실행됩니다(시나리오 설정의 자동 커밋 옵션이 활성화되지 않은 경우). 자세한 내용은 문서 Webhooks의 Webhooks에 응답을 참조하십시오.
사용자 지정 웹 후크
자신만의 웹후크를 만들 수 있습니다. 자세한 내용은 웹후크를 참조하십시오.
Webhook 비활성화
다음 중 하나가 적용되는 경우 웹후크는 자동으로 비활성화됩니다.
- 웹후크가 5일 이상 어떤 시나리오에도 연결되지 않았습니다.
- 웹후크는 30일 이상 비활성 상태인 비활성 시나리오에서만 사용됩니다.
비활성화된 웹후크는 시나리오에 연결되어 있지 않고 30일 이상 비활성화된 상태인 경우 자동으로 삭제 및 등록 취소됩니다.