跳至主要內容
文件
文件
Adaptive Planning
上次更新時間 ：2025-02-07
API 變更 - 依版本

API 變更 - 依版本

2025R1

(2025 年 2 月)
JSON 格式的 REST API

2024R2

(2024 年 9 月)
API v40 簡介
  • 已更新︰
    importModeledSheet
    現在支援選填
    accountCode
    內的屬性內容
    DisplayColumns
    元素該
    code
    的屬性
    DisplayColumn
     現在允許為欄建立可編輯的唯一 ID。時間
    accountCode
     未包含在要求中，我們會按程序產生唯一的
    code
     以將該欄連結至指定的科目。
  • 已更新︰
    exportModeledSheet
     現在支援選填
    accountCode
     內的屬性內容
    DisplayColumns
     元素該
    code
     的屬性
    DisplayColumn
     現在允許為欄建立可編輯的唯一 ID。
  • 已更新︰
    importConfigurableModelData
     已更正
    applyValidationRules
     說明，以指出預設值為
    true
    ，且從 v38 開始更新。
  • 已更新︰
    importStandardData
     現在支援
    splitsToUnsplit
     在
    importDataOptions
     元素，允許將拆分匯入具有現有資料的未拆分位置。
  • 已更新︰
    exportCalendar
     現在支援
    code
     在
    calendar
     元素
  • 已更新︰
    exportVersions
     現在支援
    currencyVersions
     在
    include
     元素這會啟用在回應中包含換算實際值的貨幣版本。您必須聯繫指定支援聯絡人，確認您的實例是否符合此功能的資格。
JSON 格式的 REST API
  • 建模服務
    • Time
      • /updateTime
         行事歷物件現在支援
        code
         存在代碼時。
    • Modeled Sheet Definition
      • /definition
        PATCH
         支援
        accountCode
         ，以確定顯示欄的模型科目。僅對顯示欄有效。唯一有效的值為模型工作表上的科目。
      • /definition
        PATCH
         支援
        code
         在工作表欄屬性物件中，加上科目代碼和次要 ID 的前綴。建立新工作表時為必填。其功能與
        prefix
        和 是用來比對使用者介面的偏好屬性。

2024R1

(2024 年 4 月)
  • 美國以外用戶的區域驗證︰
    If your instance uses non-US based, regional authentication, then your authorization URLs and API endpoints vary based on your region. See Reference: Regional Authentication URLs.
(2024 年 3 月)
API v39 簡介
  • 已更新︰
    exportData
     不再支援
    sheet
     API v39 及更高版本中的元素
  • 已更新︰
    exportData
     支援︰
    • 針對 API v39 及更高版本的效能和可擴充性最佳化路徑的所有元素和屬性內容。
    • 帳戶採用加權平均匯總，可提升 API v39 及更高版本的效能和可擴充性。
  • 已更新︰
    exportAttributes
     支援
    code
     的屬性內容
    attribute
     元素 該
    code
     屬性內容僅適用於 API v39 及更高版本。
  • 已更新︰
    updateAttributes
     支援
    code
     的屬性內容
    attribute
     元素 該
    code
     屬性內容僅適用於 API v39 及更高版本。
  • 已更新︰
    exportDimensions
     支援
    code
     的屬性內容
    dimension
     元素 該
    code
     屬性內容僅適用於 API v39 及更高版本。
  • 已更新︰
    updateDimensions
     支援
    code
     的屬性內容
    dimension
     元素 該
    code
     屬性內容僅適用於 API v39 及更高版本。
  • 已更新︰
    exportAccounts
     支援新的布林值
    showAccountGroupCodes
     中的屬性內容
    include
     元素在要求中將此屬性內容設為 True，在回應中匯出科目群組代碼。 該
    showAccountGroupCodes
     屬性內容僅適用於 API v38 及更高版本。
  • 已更新︰
    importModeledSheet
     需要
    name
     和
    code
     中的屬性內容
    configurableModel
     要求的元素該
    name
     和
    code
     元素僅適用於 API v39 及更高版本。
  • 已更新︰
    exportSheets
     重新命名
    prefix
     屬性內容
    code
     在
    modeled-sheet
     元素 該
    code
     僅適用於 API v39 及更高版本。
  • 已更新︰
    exportVersions
     支援布林值
    scenarios
     中的屬性內容
    include
     傳回要求的元素
    type="SCENARIO"
     用於回覆中的個人假設情境需要 API v37 及以上版本。
  • 已更新︰
    importGroups
     當外部使用者群組具有以下權限時，支援在 Adaptive Planning 使用者介面中編輯外部使用者群組
    dataSource=EXTERNAL
    。
  • 已更新︰
    createUser
     支援中的這些屬性內容
    user
     元素︰
    • position
    • homepage
    • country
    • usState
    • netSuiteLogin
    • salesforceLogin
  • 已更新︰
    updateUser
     支援中的這些屬性內容
    user
     元素︰
    • position
    • homepage
    • country
    • usState
    • perspective
    • perspectiveName
    • dashboard
    • dashboardName
    • netSuiteLogin
    • salesforceLogin
  • 已更新︰
    exportUsers
     支援中的這些屬性內容
    user
     元素︰
    • alternateEmail
    • samlFedId
    • position
    • homepage
    • country
    • usState
    • perspective
    • perspectiveName
    • dashboard
    • dashboardName
    • nestuiteLogin
    • salesforceLogin
    • createdDate
    • lastLogin
    • failedAttempts
    • Locked
