跳至主要内容
文档
文档
Adaptive Planning
上次更新时间 ：2025-02-07
API 变更（按发行版）

API 变更（按发行版）

2025R1

（2025 年 2 月）
JSON 格式的 REST API
  • 任务服务
    • 任务
      • /tasks?instanceCode=<instanceCode>
        (GET, POST)
         集成任务中基于 JSON 的 HTTP 操作。

2024R2

（2024 年 9 月）
API v40 简介
  • 已更新：
    importModeledSheet
    现在支持可选
    accountCode
    中的属性
    DisplayColumns
    元素。该
    code
    属性
    DisplayColumn
     现在支持为列创建可编辑的唯一编号。时间
    accountCode
     未包含在请求中，则系统会按程序生成唯一的
    code
     以将该列关联到给定账户。
  • 已更新：
    exportModeledSheet
     现在支持可选
    accountCode
     中的属性
    DisplayColumns
     元素。该
    code
     属性
    DisplayColumn
     现在支持为列创建可编辑的唯一编号。
  • 已更新：
    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
         在工作表列属性对象中添加前缀，以在账户代码和辅助识别号中添加前缀。创建新工作表时为必填项。其作用与
        prefix
        并且是与用户界面匹配的首选属性。

2024R1

（2024 年 4 月）
  • 非美国租户的区域身份验证：
    如果您的实例使用的不是基于美国的区域身份验证，则您的授权 URL 和 API 端点会因您所在的区域而异。请参见 参考信息：区域身份验证 URL。
（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 中的模型化工作表列。删除操作无法删除：
        • 必填列
        • 依赖于其他未标记为删除的列的列。
    • 多维工作表定义
      • /sheet/cube/definition
         （
        PATCH
        、
        DELETE
        ）在 Adaptive Planning 中插入、更新或删除多维工作表定义。
      • /sheet/cube/definition
        PATCH
         支持
        delete
         作为工作表列对象中的属性，以删除 Adaptive Planning 中的多维工作表列。删除操作无法删除：
        • 依赖于其他未标记为删除的列的列。
    • 引入仅支持删除的 API：
      • 账户
        • /accounts/removeGLAccounts
           （
          POST
          ）删除总分类账账户。
        • /accounts/removeAccounts
           （
          POST
          ）删除自定义账户。
      • 属性
        • /attribute
           （
          DELETE
          ）删除属性及其属性值。
      • 属性值
        • /removeAttributeValues
           （
          POST
          ）删除属性值。
      • 维度
        • /dimension
           （
          DELETE
          ）删除维度及其维度值。
      • 维度值
        • /removeDimensionValues
           （
          POST
          ）删除维度值。
      • Level
        • /removeLevels
           （
          POST
          ）删除层级。
  • 安全服务
    • 组：
      • /groups
         （
        GET
        ) 检索为给定实例定义的所有组的完整列表。
  • 用户
    • /users
       （
      DELETE
      ）从 Adaptive Planning 中删除用户。

2023R2

（12 月 8 日）
  • 已更新：
    importConfigurableModelData
     支持
    applyValidationRules
     在
    importDataOptions
     元素，用于指示数据导入是否根据验证规则进行验证。
（9 月 9 日）
API v37 简介

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
     导入模式，以指明要替换数据的多维工作表的坐标。
（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）requests：
    • level
       元素不再支持
      name
       在 API v31+ 中。
    • level
       元素添加了对
      code
      。
    • modeled-sheet
       元素添加了对
      includeCodes
      、
      includeNames
      、和
      includeDisplayNames
       包含适用于所有内容的真/假选项
      dimension values
       和
      levels
       在通话中。这三个选项必须至少有一个为真。
  • 已更新：
    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 联合编号，以进行单点登录。
  • 已更新：
    updateUser
     请求现在包括
    alternateEmail
     和
    samlFedId
    。用途
    alternateEmail
     单击以设置其他电子邮件地址，系统会在“用户详细信息”版块中自动选择该电子邮件地址作为用户的电子邮件地址。用途
    samlFedId
     以包括用户的 SAML 联合编号，以进行单点登录。
（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
    。
  • 新建：(
    仅适用于销售规划。
    ）
    exportDimensionMapping
     导出用户定义的维度映射规则。
  • 新建：(
    仅适用于销售规划。
    ）
    importDimensionMapping
     更新现有的用户定义维度映射规则。

2019.3

API v22 简介
  • 已更新：
    exportConfigurableModelData
     请求包含新的可选属性
    useNumericIDs
     可从拆分编号中移除
    S
     前缀，从而仅返回数值。
  • 如果您的公司 转为使用访问规则 出于安全考虑，
    exportAccounts, exportActiveCurrencies, exportAttributes, exportDimensions, exportLevels, exportTime,
    和
    exportVersions
     仅在 API v22 上验证。响应将仅包含用户在
    credentials
     元素有权访问。
  • 已更新：
    updateDimensions
     包括新的可选选项
    properties
     的元素
    dimensionValue
     最多可包含五个
    property
     元素。每个
    property
     元素包括
    name
     和
    value.
     值必须为数值。
  • 已更新：
    exportDimensions
     回复中包括新的
    properties
     元素。
  • 已更新：
    exportSheetDefinition
     多维工作表响应中包括账户
    code
     和
    name
     在
    account
     元素。
  • 已更新：
    exportSheetDefinition
     多维工作表响应包含维度
    name
     在
    dimension
     元素。
  • 已更新：
    exportSheetDefinition
     多维工作表响应包括该属性
    name
     在
    attribute
     元素。
  • 已更新：
    exportConfigurableModelData
    request 中包含新的可选项
    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
     从所有 API 版本中移除（2018 年 3 月）
  • 已更新：
    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
    多维工作表的元素
  • 已更新：
    exportSheetDefinition
    包括新内容
    split-column-title
     和
    allow-splits
     属性
    modeled-sheet
     元素
  • 已更新：导入数据 API (
    importCubeData, importStandardData, importConfigurableModelData,
    importTransactions
    ) 的错误消息中现在包含上下文信息
  • 新增功能：API
    createDimension
  • 新增功能：API
    updateDimension
  • 新增功能：API
    updateDimensionValue
  • 新增功能：API
    createLevel
  • 新增功能：API
    updateLevel