跳至主要内容
文档
文档
Adaptive Planning
上次更新时间 ：2023-06-23
概念：显示名称的层级代码、维度代码和属性代码

概念：显示名称的层级代码、维度代码和属性代码

在 Workday Adaptive Planning 中启用显示名称后，便可将相同的标签用于多个层级、自定义维度值或属性值。此功能有以下好处：
  • 简化从 Workday Financials、Workday Human Capital Management 或其他外部系统加载结构的流程。
  • 不需要对来自 Workday 或其他导入内容的标签和参考编号进行连接，仍可使标签在 Adaptive Planning 中唯一。
  • 提供简化的元数据加载流程（当标签匹配时）。

启用显示名称

每个层级、自定义维度值和属性值都会收到一个唯一代码。
该代码用作密钥。
对于包含层级、维度值或属性值的公式，
code
 替换
name
 以免产生歧义。集成加载器的工作方式保持不变，并将代码自动用于列映射。
如果启用显示名称，会将异常检测阈值重置为 40%。

元数据代码

在添加显示名称之前，层级、自定义维度或属性中的名称必须具有唯一性。
对于先前存在的实例，我们会重用您已创建的名称，自动为您生成代码。
在 Workday Adaptive Planning 中代码始终显示在方括号内，以便识别。示例：[westeu01]。

显示名称和显示名称格式

显示名称针对层级、维度值和属性值增加了“显示名称”
只读字段。显示名称用作用户在整个 Workday Adaptive Planning 中看到的元数据元素的标签（之前为“名称”字段）。如果有人在任意位置拣取、选择或查看元数据元素，系统便会显示显示名称。
对于先前存在的 Workday Adaptive Planing 实例，“名称”
字段会自动以显示名称格式填充。在层级、维度和属性管理页面中，您可以选择以下任一显示名称格式：
  • 名称
  • 代码
  • 名称 [代码]
  • [代码] 名称
您可以在维度根中，为每个维度配置显示名称格式。系统将对每个值显示代码。
显示名称和代码均可包含 2048 个字符，如果组合使用，则可包含 4096 个字符。
启用“保持排序状态”
后，无论对显示名称的组成成分做出任何变更，都可能会更改维度管理或属性管理中元素的排序顺序。

结构导入中的显示名称

将导入模板中的显示名称格式列、值代码列和值名称列设为必填列后，层级、自定义维度和属性的导入结构便会支持代码。名称列将被替换为值代码列和值名称列。
请始终下载新的导入模板，并按照第一个工作表上的说明进行操作。如果添加显示名称，会更改模板中的必填列和列名称。请勿重复使用旧模板或来自没有显示名称的实例的模板。
请勿使用导入文件来更改层级的名称或代码。您必须在应用程序中手动执行这些变更。
对于层次结构，您可以通过引用父级代码指明父级值。
结构导入需要以下列，才能支持显示名称：
层级导入
  • 层级显示名称格式
  • 层级代码
  • 属性值代码
  • 属性值名称
维度导入
  • 维度显示名称格式
  • 维度值代码
  • 维度值名称
  • 属性值代码
  • 属性值名称
属性导入
  • 属性显示名称格式
  • 属性值代码
  • 属性值名称
账户导入
  • 属性值代码
  • 属性值名称
层级、维度和属性的可打印视图都包含显示名称列、值代码列和值名称列。

集成中的显示名称元素

在 Workday Adaptive Planning 的集成中添加元数据代码有助于执行以下操作：
  • 映射，帮助用户在外部元数据元素和 Workday Adaptive Planning 的内部元素之间建立关联。
  • 显示信息，帮助集成用户区分重复标签。
  • 搜索，帮助用户根据元数据代码查找特定元素。
在数据源、数据加载器和元数据加载器的创建和维护期间进行映射、显示和搜索。

Planning 数据源中的显示名称元素

在 Planning 数据源中创建共享参数时，您可以执行以下操作：
  • 查看层级、维度值和属性值的显示名称和代码。
  • 按显示名称或代码搜索共享参数。
对托管源纳入代码
为现有实例添加显示名称后，您可以单击“管理源”
，然后为以下源（这些源可以包含层级、维度和属性，也可以按这些内容进行筛选）选择“包括代码”
：
  • 自定义
  • 多维工作表
  • 模型化工作表
一旦选择“包括代码”
，您便无法禁用该选项。
对于您在添加显示名称后新建的托管源，系统会默认自动选择“包括代码”
。

集成加载器中的显示名称元素

添加显示名称后，维度、属性和层级加载器会自动映射到列映射代码。如果您需要自动映射列，可以选择按代码或名称自动映射。
Planning 数据加载器列映射
在您提交数据后，系统会按代码（而非名称）加载该数据。如果您使用“列映射”
选项卡映射列，请将“源编号”列映射到代码，将“源显示名称”列映射到名称。
Planning 数据加载器数据映射
单击“数据映射”
选项卡后，您可以按以下列自动映射所有列或选定列：
  • “源编号”列
  • “源显示名称”列
如果您通过“数据映射”
选项卡下载映射，模板将使用“源编号”列中的代码。在您上传映射，模板的“源编号”列中要包含代码。
Planning 数据加载器数据源设置
Planning 数据加载器的“数据源设置”选项卡包含一个自动映射版块。该版块允许您选择在加载器运行时，自动映射任何新账户、层级或维度值。“自动映射层级”“自动映射维度”通过以下选项来支持代码：
  • 将源编号自动映射到代码
  • 将源显示名称自动映射到代码

