API バージョン 15 の新機能

最終更新日： 2024年2月5日

トピック：

作成対象：

開発者

Adobe Workfront は、2022年6月14日（PT）に API バージョン 15 をリリースしました。API バージョン 15 では、バージョン 14 から以下の変更が行われました。

追加されたリソース

イニシアチブ（INITIV）
IssueDef（ISSDEF）
ObjectIntegration（OBJINT）
RichTextGroupParameterValue（GRCVAL）
TaskDef（TSKDEF）
UserApproval（USRAPV）

イニシアチブ（INITIV）

イニシアチブオブジェクトは、担当業務の種類と数、固定コスト、予定利益の見積もりを Workfront シナリオプランナーに作成します。

イニシアチブについて詳しくは、シナリオプランナーのイニシアチブの概要を参照してください。

直接フィールド	customerID これは内部オブジェクトです。期間 endDate と startDate の間の時間数。 endDate イニシアチブの予定完了日。 enteredByID リクエストを送信したユーザーに関連付けられた ID。 ID アクションに関連付けられた ID。 initiativeID イニシアチブに関連付けられた ID。 lastPublishedDate イニシアチブが Workfront シナリオプランナーで最後に公開された日付。 name イニシアチブの名前 planID イニシアチブに関連付けられたプランの ID。 planName イニシアチブに関連付けられたプランの名前。 projectID イニシアチブに関連付けられたプロジェクトの ID。 scenarioID イニシアチブに関連付けられた Workfront シナリオプランナーのシナリオの ID。 startDate イニシアチブの予定開始日。
参照フィールド	顧客 enteredBy プロジェクト
コアフィールド	ID name objCode
操作	カウント取得レポート検索

IssueDef（ISSDEF）

IssueDef オブジェクトは、イシューの形式に関する一連のデータを表します。このオブジェクトは、プロジェクトやテンプレートに添付でき、そのプロジェクトやテンプレートに追加されるイシューに影響を与えます。

直接フィールド	ID isInlineAddEnabled
コアフィールド	ID objCode

ObjectIntegration（OBJINT）

場合によっては、Workfront の作業アイテムを、外部ソフトウェア製品のオブジェクトに直接リンクすることができます。ObjectIntegration オブジェクトは、このリンクを表します。

直接フィールド

customerID

これは内部オブジェクトです。
entryDate

ObjectIntegration がWorkfront システムに入力された日時。
ID

特定の ObjectIntegration オブジェクトの一意の Workfront ID。
integrationType

ObjectIntegration オブジェクトがリンクを作成する外部ソフトウェア。次の値を指定できます。
- Jira
- Salesforce
- Anaplan
linkedObjectID
objID

ObjectIntegration が関連付けられた Workfront 内のオブジェクト。
objObjCode

ObjectIntegration が関連付けられた Workfront 内のオブジェクトのオブジェクトコード。
param1
param2
param3
URL

参照フィールド

顧客

コアフィールド

ID
objCode

TaskDef（TSKDEF）

TaskDef オブジェクトは、タスクの形式に関する一連のデータを表します。このオブジェクトは、プロジェクトやテンプレートに添付でき、そのプロジェクトやテンプレートに追加されるタスクに影響を与えます。

直接フィールド

autoCalcPlannedHours
ID

参照フィールド

defaultApprovalProcess

コレクションフィールド

objectCategories

コアフィールド

ID
objCode

UserApproval（USRAPV）

直接フィールド

approverID
customerID
ID
requestedDate
requestorID
ステータス
userID

参照フィールド

approver
customer
requestor
user

コアフィールド

ID
objCode

デフォルトのフィールド

approverID
requestorID
ステータス
userID

アクション

承認
却下

操作

追加
カウント
削除
取得
REPORT
検索

削除されたリソース

API バージョン 15 ではリソースが削除されませんでした。

変更されたリソース

