설명서WorkfrontWorkfront 안내서

API 버전 12의 새로운 기능

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 개발자

Workfront은 2020년 11월 12일에 API 버전 12를 출시했습니다. API 버전 12에는 버전 11의 다음 변경 사항이 포함되어 있습니다

추가된 리소스

다음 리소스는 Workfront API 버전 12의 새로운 리소스입니다.

빵 부스러기 breadcrumb

BreadCrumb 개체는 Adobe Workfront 작업 항목의 상위/하위 계층에 있는 요소를 나타냅니다. 이동 경로는 작업 항목이 더 큰 구조의 Portfolio, 프로젝트, 프로젝트 및 작업에 어떻게 적합한지 나타냅니다.

Workfront의 이동 경로에 대한 자세한 내용은 새 Adobe Workfront 환경의 이동 경로 개요를 참조하십시오.

  • getObjectHierarchy

리치 텍스트 매개 변수 값 richtextparametervalue

이제 더 많은 오브젝트에서 서식 있는 텍스트 필드를 사용할 수 있습니다. 이 가용성을 지원하기 위해 RichTextParameterValue 개체가 Workfront에 추가되었습니다.

자세한 내용은 Adobe Workfront API의 서식 있는 텍스트 필드를 참조하십시오.

  • ID
  • ID
  • objCode

제거된 리소스

API 버전 12에 대해 제거된 리소스가 없습니다.

수정된 리소스

Workfront API 버전 12에 대해 다음 리소스가 수정되었습니다.

AccessLevel accesslevel

AccessLevel 개체는 사용자와 연결되어 있으며 사용자가 액세스할 수 있는 항목을 결정하는 AccessLevelPermissions 집합에 대해 설명합니다.

액세스 수준에 대한 자세한 내용은 액세스 수준 작동 방식을 참조하세요.

액세스 수준 권한 accesslevelpermissions

AccessLevelPermissions 개체는 Workfront 개체에 액세스, 만들기 또는 수정할 수 있는 특정 권한을 나타냅니다. 그런 다음 이러한 권한을 액세스 수준과 연결할 수 있습니다.

직접 필드

  • coreAction

    다음 possibleValues가 추가되었습니다.

  • forbiddenActions

    다음 possibleValues가 추가되었습니다.

    • PLANNED_HOURS_CONTOURING

    • ADD_TO_CUSTOM_FORMS

    • 시스템 전체 편집

  • secondaryActions

    다음 possibleValues가 추가되었습니다.

    • PLANNED_HOURS_CONTOURING

    • ADD_TO_CUSTOM_FORMS

    • 시스템 전체 편집

AccessRequest accessrequest

사용자에게 Workfront의 필요한 오브젝트에 대한 액세스 권한이 없는 경우 해당 오브젝트에 대한 액세스를 요청할 수 있습니다. AccessRequest 개체는 이 요청을 나타냅니다.

직접 필드

  • 작업

    다음 possibleValues가 추가되었습니다.

AccessRule accessrule

AccessRule 개체는 사용자가 만드는 프로젝트를 공유할 수 있는 방법을 결정하는 사용자 지정 액세스 수준에 설정된 규칙을 나타냅니다.

직접 필드

  • coreAction

    다음 possibleValues가 추가되었습니다.

  • forbiddenActions

    다음 possibleValues가 추가되었습니다.

    • PLANNED_HOURS_CONTOURING

    • ADD_TO_CUSTOM_FORMS

    • 시스템 전체 편집

  • secondaryActions

    다음 possibleValues가 추가되었습니다.

    • PLANNED_HOURS_CONTOURING

    • ADD_TO_CUSTOM_FORMS

    • 시스템 전체 편집

ActivityLog activitylog

ActivityLog 개체는 주어진 Workfront Proof 계정에서 발생한 모든 활동의 전체 목록입니다.

작업

다음 작업이 ActivityLog 개체에서 제거되었습니다.

  • 추가

공지 첨부 파일 announcementattachment

