API バージョン 15 の新機能

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

追加されたリソース

イニシアチブ(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)

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
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43