API バージョン 13 の新機能

最終更新日： 2024年2月5日
  • トピック：

作成対象：

  • 開発者

Adobe Workfront は、2021年4月22日（PT）に API バージョン 13 をリリースしました。API バージョン 13 では、バージョン 12 から次の変更がおこなわれました。

追加されたリソース

API バージョン 13 で追加されたリソースはありません。

削除されたリソース

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

変更されたリソース

API バージョン 13 で次のリソースを変更しました。

AccessLevel

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

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

直接フィールド

  • 説明

    バリデーター MAX_LENGTH が追加されました。このバリデーターは、説明の長さが 4,000 文字以下にするように指定しています。

BreadCrumb オブジェクトは、Workfront 作業アイテムの親子階層内の要素を表します。パンくずリストは、作業アイテムがポートフォリオ、プロジェクトおよびタスクの大きい構造にどのように適合するかを示します。

パンくずリストについて詳しくは、新しい Adobe Workfront エクスペリエンスのパンくずリストの概要を参照してください。

直接フィールド

BurndownEvent

BurndownEvent オブジェクトは、イテレーションのバーンダウンを変更するオブジェクトを表します。

バーンダウンについて詳しくは、バーンダウンを参照してください。

直接フィールド

以下のフィールドから、NOT_GROUPABLE というフラグを削除しました。

  • applyDate

  • entryDate

CustomerPreferences

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

直接フィールド

  • 名前

    次の値を追加しました。

    • password:aemAPIKey (config.general.aem.apikey)
    • password:aemAADomain (config.general.aem.aadomain)
    • password:aemIntegrationEnabled (config.general.aem.enabled)
    • password:aemHost (config.general.aem.host)
    • timesheet:default.timesheet.restrict.timesheet.edit.owners.admins (config.timesheet.restrict.timesheet.edit.owners.admins)
アクション

CustomerPreferences リソースに以下のアクションが追加されました。

  • getTimesheetPreferences

  • setTimesheetPreferences

    引数を受け取ります。

    • 環境設定（マップ）

DocumentVersion

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

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

直接フィールド

  • externalIntegrationType

    次の値を追加できます。

    • AEM（Adobe Experience Manager）

  • proofID

    NOT_FILTERABLE フラグを追加

グループ

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

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

アクション

  • getParents

    このアクションは、グループの親グループ（指定されたグループがサブグループであるグループ）の配列を返します。

JournalEntry

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

JournalEntry リソースに REPORTABLE フラグを追加しました。

直接フィールド

次のフィールドから NOT_GROUPABLE フラグを削除しました。

  • changeType

  • entryDate

  • fieldName

  • objObjCode

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

  • subObjCode

  • subObjID

  • topObjCode

  • topObjID

LayoutTemplate

Adobe Workfront 管理者またはグループ管理者は、テンプレートを作成して、Adobe Workfront のレイアウト要素をカスタマイズできます。LayoutTemplate オブジェクトは、Adobe Workfront Classic に固有です。

新しい Adobe Workfrontエクスペリエンスでレイアウトテンプレートを表すオブジェクトについては、UITemplate を参照してください。

直接フィールド

  • 説明

    バリデーター MAX_LENGTH が追加されました。このバリデーターは、説明の長さが 4,000 文字以下にするように指定しています。

LinkedFolder

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

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

直接フィールド

  • externalIntegrationType

    次の値を追加できます。

    • AEM（Adobe Experience Manager）

OpTask

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

フィールドの検索
  • favoritedByUsersMM

プロジェクト

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

直接フィールド

ProofApproval

ProofApproval オブジェクトは、プルーフに直接接続される承認を表します。

直接フィールド

次のフィールドが ProofApproval リソースに追加されました。

  • approverStage

  • DecisionDate

  • workflowTemplate

QueueDef

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

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

直接フィールド

  • documentPosition

    追加済み。次の値を指定できます。

    • 0（カスタムフォームの後)

    • 1（カスタムフォームの前)

タスク

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

フィールドの検索
  • favoritedByUsersMM

チーム

チームオブジェクトは、作業アイテムに割り当てることができるユーザーの集まりです。

直接フィールド

  • isActive

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

デフォルトのフィールド

  • isActive

    追加済み

タイムシート

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

直接フィールド

  • isOvertimeDisabled

    追加済み

コアフィールド

  • objCode

    削除されました

TimesheetProfile

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

直接フィールド

  • isOvertimeDisabled

    追加済み

デフォルトのフィールド

  • isOvertimeDisabled

    追加済み

UITemplate

Adobe Workfront 管理者またはグループ管理者は、テンプレートを作成して、Adobe Workfront のレイアウト要素をカスタマイズできます。UITemplate オブジェクトは、新しい Adobe Workfront エクスペリエンスに固有のものです。

Adobe Workfront Classic のレイアウトテンプレートを表すオブジェクトについては、LayoutTemplate を参照してください。

アクション

UITemplate リソースに以下のアクションが追加されました。

  • migrateCustomersAllLayoutTemplates

    引数を受け取ります。

    • overrideIfExists（ブーリアン）

  • migrateLayoutTemplates

    引数を受け取ります。

    • layoutTemplateIDs（string[]）

    • overrideIfExists（ブーリアン）