API バージョン 17 の新機能
作成対象：
- 開発者
Adobe Workfront は、2023年10月12日（PT）に API バージョン 17 をリリースしました。API バージョン 17 では、バージョン 16 から次の変更が行われました。
追加されたリソース
ExternalDocument（EXTDOC）
ExternalDocument オブジェクトは、Workfront の外部にあるドキュメントストレージプロバイダーに置かれるドキュメントまたはその他のデジタルアセットです。これらのアセットは、Workfront との間でリンクできます。
| 直接フィールド |
|
| コアフィールド |
|
| デフォルトのフィールド |
|
| アクション |
|
| クエリ |
|
| 操作 |
|
UserLocation (USRLOC)
| 直接フィールド |
|
| 参照フィールド |
|
| コアフィールド |
|
削除されたリソース
API バージョン 17 で削除されたリソースはありません。
変更されたリソース
API バージョン 17 で次のリソースを変更しました。
Baseline（BLIN）
ベースラインは、特定の時点でのプロジェクトのパフォーマンスを示すスナップショットです。主要な日付、進捗状況、コスト、売上高など、プロジェクトに関する主要な情報が保存されています。
Baseline オブジェクトでは INLINE_EDITABLE フラグを削除しました。
BillingRecord（BILL）
BillingRecord オブジェクトは、請求可能な収益、時間または費用を記録します。この情報は、外部の会計システムで請求書を作成する際に使用できます。
BillingRecord オブジェクトでは INLINE_EDITABLE フラグを削除しました。
Company（CMPY）
会社オブジェクトは、人物の集まりで構成される組織を表します。
| 直接フィールド |
|
CustomerPreferences（CUSTPR）
CustomerPreferences オブジェクトは、Workfront のインスタンスに対して顧客が設定した一連の環境設定を表します。
| 直接フィールド |
|
DocumentVersion（DOCV）
DocumentVersion オブジェクトは、ファイルの特定のバージョン（書き込まれた資料、画像、その他の形式の情報など）を表します。
| 直接フィールド |
|
ExchangeRate（EXRATE）
ExchangeRate オブジェクトは、Workfrontで設定された通貨の為替レートを表します。 ExchangeRate オブジェクトは動的ではありません。
以下のフィールドが追加されました。
-
endDate
-
startDate
-
getCustomerCurrencies
追加済み。
Expense（EXPNS）
費用は、プロジェクトの存続中に発生する可能性のある役務以外の費用を表します。
Expense オブジェクトでは INLINE_EDITABLE フラグを削除しました。
グループ（GROUP）
グループオブジェクトは、一連のユーザーとチームを表します。グループは、多くの場合、部門の構造を表します。
-
defaultInterface
削除されました
Hour（HOUR）
Hour オブジェクトは、ユーザーがタイムシートに記録した時間を表します。
Hour オブジェクトでは INLINE_EDITABLE フラグを削除しました。
Iteration（ITRN）
イテレーションオブジェクトは、1 つのアジャイルイテレーションを表します。イテレーションとは、アジャイルストーリーの計画と完了に使用される、個別の期間です。
Iteration オブジェクトでは INLINE_EDITABLE フラグを削除しました。
JournalEntry（JRNLE）
JournalEntry オブジェクトを設定して、特定のオブジェクトフィールドに関する情報を、それらのフィールドが変更されたときに記録することができます。フィールドをジャーナルエントリオブジェクトの一部としてログに記録するように設定すると、そのフィールドが変更されるたびに、対応するジャーナルエントリが作成されます。
-
changeType
追加された可能な値は次のとおりです。
- 承認者追加（AAA）
- レビュアー追加（AAR）
- レビュアー削除（ARR）
- 承認者削除（ARA）
- 決定承認（ADA）
- 決定の変更後承認（ADC）
- 決定に作業が必要（AND）
- 決定取り消し（ADR）
- 承認者変更（AAC）
- レビュアー変更（ARC）
- レビュー完了（RDC）
- レビュー取り消し（RDR）
- 公開（PUB）
かんばんボード（KNBNBD）
かんばんボードは、アジャイル環境でタスクを追跡するために使用されます。
Kanban Board オブジェクトでは INLINE_EDITABLE フラグを削除しました。
LinkedFolder (LNKFDR)
LinkedFolder オブジェクトは、Google Drive や Dropbox など、外部のドキュメントプロバイダからリンクされたフォルダーを表します。
-
externalIntegrationType
可能な値「Frame.io」（FRAMEIO）を追加しました。
OpTask / Issue（OPTASK）
OpTask オブジェクトは、一般にイシューと呼ばれます。イシューは、通常、タスクまたはプロジェクトを完了できない問題があることを示す作業アイテムです。イシューは、ヘルプデスクへのリクエストである場合もあります。変更指示、リクエスト、バグもイシューです。
Issue オブジェクトでは INLINE_EDITABLE フラグを削除しました。
Project（PROJ）
プロジェクトは Workfront 内の作業アイテムで、Workfront が人々の作業を支援するための主要な構築ブロックです。プロジェクトオブジェクトは、共通の特定の目標を持つタスクのグループを表します。
Project オブジェクトでは INLINE_EDITABLE フラグを削除しました。
ProjectUser（PRTU）
ProjectUser オブジェクトは、特定のプロジェクトに関連付けられたユーザーを表します。
-
ID
追加済み。
-
ID
追加済み。
Rate（RATE）
Rate オブジェクトは、Workfront の請求料金を表します。
Rate オブジェクトでは INLINE_EDITABLE フラグを削除しました。
レートカード機能をサポートするために、次のアクションが追加されました。
-
deleteRateForRole
-
editRatesForRole
-
getUsedClassifierIds
-
setRatesFromRateCard
setRatesForRole アクションが変更され、次のフィールドが追加されました。
- classifierID
- currencyCode
- sourceRateCardID
Risk（RISK）
リスクオブジェクトは、プロジェクトが時間通りに完了しない、または予算内で終了しない可能性のあるイベントを表します。計画段階では、すべての作業の承認前に、潜在的な障害物を特定するためのリスクがプロジェクトに追加されます。
Risk オブジェクトでは INLINE_EDITABLE フラグを削除しました。
Role / Job Role（ROLE）
Role オブジェクト（担当業務）は、デザイナーやプロダクトマネージャーなど、ユーザーが入力できる機能またはスキルセットを表します。
-
defaultInterface
削除されました
Task（TASK）
タスクオブジェクトは、最終目標を達成する（プロジェクトの完了）ためのステップとして実行する必要がある作業項目を表します。
Task オブジェクトでは INLINE_EDITABLE フラグを削除しました。
Team（TEAMOB）
チームオブジェクトは、作業アイテムに割り当てることができるユーザーの集まりです。
-
defaultInterface
削除されました
TeamMember（TEAMMB）
TeamMember オブジェクトは、特定のチームに関連付けられたユーザーです。
-
ID
追加済み。
-
ID
追加済み。
TemplateUser（TMTU）
-
ID
追加済み。
-
ID
追加済み。
Timesheet（TSHET）
Timesheet オブジェクトは、タスク、プロジェクトおよびオーバーヘッド時間タイプに対して行った実際の時間数をユーザーが入力できる仮想タイムカードを表します。
-
objCode
削除されました
Update（UPDATE）
Workfront の作業アイテムを更新して、ユーザーに現在のステータスを知らせることができます。更新オブジェクトは、これらの更新の 1 つを表します。更新は、ユーザーが入力するか、Workfront システムが作成することができます。
-
changeType
以下の値を追加しました。
- 承認者追加（assetapprovalAddApprover）
- レビュアー追加（assetapprovalAddReviewer）
- 承認者削除（assetapprovalRemoveApprover）
- レビュアー削除（assetapprovalRemoveReviewer）
- 決定承認（assetapprovalDecisionApproved）
- 決定に作業が必要（assetapprovalDecisionNeedsWork）
- 決定の変更後承認（assetapprovalDecisionApprovedChanges）
- 決定取り消し（assetapprovalDecisionRevoked）
- 承認者変更（assetapprovalApproverChanged）
- レビュアー変更（assetapprovalReviewerChanged）
- レビュー完了（assetapprovalReviewerDecisionComplete）
- レビュー取り消し（assetapprovalReviewerDecisionRevoked）
- 外部ドキュメント送信エラー（externalDocumentSendError）
- ドキュメントバージョン公開済み（documentVersionPublish）
- リンクされたフォルダーワークフロー（linkedFolderWorkflow）
User （USER）
ユーザーオブジェクトは、ログインしてシステムとやり取りできる Workfront アカウントを持つユーザーを表します。
User オブジェクトでは INLINE_EDITABLE フラグを削除しました。
-
workTime
このフィールドが追加されました。ユーザーが 1 日にプロジェクト作業（間接作業以外の作業）に費やすことができる時間の割合を 0～1 の数値で表します。値が 1 の場合、ユーザーは時間の 100%をプロジェクトの作業に費やすことができます。
- userLocations
UserGroups (USRGPS)
-
ID
追加済み。
-
ID
追加済み。
UserNote（USRNOT）
UserNote オブジェクトは通知です。
-
changeType
以下の値を追加しました。
- ドキュメントにあなたの承認が必要です（AAA）
- ドキュメントにあなたのレビューが必要です（AAR）
- ドキュメントの承認は不要になりました（ARA）
- ドキュメントのレビューは不要になりました（ARR）
- ドキュメントに（ユーザー）の承認が必要です（ATA）
- ドキュメントに（ユーザー）のレビューが必要です（ATR）
- ドキュメントに（ユーザー）の承認は不要になりました（RTA）
- ドキュメントに（ユーザー）のレビューは不要になりました（RTR）
- ドキュメントが承認されました（ADA）
- ドキュメントが変更の上承認されました（ADC）
- ドキュメントには作業が必要です（ADN）
- （ユーザー）が（ドキュメント）を承認済みとしてマークしました。あなたの承認は不要になりました。（AAN）
- （ユーザー）が（ドキュメント）を変更の上承認済みとしてマークしました。あなたの承認は不要になりました。（ACN）
- （ユーザー）が（ドキュメント）を作業が必要としてマークしました。あなたの承認は不要になりました。（AWN）
- ドキュメントには、承認ではなく、今すぐあなたのレビューが必要です（AAC）
- ドキュメントには、レビューではなく、今すぐあなたの承認が必要です（ADN）
- ドキュメントをレビューしました（RDC）
- ドキュメントをレビューしました（TRC）
- （ユーザー）が（ドキュメント）をレビューして完了としました。あなたの承認は不要になりました。（TRN）
UserRole（USRROL）
-
ID
追加済み。
-
ID
追加済み。