AccessLevel（ACSLVL）
AccessLevelPermissions（ALVPER）
AccessRequest（ACSREQ）
AccessRule（ACSRUL）
Approval（APPROVAL）
Category（CTGY）
CategoryParameter（CTGYPA）
CustomerPreferences（CUSTPR）
DocumentFolder（DOCFDR）
DocumentVersion（DOCV）
グループ（GROUP）
JournalEntry（JRNLE）
LinkedFolder (LNKFDR)
OpTask / Issue（OPTASK）
Parameter（PARAM）
Portfolio（PORT）
Program（PRGM）
Project（PROJ）
QueueDef（QUED）
ScoreCardQuestion（SCOREQ）
Task（TASK）
Template（TMPL）
Timesheet（TSHET）
View（UIVIEW）
Update（UPDATE）
User （USER）
UserNote（USRNOT）
Work（WORK）

AccessLevel（ACSLVL）

AccessLevel オブジェクトはユーザーに関連付けられていて、ユーザーのアクセス権を指定する AccessLevelPermissions のセットを表します。

アクセスレベルについて詳しくは、アクセスレベルを参照してください。

直接フィールド

fieldAccessPrivileges（string[]）

追加された可能な値は次のとおりです。
- VTMAWMG（自分のグループと関連付けられたチームを表示）
- VALLTM（すべてのチームを表示）

AccessLevelPermissions（ALVPER）

AccessLevelPermissions オブジェクトは、Workfront オブジェクトにアクセス、作成または変更を行うための特定の権限を表します。これらの権限は、アクセスレベルに関連付けることができます。

直接フィールド

coreAction（string[]）

追加された可能な値は次のとおりです。
- EDIT_TEAMS_I_AM_ON（所属チームを編集）
- EDIT_TEAMS_I_GROUP_ADMIN（自分が管理するグループのチームを編集する（グループ管理者のみ））
forbiddenActions（string[]）

追加された可能な値は次のとおりです。
- EDIT_TEAMS_I_AM_ON（所属チームを編集）
- EDIT_TEAMS_I_GROUP_ADMIN（自分が管理するグループのチームを編集する（グループ管理者のみ））
secondaryActions（string[]）

追加された可能な値は次のとおりです。
- EDIT_TEAMS_I_AM_ON（所属チームを編集）
- EDIT_TEAMS_I_GROUP_ADMIN（自分が管理するグループのチームを編集する（グループ管理者のみ））

AccessRequest（ACSREQ）

Workfront のオブジェクトに対する必要なアクセス権をユーザーが持っていない場合、そのオブジェクトへの利用申請を行うことができます。AccessRequest オブジェクトは、このリクエストを表します。

直接フィールド

action（string）

追加された可能な値は次のとおりです。
- EDIT_TEAMS_I_AM_ON（所属チームを編集）
- EDIT_TEAMS_I_GROUP_ADMIN（自分が管理するグループのチームを編集する（グループ管理者のみ））
autoShareAction（文字列）

次の値を追加しました。
- WDL

AccessRule（ACSRUL）

AccessRule オブジェクトは、作成したプロジェクトをユーザーが共有する方法を決定する、カスタムアクセスレベルのルールセットを表します。

直接フィールド

coreAction（string[]）

追加された可能な値は次のとおりです。
- EDIT_TEAMS_I_AM_ON（所属チームを編集）
- EDIT_TEAMS_I_GROUP_ADMIN（自分が管理するグループのチームを編集する（グループ管理者のみ））
forbiddenActions（string[]）

追加された可能な値は次のとおりです。
- EDIT_TEAMS_I_AM_ON（所属チームを編集）
- EDIT_TEAMS_I_GROUP_ADMIN（自分が管理するグループのチームを編集する（グループ管理者のみ））
secondaryActions（string[]）

追加された可能な値は次のとおりです。
- EDIT_TEAMS_I_AM_ON（所属チームを編集）
- EDIT_TEAMS_I_GROUP_ADMIN（自分が管理するグループのチームを編集する（グループ管理者のみ））

Approval（APPROVAL）

タスク、ドキュメント、タイムシートなどの所定の作業アイテムは、上司または他のユーザーが承認することが必要な場合があります。承認オブジェクトは、作業アイテムに対する承認の操作を表します。