应用程序编程接口 (API) 中的显示名称元素

引入显示名称后，您的 API 可以支持元数据
code
 如果：
  • 在调用中使用 API v30 或更高版本。
  • 您包括
    displayNameEnabled=1
     中的参数
    dimensions
     元素
    attributes
     元素，以及
    levels
     元素。
包括
displayNameEnabled=0
 为某个元素禁用显示名称，从而防止使用
code
 并使用
name
 改为。
这些批量 API 支持
code
 如果您启用了显示名称，但都使用编号作为键：
  • updateAttributes
  • updateDimensions
  • updateLevels
  • importDimensionMapping
这些数据 API 支持
code
 引入显示名称后：
  • eraseData
  • exportConfigurableModelData
  • exportData
  • importConfigurableModeleData
  • importStandardData
  • importCubeData
  • importTransactions
如需详细了解在请求和响应中使用显示名称元素，请参见每个 API 文档页面。
API v32 和 v33 中的批量元数据 API 属性标记
这些批量 API 支持
valueCode
 和
valueName
 对于 API v32 和 API v33（引入了显示名称）并使用
displayNameEnabled=1
：
  • updateLevels
     支持
    valueCode
     和
    valueName
     在
    dimension
     和
    attribute
     元素。
  • updateAccounts
     支持
    valueCode
     和
    valueName
     在
    attribute
     元素。
  • updateDimensions
     支持
    valueCode
     和
    valueName
     在
    attribute
     元素。
  • exportLevels
     支持
    valueCode
     和
    valueName
     在
    dimension
     和
    attribute
     元素。
  • exportAccounts
     支持
    valueCode
     和
    valueName
     在
    attribute
     元素。
  • exportDimensions
     支持
    valueCode
     和
    valueName
     在
    attribute
     元素。
启用显示名称并使用 API v32 或 API v33 后，这些 API 将不再支持
name
 在 attribute 元素中。
单一元数据 API
以下单一元数据 API 不支持显示名称：
  • updateDimension
  • updateDimensionValue
  • updateLevel
  • createDimension
  • createDimensionValue
  • createLevel

公式中的显示名称元素

添加显示名称后，在公式中引用层级、自定义维度值或属性值时，您必须使用代码。在公式助手中，您之前可看到名称的位置现在会显示显示名称。
公式助手元素选择器会根据显示名称和代码生成搜索结果。只有元素的代码会成为公式的一部分。
显示名称元素和属性的公式点记法
引入显示名称会触发使用
code
 在属性的公式点记法中。当您使用属性的点记法构建公式时，您可以按以下方式引用层级、自定义维度值和属性值：
code
。
对于点记法，您必须手动更改任何现有的
.name
 引用
.code
 引入显示名称。
不可在点记法中使用显示名称，因为无法确保在计算期间显示名称具有唯一性。
如果您在报告中为自定义计算使用公式，之后更改了显示名称格式，请重新访问这些公式，以确保公式正确。

工作表中的显示名称元素

添加显示名称后，您可以通过以下 2 个选项下载模型化工作表数据：
  • 下载
    ：导出工作表中的层级、维度值和属性值代码。如果您计划将数据重新导入模型化工作表，请使用此选项。
  • 可打印视图
    ：导出层级、维度值和属性值的已配置显示名称。如果您希望电子表格与当前的“显示选项”
    匹配，请使用此选项。您无法导入此版本的电子表格。
如要选择上述其中一个选项：
  • 当您从“工作表概览”中打开模型化工作表时，请单击“下载”
    按钮旁边的箭头。
  • 当您从面板打开模型化工作表时，请单击“更多”
    图标。
对于标准工作表和多维工作表，“下载”
选项会继续导出层级、维度值和属性值的显示名称。此外，该选项还会继续匹配您在工作表中定义的“显示选项”
。

报告中的显示名称元素

报告构建器使用您在以下报告中选择的显示名称格式，按显示名称呈现元数据元素：
  • 矩阵报告
  • 模型报告
在您查看报告时，系统将通过元素显示名称加载元素。如果您通过将元素拖入构建器构建报告，系统只会显示显示名称。
矩阵报告公式助手将在选择器中按显示名称显示元素。自定义计算中的公式始终使用所选元素的代码。
模型报告筛选器将使用显示名称。

关联的层级刷新中的显示名称元素

在多实例环境中为父级和子级实例添加显示名称后，关联的层级刷新时将使用显示名称替换名称。

OfficeConnect 中的显示名称

对于所有 OfficeConnect 报告元素，我们在标签定义中提供“显示名称”标签类型值。该标签类型值支持 Adaptive Planning 中存在重复的元数据名称。

导入模板

“集成
导入数据”
 中的导入模板格式和说明表明，在以下项的导入中需要使用代码作为唯一标识符：
  • 标准数据导入
  • 模型化工作表数据导入
  • 多维工作表数据导入
  • 交易数据导入
所有维度列都将拆分为 2 列：
  • 维度代码
  • 维度名称
“维度名称”列为可选列。如果此列不存在，则“维度代码”列将变为“维度名称”列。如果维度代码发生变化，则可能存在重复的维度名称值。
层级列表头可指示：
  • 层级代码
账户列表头支持将以下其中一项用作标签：
  • 账户代码
  • 账户
You can select
Import without Code and Name columns for display names
 to import templates without columns for Code and Name fields. This option also allows importing from older templates created before the introduction of display names. When you turn on
Enable Single Column Data Import/Export for Display Name
 in
General Setup
, we apply
Import without Code and Name columns for display names
 across the application and hide the option in the Import page.