AnnouncementAttachment 객체는 Workfront 공지에 첨부된 파일을 나타냅니다.

공지 첨부 파일에 대한 자세한 내용은 공지 보내기를 참조하십시오.

직접 필드

  • 파일 확장명

    가능한 값이 추가되었습니다.

    • qdoc (enum.fileextension.qdoc)

    • qslides(enum.fileextension.qslides)

    • qsheet (enum.fileextension.qsheet)

승인 approval

작업, 문서 또는 타임시트와 같은 특정 작업 항목에서는 감독자 또는 다른 사용자가 해당 작업 항목을 승인해야 할 수 있습니다. 승인 오브젝트는 작업 항목에 대한 사인오프 작업을 나타냅니다.

직접 필드

  • backlogOrder

    다음 플래그가 제거되었습니다.

    • 동적,

    • 레이지 읽기,

    • NOT_GROUPABLE

  • groupID

    다음 플래그가 추가되었습니다

    • 자동 로드,

    • 동적,

    • READ_ONLY

  • 작업 노력

    이 필드가 추가되었으며, 사용자가 작업을 완료하는 데 일일 작업량이 작은지, 중간인지 또는 큰지 여부를 나타냅니다. 가능한 값:

    • 1(작음)

    • 2(Medium)

    • 3(큼)

    Workfront의 작업 노력에 대한 자세한 내용은 작업 노력 개요를 참조하세요.

CalendarSection calendarsection

캘린더 섹션은 캘린더 보고서입니다.

일정 보고서에 대한 자세한 내용은 일정 보고서 개요를 참조하십시오.

직접 필드

달력 보고서에서 사용자 지정 날짜를 사용하는 새로운 기능을 지원하기 위해 다음 필드가 CalendarSection 개체에 추가되었습니다.

자세한 내용은 일정 보고서에서 사용자 지정 날짜 필드 사용을 참조하세요.

  • customDate

  • customEndDateParameterID

  • customStartDateParameterID

  • ignoreActualDate

회사 company

Company 객체는 사람들의 컬렉션으로 구성된 조직을 나타냅니다.

회사에 대한 자세한 내용은 회사 만들기 및 편집을 참조하세요.

직접 필드

  • groupID

    회사가 연계된 그룹의 ID.

참조 필드

  • 그룹

    회사가 연계된 그룹. 회사를 그룹과 연결하면 그룹 관리자는 회사에 대한 그룹 액세스 및 권한을 확장할 수 있습니다.

고객 customer

Customer 개체는 Workfront 인스턴스를 사용하는 조직을 나타냅니다.

액션

  • productEnabled

    이 작업은 CustomerProductTypeEnum 인수를 취하고 해당 고객에 해당 제품에 대한 계정이 있는지 여부를 나타내는 부울을 반환합니다.

고객 환경 설정 customerpreferences

CustomerPreferences 객체는 고객이 Workfront 인스턴스에 대해 설정한 환경 설정 집합을 나타냅니다.

직접 필드

  • 이름

    가능한 값이 추가되었습니다.

    • password:zoomIntegrationEnabled (업데이트 스트림에서 확대/축소 통합 활성화)
    • password:quipIntegrationEnabled (config.general.quip.enabled)

문서 document

Document 객체는 파일(예: 작성된 자료, 이미지 또는 기타 정보 형식)을 나타냅니다.

액션

  • createLinkedProofVersion

    추가됨

DocumentVersion documentversion

DocumentVersion 개체는 작성된 자료, 이미지 또는 다른 형태의 정보 등 파일의 특정 버전을 나타냅니다.

문서 버전에 대한 자세한 내용은 새 문서 버전 업로드를 참조하십시오.

직접 필드

  • externalIntegrationType

    제거된 가능한 값:

    • QUIP(Quip)

  • proofDecision

    추가됨

액션