JSON 格式的 REST API
  • 建模服務
    • Modeled Sheet Definition
      • /sheet/modeled/definition
        PATCH
         支援
        delete
         做為工作表欄物件中的屬性，以在 Adaptive Planning 中刪除模型工作表欄。Delete 無法刪除︰
        • 必填欄。
        • 依存於其他未標幟待刪除的欄的欄。
    • Cube 工作表定義
      • /sheet/cube/definition
         (
        PATCH
        ,
        DELETE
        ) 在 Adaptive Planning 中插入、更新或刪除 Cube 工作表定義。
      • /sheet/cube/definition
        PATCH
         支援
        delete
         做為工作表欄物件中的屬性，即可在 Adaptive Planning 中刪除 Cube 工作表欄。Delete 無法刪除︰
        • 依存於其他未標幟待刪除的欄的欄。
    • 新增僅支援刪除的 API︰
      • 科目
        • /accounts/removeGLAccounts
           (
          POST
          ) 刪除總分類帳科目。
        • /accounts/removeAccounts
           (
          POST
          ) 刪除自訂科目。
      • 屬性內容
        • /attribute
           (
          DELETE
          ) 刪除屬性內容及其屬性內容值。
      • 屬性內容值
        • /removeAttributeValues
           (
          POST
          ) 刪除屬性內容值。
      • 維度。
        • /dimension
           (
          DELETE
          ) 刪除維度及其維度值。
      • 維度值
        • /removeDimensionValues
           (
          POST
          ) 刪除維度值。
      • 層級
        • /removeLevels
           (
          POST
          ) 刪除層級。
  • 安全服務
    • 群組︰
      • /groups
         (
        GET
        ) 擷取針對指定實例定義的所有群組的完整清單。
  • 使用者
    • /users
       (
      DELETE
      ) 將使用者從 Adaptive Planning 中刪除。

2023R2

(12 月 8 日)
  • 已更新︰
    importConfigurableModelData
     支援
    applyValidationRules
     在
    importDataOptions
     元素，用以指出資料匯入是否會依據驗證規則進行驗證。
(9 月 9 日)
API v37 簡介
  • 已更新︰
    customReportValues
     支援新
    cell-inclusions
     中的屬性內容
    report
     元素此屬性內容在儲存格層級與
    suppress-zeroes
     以控制未隱藏列的輸出是否包含零或空白儲存格。
  • 已更新︰
    customReportValues
     和
    exportData
     在特定條件下取得效能改善。請參閱︰

2023R1

(3 月 11 日)
API v36 簡介
  • 已更新︰
    importStandardData
     支援
    mode
     在 importDataOptions 元素中，用於指出
    REPLACE
     模式。
  • 已更新︰
    importStandardData
     需要
    scope
     使用時的元素
    replace
     模式，以指出要取代的資料。該
    scope
     元素必須有 1
    time
     元素, 1
    accounts
     至少有 1 個子系的元素
    account
     元素和 1
    levels
     元素
  • 更新︰使用者
    importStandardData
     要求 API v36 需要「清除資料」權限才能支援
    REPLACE
     模式。
JSON 格式的 API
  • 建模服務︰
    • 貨幣︰
      • /currency
         (
        POST
        ,
        DELETE
        ) 在 Adaptive Planning 中建立、更新或刪除貨幣。
    • 匯率類型︰
      • /exchangeRateTypes
         (
        GET
        ,
        POST
        ,
        DELETE
        ) 在 Adaptive Planning 中插入、更新或刪除匯率類型。
    • 工作表︰
      • /sheet/modeled/definition
         (
        PATCH
        ,
        DELETE
        ) 在 Adaptive Planning 中插入、更新或刪除模型工作表定義。
    • 版本︰
      • /versions
         (
        GET
        ,
        DELETE
        ,
        PATCH
        ,
        POST
        ) 在 Adaptive Planning 中擷取、刪除、更新或建立版本。
    • 時間︰
      • /updateTime
         (
        POST
        ) 在 Adaptive Planning 中重新載入、更新、附加時間結構。

