API バージョン 12 の新機能
作成対象:
- 開発者
Workfront は、2020年11月12日(PT)に API バージョン 12 をリリースしました。API バージョン 12 では、バージョン 11 から次の変更が行われました。
追加されたリソース
Workfront API バージョン 12 で次の新しいリソースが追加されました。
BreadCrumb
BreadCrumb オブジェクトは、Adobe Workfront 作業アイテムの親子階層内の要素を表します。パンくずリストは、作業アイテムがポートフォリオ、プロジェクトおよびタスクの大きい構造にどのように適合するかを示します。
Workfront のパンくずリストについて詳しくは、新しい Adobe Workfront エクスペリエンスのパンくずリストの概要を参照してください。
- getObjectHierarchy
RichTextParameterValue
より多くのオブジェクトでリッチテキストフィールドを使用できるようになりました。この可用性をサポートするため、RichTextParameterValue オブジェクトが Workfront に追加されました。
詳しくは、Adobe Workfront API のリッチテキストフィールドを参照してください。
- ID
- ID
- objCode
削除されたリソース
API バージョン 12 ではリソースが削除されませんでした。
変更されたリソース
Workfront API バージョン 12 で次のリソースを変更しました。
AccessLevel
AccessLevel オブジェクトはユーザーに関連付けられていて、ユーザーのアクセス権を指定する AccessLevelPermissions のセットを表します。
アクセスレベルについて詳しくは、アクセスレベルの仕組みを参照してください。
AccessLevelPermissions
AccessLevelPermissions オブジェクトは、Workfront オブジェクトにアクセス、作成または変更を行うための特定の権限を表します。これらの権限は、アクセスレベルに関連付けることができます。
-
coreAction
次の possibleValues が追加されました。
-
PLANNED_HOURS_CONTERING
この権限を含むアクセスレベルを持つユーザーは、ワークロードバランサーで予定時間を更新できます。
詳しくは、ワークロードバランサーでのユーザー割り当ての管理のユーザー割り当て管理時にタスク予定時間数を更新を参照してください。
-
ADD_TO_CUSTOM_FORMS
この権限を含むアクセスレベルのユーザーは、カスタムフォームにフィールドを追加できます。
詳しくは、カスタムフォームの作成または編集を参照してください。
-
EDIT_SYSTEMWIDE
この権限を含むアクセスレベルを持つユーザーは、ユーザーフィールドをシステム全体で削除アクセス権と共有できます。
-
-
forbiddenActions
次の possibleValues が追加されました。
-
PLANNED_HOURS_CONTERING
-
ADD_TO_CUSTOM_FORMS
-
EDIT_SYSTEMWIDE
-
-
secondaryActions
次の possibleValues が追加されました。
-
PLANNED_HOURS_CONTERING
-
ADD_TO_CUSTOM_FORMS
-
EDIT_SYSTEMWIDE
-
AccessRequest
Workfront のオブジェクトに対する必要なアクセス権をユーザーが持っていない場合、そのオブジェクトへの利用申請を行うことができます。AccessRequest オブジェクトは、このリクエストを表します。
-
アクション
次の possibleValues が追加されました。
-
PLANNED_HOURS_CONTERING
この権限を含むアクセスレベルを持つユーザーは、ワークロードバランサーで予定時間を更新できます。
詳しくは、ワークロードバランサーでのユーザー割り当ての管理のユーザー割り当て管理時にタスク予定時間数を更新を参照してください。
-
ADD_TO_CUSTOM_FORMS
この権限を含むアクセスレベルのユーザーは、カスタムフォームにフィールドを追加できます。
詳しくは、カスタムフォームの作成または編集を参照してください。
-
EDIT_SYSTEMWIDE
この権限を含むアクセスレベルを持つユーザーは、ユーザーフィールドをシステム全体で削除アクセス権と共有できます。
-
AccessRule
AccessRule オブジェクトは、作成したプロジェクトをユーザーが共有する方法を決定する、カスタムアクセスレベルのルールセットを表します。
-
coreAction
次の possibleValues が追加されました。
-
PLANNED_HOURS_CONTERING
この権限を含むアクセスレベルを持つユーザーは、ワークロードバランサーで予定時間を更新できます。
詳しくは、ワークロードバランサーでのユーザー割り当ての管理のユーザー割り当て管理時にタスク予定時間数を更新を参照してください。
-
ADD_TO_CUSTOM_FORMS
この権限を含むアクセスレベルのユーザーは、カスタムフォームにフィールドを追加できます。
詳しくは、カスタムフォームの作成または編集を参照してください。
-
EDIT_SYSTEMWIDE
この権限を含むアクセスレベルを持つユーザーは、ユーザーフィールドをシステム全体で削除アクセス権と共有できます。
-
-
forbiddenActions
次の possibleValues が追加されました。
-
PLANNED_HOURS_CONTERING
-
ADD_TO_CUSTOM_FORMS
-
EDIT_SYSTEMWIDE
-
-
secondaryActions
次の possibleValues が追加されました。
-
PLANNED_HOURS_CONTERING
-
ADD_TO_CUSTOM_FORMS
-
EDIT_SYSTEMWIDE
-
ActivityLog
ActivityLog オブジェクトは、特定の Workfront Proof アカウントで発生したすべてのアクティビティの完全なリストです。
次の操作が ActivityLog オブジェクトから削除されました。
- ADD
AnnouncementAttachment
AnnouncementAttachment オブジェクトは、Workfront のお知らせに添付されたファイルを表します。
お知らせの添付ファイルについて詳しくは、お知らせの送信を参照してください。
-
fileExtension
次の値を追加しました。
-
qdoc (enum.fileextension.qdoc)
-
qslides (enum.fileextension.qslides)
-
qsheet (enum.fileextension.qsheet)
-
承認
タスク、ドキュメント、タイムシートなどの所定の作業アイテムは、上司または他のユーザーが承認することが必要な場合があります。承認オブジェクトは、作業アイテムに対する承認の操作を表します。
-
backlogOrder
次のフラグを削除しました。
-
DYNAMIC
-
LAZY_READ
-
NOT_GROUPABLE
-
-
groupID
次のフラグを追加しました。
-
AUTO_LOAD
-
DYNAMIC
-
READ_ONLY
-
-
workEffort
このフィールドは、タスクを完了するためにユーザーが 1 日にあたりに必要とする作業量が小、中、大のどれになるかを表します。次の値を指定できます。
-
1(小)
-
2(中)
-
3(大)
Workfront の作業量について詳しくは、作業量の概要を参照してください。
-
カレンダーレポートでカスタム日付を使用する新機能をサポートするために、次のフィールドが CalendarSection オブジェクトに追加されました。
詳しくは、カレンダーレポートでのカスタム日付フィールドの使用を参照してください。
-
customDate
-
customEndDateParameterID
-
customStartDateParameterID
-
ignoreActualDates
-
groupID
会社が関連付けられているグループの ID。
-
グループ
会社が関連付けられているグループ。会社をグループに関連付けると、グループ管理者はグループアクセスと会社に対する権限を拡張できます。
顧客
顧客オブジェクトは、Workfront のインスタンスを使用する組織を表します。
-
productEnabled
このアクションは、引数 CustomerProductTypeEnum を受け取り、その顧客がその製品のアカウントを持っているかどうかを示すブール値を返します。
CustomerPreferences
CustomerPreferences オブジェクトは、Workfront のインスタンスに対して顧客が設定した一連の環境設定を表します。
-
名前
次の値を追加しました。
- password:zoomIntegrationEnabled(更新ストリームで Zoom 統合を有効にする)
- password:quipIntegrationEnabled(config.general.quip.enabled)
ドキュメント
Document オブジェクトは、ファイル(書かれた資料、画像、その他の形式の情報など)を表します。
-
createLinkedProofVersion
追加済み
DocumentVersion
DocumentVersion オブジェクトは、ファイルの特定のバージョン(書き込まれた資料、画像、その他の形式の情報など)を表します。
ドキュメントのバージョンについて詳しくは、新しいバージョンのドキュメントのアップロードを参照してください。
-
externalIntegrationType
可能性のある値を削除しました:
- QUIP(Quip)
-
proofDecision
追加済み
次のアクションがドキュメントオブジェクトに追加されました。
-
getDocumentReviewerDecision
このアクションは、documentVersonID 引数(文字列)を受け取り、レビュアーの決定を示すマップを返します。
-
setDocumentReviewerDecision
このアクションは、次の引数を受け取ります。
-
documentVersionID(文字列)
-
reviewerDecision(文字列)
-
comment (string)
-
グループ
グループオブジェクトは、一連のユーザーとチームを表します。グループは、多くの場合、部門の構造を表します。
-
businessLeaderID
グループに割り当てられたビジネスリーダーの ID。
-
businessLeader
グループに割り当てられたビジネスリーダー。ビジネスリーダーとは、グループのビジネス上の決定を行う人物のことです。
ビジネスリーダーについて詳しくは、ビジネスリーダーの概要を参照してください。
-
assignMultiple
このアクションは、次の引数を受け取ります。
-
userIDs (string[])
-
roleIDs (string[])
-
teamID (string)
-
-
getGroupMembers
-
updateMembersList
このアクションは、次の引数を受け取ります。
-
newMemberIDs (string[])
-
removedMemberDs (string[])
-
LinkedFolder
LinkedFolder オブジェクトは、Google Drive や Dropbox など、外部のドキュメントプロバイダからリンクされたフォルダーを表します。
リンクされたフォルダーの詳細情報については、外部アプリケーションからドキュメントをリンクを参照してください。
-
externalIntegrationType
可能性のある値を削除しました:
- QUIP(Quip)
OpTask
OpTask オブジェクトは、一般にイシューと呼ばれます。イシューは、通常、タスクまたはプロジェクトを完了できない問題があることを示す作業アイテムです。イシューは、ヘルプデスクへのリクエストである場合もあります。変更指示、リクエスト、バグもイシューです。
-
backlogOrder
順序は、アジャイルバックログ上のタスクまたはストーリーの位置を示します。
このフィールドは、次のフラグを削除しました。
- DYNAMIC
- LAZY_READ
- NOT_GROUPABLE
これらのアクションでは、引数のステータスが追加され、新しい「開始」ボタン機能をサポートするようになりました。この機能は、ユーザーがボタンをクリックして、アイテムの作業を開始したことを示す作業アイテムのステータスを変更します。
詳しくは、「作業をする」ボタンを「開始」ボタンに置き換えを参照してください。
-
acceptWork
-
unacceptWork
パラメーター
パラメーターオブジェクトは、カスタムフィールドです。
パラメーターリソースにより、フラグ SHARABLE が追加されました。
カスタムフィールドについて詳しくは、カスタムフォームの作成または編集でカスタムフォームの作成または編集を参照してください。
-
dataType
次の値を追加できます。
-
RICH(リッチテキスト)
詳しくは、Adobe Workfront API のリッチテキストフィールドを参照してください。
-
-
displayType
次の値を追加できます。
-
RICH(書式付きテキストフィールド)
詳しくは、Adobe Workfront API のリッチテキストフィールドを参照してください。
-
-
ラベル
追加済み
-
accessRules
追加済み
-
ラベル
追加済み
ポートフォリオ
ポートフォリオオブジェクトは、同じリソース(通常はプロジェクトを完了するための資金や人材)を競い合って完了するプロジェクトのコレクションです。
ポートフォリオについて詳しくは、Adobe Workfront の Portfolio の概要を参照してください。
-
groupID
ポートフォリオが関連付けられているグループの ID。
-
グループ
ポートフォリオが関連付けられているグループ。
プログラム
プログラムオブジェクトは、ポートフォリオ内のプロジェクトのサブセットで、類似のプロジェクトを 1 つにグループ化できます。
-
groupID
プログラムが関連付けられているグループの ID。
-
グループ
プログラムが関連付けられているグループ。
QueueDef
QueueDef オブジェクトは、キューを表します。キューは、ユーザーがイシューを送信できるようにヘルプデスクエリアに公開されたプロジェクトです。
リクエストキューについて詳しくは、リクエストキューの作成を参照してください。
-
requestorCoreAction
次の possibleValues が追加されました。
-
PLANNED_HOURS_CONTERING
この権限を含むアクセスレベルを持つユーザーは、ワークロードバランサーで予定時間を更新できます。
詳しくは、ワークロードバランサーでのユーザー割り当ての管理のユーザー割り当て管理時にタスク予定時間数を更新を参照してください。
-
ADD_TO_CUSTOM_FORMS
この権限を含むアクセスレベルのユーザーは、カスタムフォームにフィールドを追加できます。
詳しくは、カスタムフォームの作成または編集を参照してください。
-
EDIT_SYSTEMWIDE
この権限を含むアクセスレベルを持つユーザーは、ユーザーフィールドをシステム全体で削除アクセス権と共有できます。
-
PLANNED_HOURS_CONTERING
-
ADD_TO_CUSTOM_FORMS
-
EDIT_SYSTEMWIDE
-
-
ScheduledReport
ScheduledReport オブジェクトは、配信のスケジュールを設定したレポートを表します。
-
形式
次の値を追加しました。
-
qdoc (enum.fileextension.qdoc)
-
qslides (enum.fileextension.qslides)
-
qsheet (enum.fileextension.qsheet)
-
ScoreCardQuestion
ScoreCardQuestion オブジェクトは、スコアカードに追加された質問を表します。これらの質問は通常、ポートフォリオマネージャーが決定し、その回答によって、マネージャーはプロジェクトがポートフォリオの目標にどの程度適合しているかを理解できます。
スコアカードに関する質問について詳しくは、スコアカードを作成を参照してください。
-
displayType
可能な値 RICH(書式付きテキストフィールド)を追加しました
詳しくは、Adobe Workfront API のリッチテキストフィールドを参照してください。
タスク
タスクオブジェクトは、最終目標を達成する(プロジェクトの完了)ためのステップとして実行する必要がある作業項目を表します。
-
workEffort
このフィールドは、タスクを完了するためにユーザーが 1 日にあたりに必要とする作業量が小、中、大のどれになるかを表します。次の値を指定できます。
-
1(小)
-
2(中)
-
3(大)
Workfront の作業量について詳しくは、作業量の概要を参照してください。
-
これらのアクションでは、引数のステータスが追加され、新しい「開始」ボタン機能をサポートするようになりました。この機能は、ユーザーがボタンをクリックして、アイテムの作業を開始したことを示す作業アイテムのステータスを変更します。
詳しくは、「作業をする」ボタンを「開始」ボタンに置き換えを参照してください。
-
acceptWork
-
unacceptWork
チーム
チームオブジェクトは、作業アイテムに割り当てることができるユーザーの集まりです。
チームリソースに次のフィールドが追加されました。
-
groupID
このフィールドは、チームをグループに関連付けます。これにより、チームがグループの一部として識別され、グループ管理者がチームを管理できるようになります。
-
workOnItStatusChange
チームの「作業」ボタンが「開始」ボタンとして設定されているかどうかを示すブール値パラメーターです。チームのメンバーが「開始」ボタンをクリックして作業アイテムの作業を開始すると、その項目のステータスが「新規」からチーム設定に設定されたステータスに変わります。
-
次のフィールドでは、個々の作業アイテムの「開始」ボタンにカスタムステータスを指定できます。
-
workOnItOpTaskBugReportStatuses
-
workOnItOpTaskChangeOrderStatuses
-
workOnItOpTaskIssueStatuses
-
workOnItOpTaskRequestStatuses
workOnItTaskStatuses
「開始」ボタンについて詳しくは、「作業」ボタンを「開始」ボタンに置き換えを参照してください。
-
チームリソースに次のフィールドが追加されました。
- グループ
TemplateTask
TemplateTask オブジェクトは、テンプレートに含まれるタスクを表します。テンプレートタスクは、テンプレートが使用されるプロジェクト内のタスクになります。
テンプレートタスクについて詳しくは、テンプレートタスクの編集を参照ください。
-
workEffort
このフィールドは、タスクを完了するためにユーザーが 1 日にあたりに必要とする作業量が小、中、大のどれになるかを表します。次の値を指定できます。
-
1(小)
-
2(中)
-
3(大)
Workfront の作業量について詳しくは、作業量の概要を参照してください。
-
タイムシート
タイムシートオブジェクトは、タスク、プロジェクトおよびオーバーヘッド時間タイプの実際の時間数をユーザーが入力できる仮想タイムカードを表します。
タイムシートについて詳しくは、タイムシートの概要を参照してください。
次のフィールドは、タイムシートリソースから削除されました。
- objcode
アップデート
-
updateType
追加された可能な値は次のとおりです。
-
initiativeAdd (enum.updatetypeenum.initiativeadd)
-
initiativeEdit (enum.updatetypeenum.initiativeedit)
イニシアチブについて詳しくは、シナリオプランナーのイニシアチブの概要を参照してください。
-
ユーザー
ユーザーオブジェクトは、ログインしてシステムとやり取りできる Workfront アカウントを持つユーザーを表します。
ユーザーリソースに次のフィールドが追加されました。
-
actualDeactivationDate
ユーザーが非アクティブ化された日時を表します。
非アクティブ化されたユーザーについて詳しくは、ユーザーの非アクティブ化または再アクティブ化を参照してください。
-
alignAccessType
このフィールドには、Workfront Goals へのユーザーのアクセス権が表示されます。次の値を指定できます。
-
アクセスなし
-
表示
-
編集
-
ユーザーリソースに次のアクションが追加されました。
-
getUserAccessPermissionsByObjCode
このアクションは、次の引数を取ります。
-
ids(文字列)
-
objCode(文字列)
-
ワーク
作業オブジェクトは、Task と OpTask の両方が継承する共通のインターフェイスで、2 つの間で共通のコードを共有します。
-
backlogOrder
順序は、アジャイルバックログ上のタスクまたはストーリーの位置を示します。
このフィールドは、次のフラグを削除しました。
-
DYNAMIC
-
LAZY_READ
-
NOT_GROUPABLE
-
-
groupID
このフィールドには、次のフラグが追加されました。
-
AUTO_LOAD
-
DYNAMIC
-
READ_ONLY
-
-
workEffort
このフィールドは、タスクを完了するためにユーザーが 1 日にあたりに必要とする作業量が小、中、大のどれになるかを表します。次の値を指定できます。
-
1(小)
-
2(中)
-
3(大)
Workfront の作業量について詳しくは、作業量の概要を参照してください。
-