直接フィールド

resourcePlannerBudgetedHours

参照フィールド

イニシアチブ

追加済み。

イニシアチブオブジェクトは、担当業務の種類と数、固定コスト、予定利益の見積もりを Workfront シナリオプランナーに作成します。
issueDef

追加済み。
taskDef

追加済み。

コレクションフィールド

objectIntegrations

追加済み。

場合によっては、Workfront の作業アイテムを、外部ソフトウェア製品のオブジェクトに直接リンクすることができます。ObjectIntegration オブジェクトは、このリンクを表します。

Category（CTGY）

カテゴリオブジェクトはカスタムフォームです。

直接フィールド

catObjCode（文字列）

次の値を追加しました。
- GROUP（グループ）
objTypes（文字列 []）

追加済み。

このパラメーターは、カスタムフォームを添付できるオブジェクトの配列です。カスタムフォームを複数のタイプのオブジェクトに添付する機能をサポートするために追加されました。

使用可能な値を以下に示します。

CMPY、PORT、PRGM、PROJ、TASK、OPTASK、USER、DOCU、EXPNS、ITRN、BILL、GROUP

コレクションフィールド

objTypes（string[]）

追加済み。

このパラメーターは、カスタムフォームを添付できるオブジェクトの配列です。カスタムフォームを複数のタイプのオブジェクトに添付する機能をサポートするために追加されました。

使用可能な値を以下に示します。

CMPY、PORT、PRGM、PROJ、TASK、OPTASK、USER、DOCU、EXPNS、ITRN、BILL、GROUP

CategoryParameter（CTGYPA）

直接フィールド

hideFormulaFromDescription

追加済み。
journaledObjCodes

追加済み。
rawCustomExpression

追加済み。

CustomerPreferences（CUSTPR）

CustomerPreferences オブジェクトは、Workfront のインスタンスに対して顧客が設定した一連の環境設定を表します。

直接フィールド

name

以下の値を追加しました。
- password:sharePointV2IntegrationEnabled （SharePoint（Graph API）統合が有効）
  
  この値は、アップデートされた SharePoint 統合をサポートします。
- project.mgmt:default.project.allowcreatewithouttemplate （ユーザーがテンプレートを使用せずにプロジェクトを作成することを許可）
- project.mgmt:taskissue.delegate （config.taskissue.delegate）

DocumentFolder（DOCFDR）

ドキュメントをフォルダーに整理できます。個人用ドキュメントエリアに個人用フォルダーを作成できます。DocumentFolder オブジェクトは、これらのフォルダーのうちの 1 つを表します。

DocumentFolder オブジェクトにフラグ SHARABLE が追加されました。

DocumentVersion（DOCV）

DocumentVersion オブジェクトは、ファイルの特定のバージョン（書き込まれた資料、画像、その他の形式の情報など）を表します。

ドキュメントのバージョンについて詳しくは、新しいバージョンのドキュメントをアップロードを参照してください。

直接フィールド

externalIntegrationType

次の値が追加されました。
- SHAREPOINT_V2 （SharePoint（Graph API））
  
  この値は、アップデートされた SharePoint 統合をサポートします。

グループ（GROUP）

グループオブジェクトは、一連のユーザーとチームを表します。グループは、多くの場合、部門の構造を表します。

グループについて詳しくは、グループとチームを参照してください。

Group オブジェクトにフラグ DATA_EXTENDIBLE が追加されました

直接フィールド

以下のフィールドが追加されました。

categoryID

カテゴリはカスタムフォームです。このパラメーターは、カスタムフォームを Group オブジェクトに追加する機能をサポートするために追加されました。
isActive

オブジェクトが Active の場合は値 true を持ち、そうでない場合は false を持つブーリアン型パラメーターです。「アクティブ」に設定されたオブジェクトは、ドロップダウンメニューと先行入力フィールドに表示され、他のオブジェクトに添付できます。

参照フィールド

以下のフィールドが追加されました。

approver
customer
requestor
user

コレクションフィールド

以下のフィールドが追加されました。

objectCategories
objectIntegrations