2022R2

(2022 年 11 月 18 日)
API v35 簡介
  • 已更新︰
    exportConfigurableModelData
     串流支援
    useActualValue
     做為要求中的屬性內容
    modeled-sheet
     元素以傳回原始資料，而不是科目精確位數。計算科目會以小數點後 9 位的精確位數傳回。
  • 已更新︰
    exportConfigurableModelData
     支援新
    status
     中的元素
    response
     元素該
    status
     元素包含
    success
     布林值屬性內容，後跟
    rowCountSent
     以指出成功與否已傳送的列。
  • 已更新︰
    exportConfigurableModelData
     支援
    totalRowCount
     在回應輸出中
    data
     要在中指出總計列數的元素
    data
    。
  • 已更新︰
    exportConfigurableModelData
     自動在回應輸出中為維度值的字串值和文字欄位省略字串值中的雙引號。
  • 已移除︰
    success
     中的屬性內容
    response
     元素
    exportConfigurableModelData
     在串流資料時，依 API v35 預設移除 (isGetAllRows="true")。
  • 已移除︰字首
    s
     適用於
    parentId
     時輸入資料輸出
    useNumericIDs=true
     在串流資料時針對 API v35 移除 (isGetAllRows="true")。
(2022 年 9 月)
API v34 簡介
  • 已更新︰
    updateAccounts
     支援僅使用以下標記來標記維度值和屬性內容值
    value
    。不再支援
    valueName
     和
    valueCode
     搭配 API v34。
  • 已更新︰
    updateDimensions
     支援僅使用以下標記來標記維度值和屬性內容值
    value
    。不再支援
    valueName
     和
    valueCode
     搭配 API v34。
  • 已更新︰
    updateLevels
     支援僅使用以下標記來標記維度值和屬性內容值
    value
    。不再支援
    valueName
     和
    valueCode
     搭配 API v34。
  • 已更新︰
    exportAccounts
     表示已標記的維度值和屬性內容值
    value
    。不再支援
    valueName
     和
    valueCode
     搭配 API v34。
  • 已更新︰
    exportDimensions
     表示已標記的維度值和屬性內容值
    value
    。不再支援
    valueName
     和
    valueCode
     搭配 API v34。
  • 已更新︰
    exportLevels
     表示已標記的維度值和屬性內容值
    value
    。不再支援
    valueName
     和
    valueCode
     搭配 API v34。
  • 已更新︰
    updateAccounts
     要求可設定
    balanceType
     身分
    debit
     或
    credit
    。子系科目現在可以使用不同的
    balanceType
     而非父系科目，以支援抵銷科目。
  • 已更新︰
    updateAccounts
     回應包含以下項目的新布林值屬性
    isContra
     以指出科目是否為抵銷科目。
  • 已更新︰
    createAccount
     回應包含以下項目的新布林值屬性
    isContra
     以指出科目是否為抵銷科目。
  • 已更新︰
    exportSheetDefinition
     退貨
    horizontalAxis
    ,
    verticalAxis
    ,
    maxColumnWidth
    ,
    suppressZeroRows
    ,
    rearreangeGLAndCustomAccounts
    ,
    hideRollupTotals
     在
    cube-sheet
     元素
  • 已更新︰
    exportSheetDefinition
     傳回
    users
     和
    user
     如果呼叫使用者俱有「模型」權限，則在回應中加入元素
  • 已更新︰
    importCubeData
     支援
    mode
     在
    importDataOptions
     元素，用於指出其中一個
    APPEND
     或
    REPLACE
     匯入模式
  • 已更新︰
    importCubeData
     支援
    scope
     使用時的元素
    REPLACE
     匯入模式，以指出將取代資料的 Cube 座標。
(2022 年 8 月)
API v33 簡介
  • 新功能︰
    exportCalendar
     透過在 2022R2 中導入其他行事歷，支援匯出行事歷中繼資料
  • 已更新︰
    exportTime
     支援
    calendarId
     ，以在 2022R2 中引入其他行事歷後，從您的任何行事歷擷取時間值。
  • 已更新︰
    exportConfigurableModelData
     現在僅支援匯出您在「
    filters
     要求的元素
  • 已更新︰
    exportConfigurableModelData
     現在透過設定，支援以科目小數位數輸出數字欄
    useAccountPrecision=true
     適用於
    modeled-sheet
     元素適用時間
    isGetAllRows=true
    。

2022R1

(2022 年 5 月)
  • 已更新︰
    updateLevels
     支援單層輸入格式，允許
    level
     標記正下方
    levels
     標記。此輸入格式僅建議用於對層級階層的一小部分進行增量式變更。