Document 객체에 다음과 같은 작업이 추가되었습니다.

  • getDocumentReviewerDecision

    이 작업은 documentVersonID 인수(문자열)를 가져와 검토자의 결정을 나타내는 맵을 반환합니다.

  • setDocumentReviewerDecision

    이 작업은 다음 인수를 사용합니다.

    • documentVersionID (문자열)

    • reviewerDecision (string)

    • 주석(문자열)

그룹 group

Group 객체는 사용자 및 팀 집합을 나타냅니다. 그룹은 종종 부서 구조를 나타냅니다.

직접 필드

  • businessLeaderID

    그룹에 할당된 비즈니스 리더의 ID입니다.

참조 필드

  • businessLeader

    그룹에 할당된 비즈니스 리더입니다. 비즈니스 리더는 그룹을 위해 비즈니스 결정을 내리는 사람입니다.

    비즈니스 리더에 대한 자세한 내용은 비즈니스 리더 개요를 참조하십시오.

액션

  • assignMultiple

    이 작업은 다음 인수를 사용합니다.

    • userIDs (string[])

    • roleIDs (string[])

    • teamID (문자열)

  • getGroupMembers

  • updateMembersList

    이 작업은 다음 인수를 사용합니다.

    • newMemberIDs (string[])

    • removedMemberDs (string[])

LinkedFolder linkedfolder

LinkedFolder 개체는 Google 드라이브 또는 Dropbox과 같은 외부 문서 공급자로부터 연결된 폴더를 나타냅니다.

연결된 폴더에 대한 자세한 내용은 외부 응용 프로그램에서 문서 연결을 참조하세요.

직접 필드

  • externalIntegrationType

    제거된 가능한 값:

    • QUIP(Quip)

OpTask optask

OpTask 객체를 일반적으로 문제라고 합니다. 문제는 일반적으로 작업 또는 프로젝트의 완료를 방해하는 문제가 있음을 나타내는 작업 항목입니다. 문제는 헬프 데스크 요청일 수도 있습니다. 변경 주문, 요청 및 버그도 문제가 됩니다.

직접 필드

  • backlogOrder

    순서는 애자일 백로그에 대한 작업 또는 스토리의 위치를 나타냅니다.

    이 필드에서 다음 플래그가 제거되었습니다.

    • 동적,
    • 레이지 읽기,
    • NOT_GROUPABLE:
액션

이러한 작업은 새 시작 버튼 기능을 지원하도록 인수 상태를 추가했습니다. 이 기능은 사용자가 버튼을 클릭하여 항목에 대한 작업을 시작했음을 나타낼 때 작업 항목의 상태를 변경합니다.

자세한 내용은 처리 중 단추를 시작 단추로 바꾸기를 참조하십시오.

  • acceptWork

  • unacceptWork

매개변수 parameter

Parameter 개체는 사용자 지정 필드입니다.

매개 변수 리소스가 SHARABLE 플래그를 추가했습니다.

사용자 정의 필드에 대한 자세한 내용은 사용자 정의 양식 만들기 또는 편집에서 사용자 정의 양식 만들기 또는 편집을 참조하십시오.

직접 필드
컬렉션 필드

  • accessRules

    추가됨

기본 필드

  • 레이블

    추가됨

Portfolio portfolio

Portfolio 객체는 동일한 리소스(일반적으로 돈 또는 완료하는 사람)에 대해 경쟁하는 프로젝트의 컬렉션입니다.

포트폴리오에 대한 자세한 내용은 Adobe Workfront의 Portfolio 개요를 참조하십시오.

직접 필드

  • groupID

    포트폴리오와 연결된 그룹의 ID입니다.

참조 필드

  • 그룹

    포트폴리오와 연결된 그룹입니다.

프로그램 program

프로그램 객체는 유사한 프로젝트를 함께 그룹화할 수 있는 포트폴리오 내의 프로젝트 하위 집합입니다.

직접 필드

  • groupID

    프로그램과 연계된 그룹의 ID.

참조 필드

  • 그룹

    프로그램과 연결된 그룹입니다.

