跳至主要内容
Adaptive Planning
上次更新时间 :2024-03-08
参考信息:exportData Performance

参考信息:exportData Performance

要从 exportData 性能和可扩展性优化中受益,您的请求必须使用特定的 API 版本、属性和元素。
性能方面的改进会影响独立的 exportData API 调用以及调用 exportData 的以下功能:
  • 发布计划。
  • 在设计集成中从 Adaptive Planning 数据源中检索账户数据。
请参见 exportData
API v38 包含新的请求和响应格式,具体取决于是否存在
stream="true"
stream="false"
call
元素。

支持的账户

exportData 性能和可扩展性方面的改进支持:
所有账户类型,
但以下类型除外
  • 系统账户(包括分配、少数股东权益百分比、抵销、累计折算调整)。
  • 模型工作表假设账户
所有建模功能,但以下功能
除外
  • 加权平均折算
  • 文本汇总
  • 分摊查询。
  • 值查询

使用方应用程序

  • 发布计划。
  • 在设计集成中从 Adaptive Planning 数据源中检索账户数据。
    • 包括 exportData API 性能优化(具有时间层级的多维数据除外)。
    • 不包括流式传输的较大导出行限制。

exportData 的性能和行为

exportData API 的行为因以下配置而异:
API v36
请求包含不受支持的账户类型或属性
stream
属性
回复格式
导出行限制
性能优化
不可用
无变更
50 万
不可用
无变更
50 万
API v38
请求包含不受支持的账户类型或属性
stream
属性
回复格式
导出行限制
性能优化
休假或
false
非流式传输
50 万
true
流式传输
200 万
API v39
请求包含不受支持的账户类型或属性
stream
属性
回复格式
导出行限制
性能优化
休假或
false
非流式传输
50 万
true
流式传输
200 万
true
非流式传输
50 万
false
非流式传输
50 万
exportData API v36 及更高版本的更新
下表列出了在 2024R1 中为 exportData API v36 及更高版本引入的性能优化路径的增强功能,这些增强功能是 exportData API 性能优化功能的一部分。
exportData API
非优化行为
优化的显示方式
用户无权访问 DAC 规则中某个维度的所有账户、层级组合,并且该维度未包含在 exportData API 请求中。
响应不会为以下多维工作表或模型化工作表中的账户返回数据:
  • 包括维度。
  • 包含用户有权访问的维度值以及未分类维度值的数据。
回复会返回包含未分类维度值的行。
API 请求的以下两个位置均包含维度:
  • <dimensions>
    阻止(例如,从
    <dimension>
    <dimensionIds>
    元素)。
  • 作为值
    directChildrenofDimension
    的属性
    <dimensionValue>
    中的元素
    <dimensionValues>
    块。
响应不会为维度的直接子级或维度返回任何行。
响应将返回包含直接子级汇总值的行,以及包含维度的未分类值的行。
对多维账户发出 API 请求,并在以下两个位置指定了维度:
  • <dimensions>
    阻止(例如,从
    <dimension>
    <dimensionIds>
    元素)。
  • 作为值
    dimName
    的属性
    <dimensionValue>
    元素,其值为空的
    name
    属性,在
    <dimensionValues>
    块。
响应不会为维度的直接子级或维度返回任何行。
响应将返回维度汇总或直接子级汇总的行,以及基于为
directChildren
以及
uncategorized
中的属性
<dimensionValue>
元素。
API 请求日期
directChildren
为不包含层级维度的多维工作表中的账户添加层级维度值。
回复不会返回计入层级维度值直接子级汇总值的层级行。
响应会返回层级中计入层级维度值的直接子级汇总值的行。