(2022 年 3 月)
  • 新功能︰
    importGroups
    ︰用於匯入一組使用者群組。
引入 JSON 格式的 API 版本 1
  • 建模服務︰
    • sheet/availability
       (
      GET
      ,
      POST
      ) 擷取或更新指定工作表和欄的維度或屬性內容值可用性。
  • 安全服務︰
    • users/permissionSets
       (
      GET
      ,
      POST
      ) 將權限集指派給 Adaptive Planning 使用者。
    • users/instances
       (
      GET
      ,
      PATCH
      ,
      PUT
      ) 在父系-子系階層中使用 Adaptive Planning 多重實例時，將使用者指派給實例。
(2022 年 2 月)
API v32 簡介
  • 已更新︰
    exportConfigurableModelData
     串流資料以取得更佳的效能。
  • 已更新︰
    updateLevels
     現在支援
    valueCode
     和
    valueName
     在
    dimension
     元素 (啟用顯示名稱時)
  • 已更新︰
    updateDimensions
    ,
    updateLevels
    , 和
    updateAccounts
     現在支援
    valueCode
     和
    valueName
     在
    attribute
     元素 (啟用顯示名稱時)
  • 已更新︰
    exportDimensions
    ,
    exportLevels
    , 和
    exportAccounts
     現在支援
    valueCode
    ,
    valueName
    , 和
    valueDisplayName
     在
    attribute
     元素 (啟用顯示名稱時)

2021R2

(2021 年 10 月)
以下特定 API 現在可在下列情況下支援顯示名稱的層級、維度和屬性內容代碼︰
  • 您可以在 Workday Customer Center 建立個案，以啟用實例的顯示名稱。
  • 您呼叫 API v30 或更高版本。
  • 您啟用
    displayNameEnabled
     每次呼叫 (請參閱每個 API 文件頁面以取得詳細資料)。
  • 已更新︰
    updateLevels
    ,
    updateDimensions
    ,
    updateAttributes
     現在接受要求
    code
     和
    name
     並繼續使用
    id
     做為索引鍵。
    • code
       和
      name
       在建立維度值、屬性內容值和層級時，必填。
  • 已更新︰
    updateLevels
    ,
    updateDimensions
    ,
    updateAttributes
     立即傳回回覆
    name
    ,
    code
    ,
    displayName
     和
    displayNameType
    。
  • 已更新︰
    importDimensionMapping
     接受要求︰
    • id
       和
      name
       適用於
      dimension
      。
    • id
       和
      code
       適用於層級和維度值
  • 已更新︰
    exportDimensionMapping
     要求篩選︰
    • keyword
       值與顯示名稱有部分相符。
    • level
       用途
      code
       而不是
      name
      。
    • dimensionValue
       用途
      code
       而不是
      name
      。
    • 屬性內容
      value
       參照
      code
      , 而不是
      name
      。
  • 已更新︰
    exportDimensionMapping
     回覆
    id
    ,
    name
    ,
    code
    ,
    display name
     適用於層級和維度值
  • 已更新︰
    exportLevels
    ,
    exportDimensions
    , 和
    exportAttributes
     立即傳回回覆
    name
    ,
    code
    ,
    displayName
    ,
    displayNameType
    。
  • 已更新︰
    importStandardData
    ,
    importCubeData
    ,
    importConfigurableModelData
    , 和
    importTransactions
     要求︰
    • 標頭列
      Level
       變更為
      Level Code
      。
    • 標頭列
      Account
       變更為
      Account Code
      。
    • 標頭列
      Dimensions
       變更為
      "<dimension> Code"
       和
      "<dimension> Name"
      。
      "<dimension> Code"
       為必填欄位。
      "<dimension> Name"
       只有在為維度啟用「資料匯入會自動建立維度值」時，才允許使用。
    • 「代碼」、「名稱」和「顯示名稱」等文字的欄標頭支援本地化設定。
    • useMappings=false
       使用系統中的代碼。
    • useMappings
       和
      displayNameEnabled
       不能
      true
       同時。
  • 已更新︰
    exportConfigurableModelData
    (需要 API v31) 要求︰
    • level
       元素不再支援
      name
       在 API v31+ 中
    • level
       元素新增了對以下項目的支援
      code
      。
    • modeled-sheet
       元素新增了對以下項目的支援
      includeCodes
      ,
      includeNames
      , 和
      includeDisplayNames
       具有適用於所有項目的 True/False 選項
      dimension values
       和
      levels
       在通話中這三個選項至少必須有一個為 True。
  • 已更新︰
    exportConfigurableModelData
     回應︰
    • 包含以下項目的欄
      "<dimension> Code"
      ,
      "<dimension> Name"
      , 和
      "<dimension> Display Name"
    • 「代碼」、「名稱」和「顯示名稱」等文字的欄標頭支援本地化設定。
  • 已更新︰
    exportData
     要求︰
    • level
       元素不再支援
      name
       在 API v30+ 中
    • level
       元素新增了對以下項目的支援
      code
      。
    • level
       將比對系統中的代碼。
    • dimensionValue
       元素不再支援
      name
       在 API v30+ 中
    • dimensionValue
       新增支援
      code
      。
    • dimensionValue
       將比對系統中的代碼。
  • 已更新︰
    exportData
     回應︰
    • 包含以下項目的欄
      "<dimension> Code"
      ,
      "<dimension> Name"
      , 和
      "<dimension> Display Name"
    • 包含以下項目的欄
      "<level> Code"
      ,
      "<level> Name"
      , 和
      "<level> Display Name"
    • 「代碼」、「名稱」和「顯示名稱」等文字的欄標頭支援本地化設定。
  • 已更新︰
    eraseData
     要求︰
    • level
       元素不再支援
      name
       在 API v30+ 中
    • level
       元素新增了對以下項目的支援
      code
      。
    • level
       將比對系統中的代碼。