QueueDef queuedef

QueueDef 개체는 사용자가 문제를 제출할 수 있도록 헬프 데스크 영역에 게시된 프로젝트인 Queue를 나타냅니다.

요청 대기열에 대한 자세한 내용은 요청 대기열 만들기를 참조하십시오.

직접 필드

  • requestorCoreAction

    다음 possibleValues가 추가되었습니다.

    • PLANNED_HOURS_CONTOURING

      이 권한을 포함하는 액세스 수준이 있는 사용자는 업무 균형자에서 계획된 시간을 업데이트할 수 있습니다.

      자세한 내용은 사용자 할당을 관리할 때 작업 계획 시간 업데이트(업무 균형자에서 사용자 할당 관리)를 참조하십시오.

    • ADD_TO_CUSTOM_FORMS

      이 권한을 포함하는 액세스 수준이 있는 사용자는 사용자 정의 양식에 필드를 추가할 수 있습니다.

      자세한 내용은 사용자 정의 양식 만들기 또는 편집을 참조하세요.

    • 시스템 전체 편집

      이 권한을 포함하는 액세스 수준이 있는 사용자는 삭제 액세스로 시스템 전체에 사용자 정의 필드를 공유할 수 있습니다.

      • PLANNED_HOURS_CONTOURING

      • ADD_TO_CUSTOM_FORMS

      • 시스템 전체 편집

예약된 보고서 scheduledreport

ScheduledReport 개체는 전송을 위해 예약되도록 구성된 보고서를 나타냅니다.

직접 필드

  • 형식

    가능한 값이 추가되었습니다.

    • qdoc (enum.fileextension.qdoc)

    • qslides(enum.fileextension.qslides)

    • qsheet (enum.fileextension.qsheet)

스코어카드 질문 scorecardquestion

ScoreCardQuestion 객체는 스코어카드에 추가된 질문을 나타냅니다. 이러한 질문은 일반적으로 Portfolio 관리자가 결정하며, 관리자는 이에 대한 답변을 통해 프로젝트가 포트폴리오의 목표에 얼마나 잘 부합하는지 파악할 수 있습니다.

스코어카드 질문에 대한 자세한 내용은 스코어카드 만들기를 참조하십시오.

직접 필드

작업 task

작업 객체는 최종 목표 달성(프로젝트 완료)을 위한 단계로 수행해야 하는 작업 항목을 나타냅니다.

직접 필드

  • 작업 노력

    이 필드가 추가되었으며, 사용자가 작업을 완료하는 데 일일 작업량이 작은지, 중간인지 또는 큰지 여부를 나타냅니다. 가능한 값:

    • 1(작음)

    • 2(Medium)

    • 3(큼)

    Workfront의 작업 노력에 대한 자세한 내용은 작업 노력 개요를 참조하세요.

액션

이러한 작업은 새 시작 버튼 기능을 지원하도록 인수 상태를 추가했습니다. 이 기능은 사용자가 버튼을 클릭하여 항목에 대한 작업을 시작했음을 나타낼 때 작업 항목의 상태를 변경합니다.

자세한 내용은 처리 중 단추를 시작 단추로 바꾸기를 참조하십시오.

  • acceptWork

  • unacceptWork

팀 team

팀 개체는 작업 항목에 할당할 수 있는 사용자 컬렉션입니다.

직접 필드

다음 필드가 팀 리소스에 추가되었습니다.

  • groupID

    이 필드는 팀을 그룹과 연결합니다. 이렇게 하면 팀을 그룹의 일부로 식별하고 그룹 관리자가 팀을 관리할 수 있습니다.

  • workOnItStatusChange

    팀의 [처리 중] 단추가 시작 단추로 구성되었는지 여부를 나타내는 부울 매개 변수입니다. 팀 구성원이 시작 단추를 클릭하여 작업 항목에 대한 작업을 시작하면 항목의 상태가 새로 만들기에서 팀 설정에 구성된 상태로 변경됩니다.

  • 다음 필드에서는 개별 작업 항목의 시작 단추에 대한 사용자 지정 상태를 지정할 수 있습니다.

    • workOnItOpTaskBugReportStatuses

    • workOnItOpTaskChangeOrderStatuses

    • workOnItOpTaskIssueStates

    • workOnItOpTaskRequestStates

      workOnItTaskStates

    시작 단추에 대한 자세한 내용은 작업 중 단추를 시작 단추로 바꾸기를 참조하십시오.

