설명서WorkfrontWorkfront 안내서

이벤트 구독 버전 관리

Last update: Tue May 27 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 개발자

Workfront에는 두 가지 버전의 이벤트 구독이 있습니다. 이 문서에서는 두 요소의 차이점에 대해 설명합니다.

새 버전은 Workfront API가 아니라 이벤트 구독 기능이 변경되었습니다.

이벤트 구독을 업그레이드하거나 다운그레이드할 수 있으므로 이벤트 구조가 변경될 때 기존 구독이 중단되지 않으므로 이벤트 구독에 공백 없이 새 버전으로 테스트하고 업그레이드할 수 있습니다.

이벤트 구독을 다른 버전으로 업그레이드하거나 다운그레이드하면 버전 변경 후 5분 동안 모든 이벤트 게재에 대해 중복 이벤트를 받습니다. 중복에는 이벤트 구독 버전 1과 버전 2가 각각 하나씩 포함됩니다. 이렇게 하면 이벤트 구독 버전 변경으로 인해 이벤트를 놓치지 않습니다.

이벤트 구독을 업그레이드하거나 다운그레이드하는 데 사용되는 끝점에 대한 자세한 내용은 이벤트 구독 API 문서에서 이벤트 구독 버전 관리를 참조하십시오.

IMPORTANT
다음 릴리스는 이벤트 구독 버전 관리에 영향을 줍니다.
  • 25.2 릴리스(2025년 4월 10일): 25.2 릴리스 이후에 만들어진 모든 새 구독은 버전 2로 만들어집니다.
  • 2026년 1월 15일: 나머지 모든 버전 1 구독이 버전 2로 마이그레이션됩니다.

버전 1과 버전 2 간의 변경 사항

이벤트 구독 버전 2가 다음과 같이 변경되었습니다.

일반 변경 사항

영향을 받는 필드
버전 1(이전 비헤이비어)
버전 2(변경)
업데이트 관리 작업
계산된 매개변수 값
계산된 매개 변수 값이 있는 사용자 정의 양식을 포함한 템플릿에서 만든 모든 오브젝트는 CREATE 이벤트가 전송되고 UPDATE은(는) 매개 변수 값(계산된 필드 및 해당 값 포함)과 함께 전송됩니다.
계산된 매개 변수 값이 있는 사용자 정의 양식을 포함하는 템플릿에서 개체를 만들면 CREATE 이벤트만 전송되고 계산된 필드를 포함하는 매개 변수 값을 포함합니다.
UPDATE 이벤트에 대한 구독이 있고 계산된 매개 변수 값으로 개체를 만든 후 UPDATE 이벤트를 받아야 하는 경우 해당 UPDATE 이벤트는 더 이상 받지 않습니다. 개체를 만들 때 계산된 매개 변수 값을 보려면 추가 CREATE 구독을 만들어야 합니다.
다중 선택 유형 필드

다중 선택 유형 필드에 대한 변경 사항을 포함하는 모든 유형의 이벤트에 대해 필드에 하나의 값만 포함된 경우 해당 값이 로 변환되어 문자열로 전송됩니다. 그렇지 않으면 배열로 전송됩니다.

예:

  • myMultiSelectField: ["oneValue"] myMultiSelectField: "oneValue"(으)로 변환되어 전송됩니다.
  • myMultiSelectField: ["first", "second"] 은(는) myMultiSelectField: ["first", "second"](으)로 전송됩니다.

배열에 있는 값의 수에 관계없이 배열로 전송됩니다.

예:

  • myMultiSelectField: ["oneValue"] 은(는) myMultiSelectField: ["oneValue"](으)로 전송됩니다.
  • myMultiSelectField: ["first", "second"] 은(는) myMultiSelectField: ["first", "second"](으)로 전송됩니다.
다중 선택 필드에 필터가 있는 구독이 있고 값이 문자열인 경우 값이 배열로 있는 것과 동일한 필터로 새 구독을 만들어야 합니다.

오브젝트별 변경 사항

개체 코드
영향을 받는 필드
버전 1(이전 동작)
버전 2(변경)
업데이트 관리 작업
ASSIGN
  • projectID
  • taskID
  • opTaskID
  • customerID