API v31 簡介
(2021 年 9 月)
  • 已更新︰
    importConfigurableModelData
    ,
    importTransactions
    ,
    importCubeData
    , 和
    importStandardData
     當標頭中的豎線字元數與資料不相符時，系統會輸出錯誤。
  • 已更新︰
    updateAccessRules
     現在需要
    Users
     權限，而不是
    Admin
     權限。
  • 已更新︰
    updateAccounts
     現在允許在現有父係與其子系科目之間新建父系科目。
(2021 年 8 月) 引入 API v30

2021R1

(2021 年 5 月) 推出 API v29
  • 已更新︰
    updateAccounts
     要求現在允許使用以下方法建立新科目
    dataEntryType=CUBE
    。
    Adaptive Planning
     自動計算
    dataEntryType
     適用於任何非分葉科目。如果父系
    dataEntryType
     是
    CUBE
    ，新科目將預設為
    dataEntryType=CUBE
    。否則，新科目會預設為
    dataEntryType=STANDARD
    。變更為
    dataEntryType
     忽略非分葉科目的。
  • 已更新︰
    UpdateAccounts
     回應指出
    dataEntryType
     將所有分葉科目設為
    CUBE
     或
    STANDARD
    。
(2021 年 4 月) 推出 API v28
  • 已更新︰
    exportVersions
     回覆現在包括
    isPredictive=true
     在
    version
     元素以指出預測版本。
  • 已更新︰
    createUser
     要求現在包括
    alternateEmail
     和
    samlFedId
    。使用
    alternateEmail
     設定備用電子郵件地址，系統會在「使用者詳細資料」區段中自動選取該電子郵件地址做為使用者的電子郵件地址。使用
    samlFedId
     以包含使用者的 SAML 同盟 ID，以便進行單點登入 (SSO)。
  • 已更新︰
    updateUser
     要求現在包括
    alternateEmail
     和
    samlFedId
    。使用
    alternateEmail
     設定備用電子郵件地址，系統會在「使用者詳細資料」區段中自動選取該電子郵件地址做為使用者的電子郵件地址。使用
    samlFedId
     以包含使用者的 SAML 同盟 ID，以便進行單點登入 (SSO)。
(2021 年 3 月) 推出 API v27
  • 已更新︰
    updateAttributes
     和
    updateDimensions
     要求包括
    retainExistingOrder
     表示是否為了維護順序而忽略承載資料順序
    Adaptive Planning
     已用於階層。若為 False，則承載資料的順序會決定 Adaptive Planning 對元素的排序方式。
  • 已更新︰
    updateLevels
     要求數現在會將預設值設為
    retainExistingOrder
     設為 1。
  • 已更新︰
    updateAccounts
     要求數現在會將預設值設為
    retainExistingOrder
     設為 1。
  • 已更新︰
    importModeledSheet
     要求現在包括
    requiredColumn
     用於指出是否必須為使用者提供維度值，才能儲存模型工作表。您必須詢問
    Adaptive Planning
     支援啟用
    requiredColumn
     適用於
    importModeledSheet
     要求
  • 已更新︰
    exportModeledSheet
     回覆現在包括
    requiredColumn
     用於指出是否必須為使用者提供維度值，才能儲存模型工作表。