場合によっては、Workfront の作業アイテムを、外部ソフトウェア製品のオブジェクトに直接リンクすることができます。ObjectIntegration オブジェクトは、このリンクを表します。

デフォルトのフィールド

次のフィールドが追加されました。

isActive

オブジェクトが Active の場合は値 true を持ち、そうでない場合は false を持つブーリアン型パラメーターです。「アクティブ」に設定されたオブジェクトは、ドロップダウンメニューと先行入力フィールドに表示され、他のオブジェクトに添付できます。

アクション

以下のフィールドが追加されました。

calculateDataExtension

このアクションにより、カスタムフォームフィールドの式が再計算されます。
completeGroupInfo
linkExternalObject
unlinkExternalObject

JournalEntry（JRNLE）

JournalEntry オブジェクトを設定して、特定のオブジェクトフィールドに関する情報を、それらのフィールドが変更されたときに記録することができます。フィールドをジャーナルエントリオブジェクトの一部としてログに記録するように設定すると、そのフィールドが変更されるたびに、対応するジャーナルエントリが作成されます。

直接フィールド

changeType

次の値が追加されました。

DW（Download）

LinkedFolder (LNKFDR)

LinkedFolder オブジェクトは、Google Drive や Dropbox など、外部のドキュメントプロバイダからリンクされたフォルダーを表します。

リンクされたフォルダについて詳しくは、外部アプリケーションからドキュメントをリンクを参照してください。

直接フィールド

externalIntegrationType

次の値が追加されました。
- SHAREPOINT_V2 （SharePoint（Graph API））
  
  この値は、アップデートされた SharePoint 統合をサポートします。

OpTask / Issue（OPTASK）

OpTask オブジェクトは、一般にイシューと呼ばれます。イシューは、通常、タスクまたはプロジェクトを完了できない問題があることを示す作業アイテムです。イシューは、ヘルプデスクへのリクエストである場合もあります。変更指示、リクエスト、バグもイシューです。

アクション

以下のアクションが追加されました。

bulkMoveWithOptions
getRequestPath

次のアクションが変更されました。

copyIssue

フィールドが追加されました parentID

Parameter（PARAM）

パラメーターオブジェクトは、カスタムフィールドです。

直接フィールド

次のフィールドが追加されました。

fieldDefinition

次のフィールドが変更されました。

dataType

使用可能な値 WIDGET （ウィジェット）を追加しました

この値は、カスタムフォームでの画像の使用をサポートします。
displayType

使用可能な値 WIDGET （ウィジェット）を追加しました

この値は、カスタムフォームでの画像の使用をサポートします。

Portfolio（PORT）

ポートフォリオオブジェクトは、同じリソース（通常はプロジェクトを完了するための資金や人材）を競い合って完了するプロジェクトのコレクションです。

コレクションフィールド

objectIntegrations

アクション

linkExternalObject
unlinkExternalObject

Program（PRGM）

プログラムオブジェクトは、ポートフォリオ内のプロジェクトのサブセットで、類似のプロジェクトを 1 つにグループ化できます。

コレクションフィールド

objectIntegrations

アクション

linkExternalObject
unlinkExternalObject

Project（PROJ）

プロジェクトは Workfront 内の作業アイテムで、Workfront が人々の作業を支援するための主要な構築ブロックです。プロジェクトオブジェクトは、共通の特定の目標を持つタスクのグループを表します。

直接フィールド

resourcePlannerBudgetedHours

参照フィールド

initiative

イニシアチブオブジェクトは、担当業務の種類と数、固定コスト、予定利益の見積もりを Workfront シナリオプランナーに作成します。
issueDef
taskDef

コレクションフィールド

objectIntegrations

場合によっては、Workfront の作業アイテムを、外部ソフトウェア製品のオブジェクトに直接リンクすることができます。ObjectIntegration オブジェクトは、このリンクを表します。

QueueDef（QUED）

QueueDef オブジェクトは、キューを表します。キューは、ユーザーがイシューを送信できるようにヘルプデスクエリアに公開されたプロジェクトです。