이 개체가 업데이트되면 UPDATE 이벤트에 영향을 받는 필드가 null에서 ID value(으)로 변경되는 것으로 잘못 표시되기도 합니다.
모든 UPDATE 이벤트에 영향을 받는 필드에 대한 올바른 값이 표시됩니다.
없음. 영향을 받는 필드에 필터가 있는 경우 다른 값이 변경된 것이 아니라 이러한 필드가 실제로 변경된 경우에만 UPDATE 이벤트를 받습니다.
도쿠
  • referenceObjID
이 개체에서 매개 변수 값이 업데이트되면 UPDATE 이벤트에 영향을 받는 필드가 null에서 object id(으)로 잘못 표시되었습니다.
모든 UPDATE 이벤트에 영향을 받는 필드에 대한 올바른 값이 표시됩니다.
없음. 영향을 받는 필드에 필터가 있는 경우 다른 값이 변경된 것이 아니라 이러한 필드가 실제로 변경된 경우에만 UPDATE 이벤트를 받습니다.
  • groups
문서가 삭제되면 DELETE 이벤트가 영향을 받는 필드를 이전 상태의 빈 배열로 잘못 표시했습니다.
DELETE 이벤트는 이전 상태의 영향을 받는 필드를 올바르게 표시합니다.
없음. DELETE 이벤트가 계속 전송되지만 지금은 영향을 받는 필드에 대한 올바른 데이터를 표시합니다.
DOCV
  • proofDecision
  • proofName
  • proofProgress
이 개체가 업데이트되면 두 개의 UPDATE 이벤트가 전송됩니다. 첫 번째 이벤트에는 영향을 받는 필드가 포함되지 않았지만 두 번째 이벤트에는 영향을 받는 필드가 포함되지 않았습니다.
영향을 받는 필드를 포함한 모든 필드 업데이트가 하나의 UPDATE 이벤트에만 있으며 두 번째 불필요한 이벤트는 전송되지 않습니다.
없음. 영향을 받는 필드에 필터가 있는 경우 이벤트는 첫 번째 이벤트에서 전달됩니다.
확장
  • topReferenceObjCode
  • referenceObjectName
비용에 대해 매개 변수 값이 업데이트되면 UPDATE 이벤트에서 EXPNS에서 PROJ(으)로 topReferenceObjCode가 잘못 변경되고 referenceObjectName에서 null에서 string value of project name(으)로 변경되었습니다.
모든 UPDATE 이벤트에 영향을 받는 필드에 대한 올바른 값이 표시됩니다.
없음. 영향을 받는 필드에 필터가 있는 경우 다른 값이 변경된 것이 아니라 이러한 필드가 실제로 변경된 경우에만 UPDATE 이벤트를 받습니다.
  • topReferenceObjCode
  • referenceObjectName
경비 개체가 삭제되면 DELETE 이벤트가 전송되기 전에 영향을 받는 필드를 null로 변경하는 UPDATE 이벤트가 전송되었습니다.
추가 UPDATE 이벤트가 전송되지 않습니다. DELETE 이벤트에 이전 상태의 영향을 받는 필드에 대한 올바른 값이 있습니다.
UPDATE 이벤트에 영향을 받는 필드에 대한 필터가 있고 개체가 삭제될 때 해당 필드를 받아야 하는 경우 해당 UPDATE 이벤트는 더 이상 받지 않습니다. 개체가 삭제될 때 이러한 필드를 보려면 추가 DELETE 구독을 만들어야 합니다.
시간
  • projectID
  • taskID
  • roleID
  • timesheetID
  • hourTypeID
  • projectOverheadID
  • referenceObjID
  • referenceObjCode
  • securityRootID
이 개체가 삭제되면 DELETE 이벤트가 영향을 받는 필드를 이전 상태의 null(으)로 잘못 표시했습니다.
DELETE 이벤트는 이전 상태의 영향을 받는 필드를 올바르게 표시합니다.
없음. DELETE 이벤트가 계속 전송되지만, 지금은 영향을 받는 필드에 대한 올바른 데이터가 표시됩니다.
OPTASK
  • rootGroupID