API v26 簡介
  • 已更新︰
    updateAccounts
     和
    updateLevels
     要求包括
    retainExistingOrder
     表示是否為了維護順序而忽略承載資料順序
    Adaptive Planning
     已用於階層。若為 False，則承載資料的順序會決定 Adaptive Planning 對元素的排序方式。
  • 重新命名︰對於所有 v26 API，
    permissionSetId
     取代
    roleId
     在中將角色和權限重新命名為權限集
    Adaptive Planning
    。
  • 新功能︰
    updateAssociations
     用於設定使用者維度和層級關聯。或者，在以下情況下設定層級的使用者層級所有權
    code
     不包含在關聯元素中。
  • 已移除︰
    roleID
    API v26 及更新版本不再支援。繼續支援 API v25 及更早版本
    roleID
    。

2020R2

  • (2021 年 2 月) 更新︰eraseData 要求會忽略
    Accounts
     和
    Levels
     標記。
  • (2020 年 12 月) 已更新日期︰
    updateDimensions
     要求取代在
    dimensionValue name
     的承載資料中加上空格。名稱中前面或結尾的換行字元會變成空格，並在處理承載資料期間剪掉這些空格。
  • (2020 年 12 月) 已更新日期︰
    updateDimensions
     要求現在可處理同一實體中相同實體的多次重新命名。
    updateDimensions
     呼叫。這有助於解決在遠端系統中同步至 Adaptive Planning 之間多次切換名稱的問題。
API v25 簡介
  • 已更新︰
    exportData
     要求不再包含
    includeRollups
    。要求包含布林值
    includeRollupAccounts
     對於科目匯總和
    includeRollupLevels
     適用於層級匯總。
API v24 簡介
  • 已更新︰
    updateLevels
     要求包括
    publishCurrency
     用於在將財務計畫發布至 Workday Core Financials 時指出貨幣。
  • 已更新︰
    exportLevels
     回應包括
    publishCurrency
     用於在將財務計畫發布至 Workday Core Financials 時指出貨幣。
  • 已更新︰
    exportInstances
     回應包括
    notificationType
     用於指出 Workday 用戶通知設定
    Adaptive Planning
     已針對 Workday 設定。
  • 已更新︰
    exportData
     要求包括
    stratum
     用於指出匯出資料的時間級別代碼。指定後，開始和結束時段必須在時間級別之內。時間級別必須等於或大於要求中時間級別最高的科目。
  • 已更新︰
    exportData:
     當 includeZeroRows=False 時，即使 markBlanks=true，也不會在回應中輸出僅包含空白和零組合的列。
  • 新功能︰
    eraseData
     用於清除計畫和實際值資料。提供與
    eraseActuals
     但也包含清除計畫資料的功能，可額外控製做為目標的特定科目-計畫組合。
  • 新功能︰
    updateAccessRules
     用於上傳包含存取規則範本格式 .xslx 的分段 xml 文件，以大量更新存取規則。

2020R1

API v23 簡介
  • 已更新︰
    importConfigurableModelData
     要求包括
    importKey
     用於指出要將匯入列對應至您要更新的模型工作表列的維度或層級。
  • 已更新︰
    exportUsers
     和
    exportLevels
     要求可包含布林值
    groups
     以便回覆包括
    groupIds. GroupIds
    包含該層級或使用者所屬的所有群組的清單 (以逗號分隔)。該
    groups
     屬性內容預設為
    false
    。
  • 新︰(
    Available only with sales planning.
    )
    exportDimensionMapping
     匯出使用者定義的維度對應規則。
  • 新︰(
    Available only with sales planning.
    )
    importDimensionMapping
     更新現有的使用者定義維度對應規則。

2019.3

API v22 簡介
  • 已更新︰
    exportConfigurableModelData
     要求包含新的選填屬性
    useNumericIDs
     以移除拆分 ID 的
    S
     字首，僅傳回數值。
  • 如果您的公司 Transition to Access Rules 為安全起見，
    exportAccounts, exportActiveCurrencies, exportAttributes, exportDimensions, exportLevels, exportTime,
    和
    exportVersions
     只會在 API v22 上驗證。回覆將僅包含使用者在
    credentials
     element 有權存取。
  • 已更新︰
    updateDimensions
     包含新的選填項目
    properties
     的元素
    dimensionValue
     最多可包含五個
    property
     元素每個
    property
     元素包含
    name
     和
    value.
     值必須為數值。
  • 已更新︰
    exportDimensions
     回應中包含新的
    properties
     元素
  • 已更新︰
    exportSheetDefinition
    Cube 工作表回應包含科目
    code
     和
    name
     內
    account
     元素
  • 已更新︰
    exportSheetDefinition
    Cube 工作表回應包含維度
    name
     內
    dimension
     元素
  • 已更新︰
    exportSheetDefinition
    Cube 工作表回應包含屬性內容
    name
     內
    attribute
     元素
  • 已更新︰
    exportConfigurableModelData
     要求包含新的選填項目
    includeAllColumns
     在
    modeled-sheet
     元素，以便回覆中包含所有欄。
  • 已更新︰
    exportConfigurableModelData
     現在的回應指出
    numberOfPages
     而不是
    pageCount
     在
    job
     元素
  • 已更新︰
    exportInstances
     回應現在會指出實例是否允許在
    options
     屬性內容
  • 已移除︰
    rootActuals
     不再支援
    exportVersions
     與 API 版本無關。