リクエストキューについて詳しくは、リクエストキューの作成を参照してください。

直接フィールド

requestorCoreAction

追加された可能な値は次のとおりです。
- EDIT_TEAMS_I_AM_ON（所属チームを編集）
- EDIT_TEAMS_I_GROUP_ADMIN（自分が管理するグループのチームを編集する（グループ管理者のみ））
requestorForbiddenActions

追加された可能な値は次のとおりです。
- EDIT_TEAMS_I_AM_ON（所属チームを編集）
- EDIT_TEAMS_I_GROUP_ADMIN（自分が管理するグループのチームを編集する（グループ管理者のみ））

ScoreCardQuestion（SCOREQ）

ScoreCardQuestion オブジェクトは、スコアカードに追加された質問を表します。これらの質問は通常、ポートフォリオマネージャーが決定し、その回答によって、マネージャーはプロジェクトがポートフォリオの目標にどの程度適合しているかを理解できます。

スコアカードに関する質問について詳しくは、スコアカードを作成を参照してください。

直接フィールド

displayType

可能な値 WIDGET （ウィジェット）を追加しました。

Task（TASK）

タスクオブジェクトは、最終目標を達成する（プロジェクトの完了）ためのステップとして実行する必要がある作業項目を表します。

コレクションフィールド

objectIntegrations

場合によっては、Workfront の作業アイテムを、外部ソフトウェア製品のオブジェクトに直接リンクすることができます。ObjectIntegration オブジェクトは、このリンクを表します。

Template（TMPL）

テンプレートオブジェクトは、プロジェクトのパターンを表します。プロジェクトをテンプレートから作成することで時間を節約できます。テンプレートにはチームとタスクが含まれ、テンプレートから作成されたすべてのプロジェクトにコピーされます。

参照フィールド

issueDef
taskDef

Timesheet（TSHET）

Timesheet オブジェクトは、タスク、プロジェクトおよびオーバーヘッド時間タイプに対して行った実際の時間数をユーザーが入力できる仮想タイムカードを表します。

コアフィールド

次のフィールドが削除されました。

objCode

View（UIVIEW）

直接フィールド

uiviewType

次の可能な値が削除されました。
- FOUR_COL （4 カラムレイアウト）
- UPDATES （更新）
- UPDATESTOOLBAR_FEED （更新）
- WORKINGON （作業中）
- CUSTOMDATA （カスタムデータ）
- CUSTOMDATA_UPDATE （カスタムデータの更新）
- STATUS_UPDATE （ステータスの更新）
- OPTASK_STATUS_UPDATE （ステータスの更新）
- PROJ_STATUS_UPDATE （ステータスの更新）
- PROJECT_TIMEENTRY （ステータスの更新）
- DLIST （詳細リスト）
- DLIST_SECTION （詳細リストセクション）

Update（UPDATE）

Workfront の作業アイテムを更新して、ユーザーに現在のステータスを知らせることができます。更新オブジェクトは、これらの更新の 1 つを表します。更新は、ユーザーが入力するか、Workfront システムが作成することができます。

直接フィールド

updateType

可能な値 documentVersionDownload （enum.updatetypeenum.documentversiondownload）を追加しました。

User （USER）

ユーザーオブジェクトは、ログインしてシステムとやり取りできる Workfront アカウントを持つユーザーを表します。

参照フィールド

userApproval

アクション

getUsersAvailableTime
resetRopgPassword

UserNote（USRNOT）

UserNote オブジェクトは通知です。

直接フィールド

eventType

追加された可能な値は次のとおりです。
- DUP （このドキュメントをプルーフするようにリクエストしました）
- DUV （ドキュメントの表示を許可します）

Work（WORK）

作業オブジェクトは、Task と OpTask の両方が継承する共通のインターフェイスで、2 つの間で共通のコードを共有します。

コレクションフィールド

objectIntegrations

場合によっては、Workfront の作業アイテムを、外部ソフトウェア製品のオブジェクトに直接リンクすることができます。ObjectIntegration オブジェクトは、このリンクを表します。

recommendation-more-help