이 개체에서 매개 변수 값이 업데이트되면 UPDATE 이벤트에 영향을 받는 필드가 null에서 ID value(으)로 잘못 표시되었습니다.
모든 UPDATE 이벤트에 영향을 받는 필드에 대한 올바른 값이 표시됩니다.
없음. 영향을 받는 필드에 필터가 있는 경우 UPDATE 이벤트는 해당 필드가 실제로 변경된 경우에만 수신되며, 다른 매개 변수 값이 변경된 경우에는 수신되지 않습니다.
  • resolveProjectID
  • resolveTaskID
  • resolvingObjID
이 개체가 업데이트되면 UPDATE 이벤트에 영향을 받는 필드가 null에서 ID value(으)로 변경되는 것으로 잘못 표시되기도 합니다.
모든 UPDATE 이벤트에 영향을 받는 필드에 대한 올바른 값이 표시됩니다.
프로젝트
  • rootGroupID
이 개체에서 매개 변수 값이 업데이트되면 UPDATE 이벤트에 영향을 받는 필드가 null에서 ID value(으)로 잘못 표시되었습니다.
모든 UPDATE 이벤트에 영향을 받는 필드에 대한 올바른 값이 표시됩니다.
없음. 영향을 받는 필드에 필터가 있는 경우 UPDATE 이벤트는 해당 필드가 실제로 변경된 경우에만 수신되며, 다른 매개 변수 값이 변경된 경우에는 수신되지 않습니다.
  • convertedOpTaskID
이 개체가 업데이트되면 UPDATE 이벤트에 영향을 받는 필드가 null에서 ID value(으)로 변경되는 것으로 잘못 표시되기도 합니다.
모든 UPDATE 이벤트에 영향을 받는 필드에 대한 올바른 값이 표시됩니다.
없음. 영향을 받는 필드에 필터가 있는 경우 UPDATE 이벤트는 해당 필드가 실제로 변경된 경우에만 수신되며, 다른 매개 변수 값이 변경된 경우에는 수신되지 않습니다.
작업
  • rootGroupID
이 개체에서 매개 변수 값이 업데이트되면 UPDATE 이벤트에 영향을 받는 필드가 null에서 ID value(으)로 잘못 표시되었습니다.
모든 UPDATE 이벤트에 영향을 받는 필드에 대한 올바른 값이 표시됩니다.
없음. 영향을 받는 필드에 필터가 있는 경우 UPDATE 이벤트는 해당 필드가 실제로 변경된 경우에만 수신되며, 다른 매개 변수 값이 변경된 경우에는 수신되지 않습니다.
  • convertedOpTaskID
이 개체가 업데이트되면 UPDATE 이벤트에 영향을 받는 필드가 null에서 ID value(으)로 변경되는 것으로 잘못 표시되기도 합니다.
모든 UPDATE 이벤트에 영향을 받는 필드에 대한 올바른 값이 표시됩니다.
없음. 영향을 받는 필드에 필터가 있는 경우 UPDATE 이벤트는 해당 필드가 실제로 변경된 경우에만 수신되며, 다른 매개 변수 값이 변경된 경우에는 수신되지 않습니다.

Workfront Fusion 시나리오에서 이벤트 구독 버전 업데이트

Workfront Fusion은 이벤트 구독을 사용하여 Workfront의 변경 사항을 살펴보고 시나리오를 트리거합니다. Workfront > 이벤트 페이로드 버전 업데이트 모듈을 사용하여 Fusion이 시나리오에서 직접 사용하는 이벤트 구독 버전을 업데이트할 수 있습니다.

이 모듈 사용에 대한 지침은 Workfront Fusion 설명서의 Workfront 모듈을 참조하십시오.

웨비나 녹화를 포함하여 이벤트 구독 업그레이드 중에 Workfront Fusion 시나리오를 유지하는 방법에 대한 리소스는 이벤트 구독 V2 업그레이드 중에 Fusion 시나리오 유지를 참조하십시오.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43