2019.2

  • (2019 年 9 月) 新增︰
    exportSecurityAudit
     傳回指定時間範圍內所有安全事件的報告。

2019.1

API v20 簡介
  • 已更新︰
    exportInstances
     包含
    workdayTenantId
    ,
    workdayEnvironment
    ,
    workdayUiUrl
    , 和
    workdayRestUrl
     已啟用 Workday Power of One 的實例的相關資訊。
  • 新功能︰
    updateAccounts
     用於大量更新/建立科目。管理科目及其屬性。允許重設現有科目的父系。
  • 新功能︰
    updateAttributes
     用於大量更新/建立屬性內容。管理屬性內容及其屬性內容值。允許重設現有屬性內容值的父系。
  • 已更新︰
    exportAttributes
     包含
    autoCreate
     布林值屬性，指出匯入維度、層級、科目或屬性內容時是否會自動建立未找到的新屬性內容值
    Adaptive Planning
    。
  • 已更新︰
    exportInstances
     包含
    workdayTenantID, workdayEnvironment, workdayUiUrl, workdayRestUrl
     適用於已啟用 Workday Power of One 的實例。
  • 已移除︰單一實體 API 適用於
    createDimension
    ,
    updateDimension
    ,
    createDimensionValue
    ,
    updateDimensionValue
    ,
    createLevel
    , 和
    updateLevel
    。使用以下項目的中繼資料大量 API
    updateDimensions
     和
    updateLevels
     用於在 API v20 及更高版本中建立或更新單一實體。

2018.3

API v19 簡介
  • 新功能︰
    updateLevels
     用於大量更新/建立層級。管理層級及其屬性內容值。允許為現有層級重設父系。
  • 新功能︰
    exportConfigurableModelData
     用於匯出模型工作表列。

2018.2

API v18 簡介
  • 已移除︰
    exportLevels
    不再包含
    inaccessibleLevels
    要求中的屬性查看新版本
    inaccessibleValues
    。
  • 已移除︰
    exportUsers
    不再包含以下項目的選項
    hiddenVersions
     和
    ownedLevels
    。
  • 已移除︰
    exportAccounts
    不再包含
    formula
    屬性內容
  • 新功能︰
    exportAccounts, exportAttributes,
    exportDimensions,
    和
    exportLevels
    包含新的
    inaccessibleValues
    屬性，以便只有具有適當權限的使用者才能檢視無法存取的值。
  • 已更新︰
    exportAccounts, exportAttributes, exportDimensions,
     和
    exportLevels
     預設僅顯示可存取的值。只有具有適當權限的使用者才能檢視無法存取的值。
  • 已更新︰
    exportAccounts,
    exportDimensions,
    和
    exportLevels include
    元素
    versionName
    和
    versionID
    只有在使用者有權存取該版本時，才能成功調出要求呼叫中的「屬性」。
  • 已更新︰
    exportAccounts
     名稱
    GL
    「現在」
    GL Accounts
    "，以符合報告對此科目的命名方式。
  • 已更新︰
    exportActiveCurrencies
     回應的排序依據
    code.
  • 已更新︰
    exportTime version
    元素
    option
    只有在使用者有權存取該版本時，才能成功為要求中的單一版本建立屬性。

2018.1

API v17 簡介
  • 已移除︰
    updateUser
     已於 2018 年 3 月從所有 API 版本中移除
  • 已更新︰
    exportActiveCurrencies
     包含
    userDefined
     屬性內容，以識別哪些貨幣是使用者定義的。
  • 新功能︰API
    updateDimensions
     用於上傳 XML 文件以大量更新/建立維度

2017.3

API v16 簡介
  • 更新︰回應格式
    exportAccounts
    ,
    createAccount
    ,
    updatedAccount
     顯示每個科目的時間級別代碼
    timeStratum
     欄位
  • 已更新︰
    eraseActuals
     僅接受與 API v15 + 輸入科目分類時間級別相同的時段
  • 已更新︰
    eraseActuals
     使用「時間級別」措辭而非「粒度」
  • 已更新︰要求格式︰
    importModeledSheet
     包括選填
    strata-code
  • 已更新︰回應格式︰
    exportModeledSheet
    包括選填
    strata-code
  • 新增︰
    inUse
     和
    isDefault
     屬性
    stratum
     中的元素
    exportTime
  • 新增︰選用
    leafStratumId
     屬性，變更為以下的要求格式
    exportTime
  • 新功能︰API
    recalculateSheet
     適用於具有
    隨需重新計算
     屬性的重新計算工作表