참조 필드

다음 필드가 팀 리소스에 추가되었습니다.

  • 그룹

TemplateTask templatetask

TemplateTask 개체는 Template의 일부인 작업을 나타냅니다. 템플릿 작업은 템플릿이 사용되는 프로젝트의 작업이 됩니다.

템플릿 작업에 대한 자세한 내용은 템플릿 작업 편집을 참조하십시오.

직접 필드

  • 작업 노력

    이 필드가 추가되었으며, 사용자가 작업을 완료하는 데 일일 작업량이 작은지, 중간인지 또는 큰지 여부를 나타냅니다. 가능한 값:

    • 1(작음)

    • 2(Medium)

    • 3(큼)

    Workfront의 작업 노력에 대한 자세한 내용은 작업 노력 개요를 참조하세요.

타임시트 timesheet

타임시트 오브젝트는 사용자가 작업, 프로젝트 및 오버헤드 시간 유형에 대한 실제 작업 시간을 입력할 수 있는 가상 타임카드를 나타냅니다.

타임시트에 대한 자세한 내용은 타임시트 개요를 참조하세요.

코어 필드

다음 필드가 타임시트 리소스에서 제거되었습니다.

  • objcode

업데이트

직접 필드

  • updateType

    다음과 같은 가능한 값이 추가되었습니다.

    • initiativeAdd (enum.updatetypeenum.initiativeadd)

    • initiativeEdit(enum.updatetypeenum.initiativeedit)

    이니셔티브에 대한 자세한 내용은 시나리오 플래너의 이니셔티브 개요를 참조하십시오.

사용자 user

사용자 개체는 로그인하여 시스템과 상호 작용할 수 있는 Workfront의 계정을 가진 사용자를 나타냅니다.

직접 필드

사용자 리소스에 다음 필드가 추가되었습니다.

  • actualDeactivationDate

    사용자가 비활성화된 날짜 및 시간을 나타냅니다.

    비활성화된 사용자에 대한 자세한 내용은 사용자 비활성화 또는 다시 활성화를 참조하십시오.

  • alignAccessType

    이 필드에는 Workfront 목표에 대한 사용자의 액세스 권한이 표시됩니다. 가능한 값:

    • 액세스 권한 없음

    • 보기

    • 편집

액션

다음 작업이 사용자 리소스에 추가되었습니다.

  • getUserAccessPermissionsByObjCode

    이 작업은 다음 인수를 사용합니다

    • id(문자열)

    • objCode (문자열)

작업 work

Work 개체는 Task와 OpTask가 모두 상속하는 공통 인터페이스이며 두 개체 간에 공통 코드를 공유합니다.

직접 필드

  • backlogOrder

    순서는 애자일 백로그에 대한 작업 또는 스토리의 위치를 나타냅니다.

    이 필드에서 다음 플래그가 제거되었습니다.

    • 동적,

    • 레이지 읽기,

    • NOT_GROUPABLE

  • groupID

    이 필드에는 다음 플래그가 추가되었습니다.

    • 자동 로드,

    • 동적,

    • READ_ONLY

  • 작업 노력

    이 필드가 추가되었으며, 사용자가 작업을 완료하는 데 일일 작업량이 작은지, 중간인지 또는 큰지 여부를 나타냅니다. 가능한 값:

    • 1(작음)

    • 2(Medium)

    • 3(큼)

    Workfront의 작업 노력에 대한 자세한 내용은 작업 노력 개요를 참조하세요.

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