2017.2

API v15 簡介
只有在「工時管理」使用者介面中匯入自訂行事歷，公司才會從 API v14 升級至 API v15。
  • 已移除︰以下項目的行事歷相關屬性內容
    exportInstances
    calendarType, q1FirstMonth, lastMonthIsFY, firstDayOfWeek, periodAlgorithm, leapWeekPeriod,
     和
    extraPeriodQuarter
    屬性內容來源
    instance
    元素
  • 已更新︰
    exportTime
    大幅修整
  • 已更新︰
    exportData
    的行為
    start
    和
    end
    屬性內容使用時段代碼，而不是 MMM-YYYY 日期字串。
  • 已更新︰
    exportData
    輸出日期標頭已變更為時段代碼。
  • 已更新︰
    exportVersions
    取代屬性內容
    startVerFY, completedValuesThruYr, completedValuesThruMon, completedValuesThruPer, startScrollYr, startScrollMon, startScrollPer, endVerFY, lockLeadingYr, lockLeadingMon, lockLeadingPer, leftScrollFY, startPlanYr, startPlanMon, startPlanPer, endPlanFY
     有
    startVer, endVer, startScroll, completedValuesThru, leftScroll, startPlan, endPlan, lockLeading
  • 已更新︰
    importStandardData, importConfigurableModelData, importCubeData
     接受時段代碼，而非 MMM-YYYY 日期字串
  • 已更新︰
    exportLevels
    已修改
    availableStart
    和
    availableEnd
    屬性內容會輸出時段代碼，而不是 MMM-YYYY 日期字串。
  • 已更新︰
    eraseActuals
    屬性內容的行為
    start
    和
    end
    使用時段代碼，而非 MMM-YYYY 日期字串
  • 新功能︰API
    exportLocales
     用於從「工時管理」使用者介面匯出地區設定。

2017.1

API v14 簡介
  • 已更新︰
    customReportValues
    包含新的選用元素
    suppress-rollups
  • 新功能︰API
    exportModeledSheet
  • 新功能︰API
    importModeledSheet

2016.3

API v13 簡介
  • 已更新︰
    exportAccounts
    包含新的選用元素
    sheet
  • 已更新︰
    exportLevels
    包含新的選用元素
    sheet
  • 已更新︰
    exportLevels
    包含新的選填回應元素
    hasChildren
  • 已更新︰
    exportVersions
    包含新的選用元素
    include

2016.2

API v12 簡介
  • 已更新︰
    importCubeData, importStandardData, importConfigurableData, importTransactions
    可使用屬性內容來停用屬於錯誤訊息一部分的環境定義資訊
    includeContext.

2016.1

API v11 簡介
  • 已移除︰
    canBeTree
    屬性內容來源
    exportDimensions
  • 已更新︰
    exportInstances
    包含新
    datasources
    屬性內容
  • 已更新︰
    exportInstances
    包含新的潛在值
    INTEGRATION
    至
    products
    中的屬性內容
    instance
    元素
  • 已更新︰
    exportLevels
    包含新
    attributeId
    和
    valueId
    至
    attribute
    元素
  • 已更新︰
    exportLevels
    包含新
    isLinked
    和
    isElimination
    屬性內容
    level
    元素
  • 已更新︰
    exportDimensions
    包含新
    attribute
    和
    attributes
    元素的後代
    dimensionValue
    元素
  • 已更新︰
    exportDimensions
    包含新
    listDimension, keepSorted
    , 和
    useOnLevels
     屬性內容
    dimension
    元素
  • 已更新︰
    exportSheetDefinition
    包含新
    required
    屬性內容
    levels, text, dimension, text-selector, number, date, initial-balance, level-currency, display, timespan
     的元素
    modeled-sheet
  • 已更新︰
    exportSheetDefinition
    包含新
    attribute
    Cube 工作表的元素
  • 已更新︰
    exportSheetDefinition
    包含新
    split-column-title
     和
    allow-splits
     屬性內容
    modeled-sheet
     元素
  • 更新︰匯入資料 API (
    importCubeData, importStandardData, importConfigurableModelData,
    importTransactions
    ) 現在的錯誤訊息中包含環境定義資訊
  • 新功能︰API
    createDimension
  • 新功能︰API
    updateDimension
  • 新功能︰API
    updateDimensionValue
  • 新功能︰API
    createLevel
  • 新功能︰API
    updateLevel