跳至主要内容
文档
文档
Adaptive Planning
上次更新时间 ：2023-06-23
创建 Planning 层级加载器

创建 Planning 层级加载器

元数据加载器可将源系统中的分层信息同步到 Planning 模型的层次结构。在您尝试同步之前，层次结构必须已存在于源系统中。
您可以使用 Planning 层级加载器，将有关组织层次结构的元数据从暂存区映射到
Adaptive Planning
使用 Planning 层级加载器批量导入层级，而无需在层级管理中逐一创建。创建加载器后，您可以手动运行加载器，也可以排定时间表让加载器作为加载器的一部分运行。
集成
 任务。
观看视频：
1 分 36 秒

基本步骤

  • 输入数据源设置。
  • 配置列映射。
  • 创建业务规则。
  • 预览加载器输出。
  • 运行加载器或为其排定时间表。

先决条件

Planning 层级加载器需要通过导入现有的数据源来获取暂存数据。请记录下要使用的数据源。
所需权限：集成操作者、数据设计者。

导航

Compass.png 从导航菜单中，转至“集成”
“设计集成”。

输入数据源设置

您可以通过数据源设置，从集成暂存数据中选择要使用的源表格，并指示是否自动新建层级。
最佳做法：创建和编辑加载器时要经常保存。在“操作”面板中，单击“保存”
。如要放弃任何未保存的变更，请单击“关闭”
，然后单击“否”
。
  1. 在“组件库”的“加载器”版块中，单击“新建加载器”
    。
  2. 对于加载器类型，选择“Planning 层级加载器”
    。输入加载器的名称。
  3. 单击“创建”
    。
  4. 输入 Planning 层级加载器的常规属性信息：
    • 源表格：从下拉列表中选择源表格。该列表列出了暂存区中您有权访问的所有可用源表格。
    • 创建层级（如果在 Planning 中未找到
      ）：选中此项可自动新建层级，但可在源系统中找到，但在
      “建模”
      “模型管理
      级别”
      中找不到。如果取消选中此选项，则系统只会更新模型中的现有层级。
    • 将适用的层级更新传播到子级
      ：
      如果变更涉及级联属性，选中此选项可更新子级
      。如果取消选中此选项，则仅更改已明确更新的层级。
    • 禁用工作流时删除工作流条目
      ：
      如果选中此选项，则系统会在您禁用工作流时删除
      工作流中的条目。如果取消选中此选项，则系统不会在您禁用工作流时删除工作流条目。
    • 更新层级可用性时删除不能访问的实际值
      ：如果层级上实际值的开始日期或结束日期发生更改，导致实际值无法访问，请删除无法访问的实际值数据。
    • 发布待实施的管理员发布变更
      ：如果 概念：管理员发布 具有待处理的工作流变更，请选中以发布变更。
    • 保持 Planning 中的顺序
      ：选择此选项可保留 Adaptive Planning 中已在使用的层级排列顺序。
    • 在出现警告时继续
      ：选择此选项可在遇到警告消息时继续加载。
    • 日志级别
      ：选择在运行加载器时日志记录的详细信息类型。
      • 关闭：不记录任何错误。
      • 错误：仅记录严重错误。
      • 信息：记录基本信息，例如加载器的更新时间。
      • 详细
        ：记录有关所有阶段和操作的详细信息。主要用于调试或审核。

配置列映射。

通过“列映射”，您可以将数据源中的列映射到
“建模”
“模型管理
级别”
中可用的层级。您可以取消映射列，以忽略不想加载的暂存数据。您还可以在加载器运行后每一次只取消映射一列，以排查哪些列在日志中生成了错误。
获取现有层级编号列表的唯一方法是使用 exportLevelsAPI。层级编号绝对不会出现在应用程序用户界面中。加载时，层级的“源编号”列会变成层级编号。
如果要对多个列进行映射，可通过“显示”
筛选器来选择以下选项：
  • 全部：
    显示所有 Planning 列。
  • 必选：
    显示所有必选的 Planning 列，例如“父级编号”“层级”。
  • 未映射：
    显示所有未映射的 Planning 列。
  • 已映射：
    显示所有已映射的 Planning 列。
通过“种类”
可选择以下选项：
  • 层级详细信息
    ：显示与层级详细信息相关的列，包括：短名称、币种、在工作流中。“在工作流中”的值必须为布尔值，1 表示 true，0 表示 false。
  • 抵销设置
    ：显示与抵销设置相关的列，包括：抵销层级、抵销贸易合作伙伴。这些布尔值必须为 1（表示 true）或 0（表示 false）。
  • 版本设置
    ：显示与版本设置相关的列，包括：实际值开始时段、实际值结束时段。这些值应为日期格式，例如 2010/01/01。
  • 层级属性
    ：显示与层级属性相关的列。
  • 层级维度
    ：显示与层级维度相关的列。
您可以使用“搜索”
字段来查找列。输入要搜索的完整名称或部分名称，然后单击放大镜图标。与搜索词匹配的所有暂存列都会显示在结果中。
映射列
  1. 单击“列映射”
    。
  2. 从下拉列表中选择一个未映射的列。可映射的列将显示在列表中。当您映射列时，状态指示器会从感叹号 IntegrationMappingUnmapped.png 变为勾号 IntegrationMappingMapped.png。
“列映射”选项卡包含以下列：
  • 状态：
    勾号 “已映射的列” 表示该列为已映射列。感叹号 “未映射的列” 表示未映射的列。
  • Planning 列：
    显示工作表上可映射的所有 Planning 列。由 Planning 列组成的列表包含一组必选 Planning 列，后跟所有其他 Planning 列。必选 Planning 列以带星号的粗体文本显示，并包含一个值列。非必选列包含：短名称、币种。
  • 源列：
    显示暂存表中选自“数据源设置”的列。
启用“导入数据时自动创建维度值”
后，您可以按代码映射属性。属性名称将自动变成代码。
映射层级的父级
“父级编号”列表示层级父级的编号。如要加载到层次结构中的最高层级，源数据中的“父级编号”值必须为空。如果您想在最高层级下创建子级，则“父级编号”的值也必须为空。
有关层级及其父级如何映射到 Planning 的示例，请参见 示例：从电子表格数据源加载层级。
取消映射列
如要取消映射列，请单击“取消映射”
，然后选择以下选项：
  • 全部取消映射：取消映射所有列。
  • 取消映射选定项：仅取消映射已选定的列。
取消映射列时，状态图标会变为感叹号 IntegrationMappingUnmapped.png。
最佳做法：取消映射功能除了可以排查错误并忽略列之外，还可用于变更管理。在数据源中引入新列时，您可以取消映射旧列，以映射新列。

下载和上传映射

您可以下载并修改加载器的映射，然后将该映射上传，以快速解决映射错误。上传流程要么执行全部替换操作，要么不替换任何内容。上传时，系统仅处理文件中的 1 个映射工作表，其他映射工作表将出错并取消上传。
  1. 在“操作”
    窗格中，单击“下载成员映射”
    。
  2. 下载 .XLSX 文件。您还将收到一封电子邮件或 Workday 通知，其中包含映射文件的下载链接。
  3. 打开该文件，然后在映射工作表中查找导致错误的暂存表值。
    如果“Planning 代码”
    列或“Planning 名称”
    列中的任何单元格标有“（无效）”，则表示该代码在 Workday Adaptive Planning 中不再存在。
  4. 更正错误，然后单击“上传成员映射”
    以加载文件。系统不会上传“只读”
    列。
  5. 再次运行加载器。
除非实施合作伙伴或 Workday Adaptive Planning 支持人员指示您单击“清除成员映射”
，否则不要这样做。

创建业务规则

您可以使用业务规则创建 SQL 表达式，以限制可供加载的暂存数据。系统只会加载符合筛选条件的记录。
“业务规则”
选项卡包含用于输入 SQL 的文本区域。
如要创建 SQL 筛选器，请执行以下操作：
  1. 在“业务规则”
    选项卡中，选择“SQL 筛选器”
    。单击“编辑”
    。
  2. 输入 SQL 表达式。您可以单击“可用列”
    列表中的条目，以将该列添加到 SQL 表达式中，而无需键入该列。
  3. 单击“应用”
    以检查您的 SQL 语法。如果存在语法错误，表达式周围的边框会变红。将光标悬停在 SQL 编辑器上可查看语法错误信息。
    有关详细的 SQL 语法帮助，请在“编辑 SQL 筛选器”的“注释”版块中单击“在线帮助”
    。有关详细信息，请参见 SQL 表达式参考信息 。
  4. 更正所有语法错误，然后单击“应用”
    。当您运行加载器时，系统只会导入与 SQL 表达式匹配的暂存行。

预览加载器输出

在运行加载器之前，您可以预览加载器输出，以检查映射并修复验证错误。
当预览加载器输出或手动加载时，系统会验证源数据是否存在错误。以下举例说明验证会检查哪些条件：
  • 创建子层级时未指明其父级层级。
  • 为层级属性指定了一个无法找到的属性值。
  • 数据中不存在层级的源编号值（即为空）。
  • 数据中存在重复的源编号或层级名称。源编号必须唯一。
  • 数据中的 ParentId 与源编号相同。在这种情况下，此列会将自身引用为自身的父级。
  • 导入子层级时，子层级的根会映射到中的现有节点。
    Adaptive Planning
    。对于引入到的新节点，源数据中不存在 parentID。
    Adaptive Planning
    。
  • 系统会将现有节点移至新节点下，并且“新建”标志会处于已禁用状态。当将加载器设置为不创建新层级时，现有层级将移至新节点。
  • 数据在其层次结构中会循环引用。ParentId 将引用自己的子级引用为父级。
  • 某个层级被设为抵销贸易合作伙伴，而下属的某个子级被设为抵销层级。这是因为设为抵销贸易合作伙伴的层级不能具有属于抵销层级的子级。
您还能以 XML 文件格式下载预览输出，以便首先按照您的要求手动验证数据源中的层级，然后再加载这些层级。
  1. 在“操作”面板中，单击“预览加载器输出”
    。
  2. （可选）对“预览加载器输出”设置进行相关输入。您可以输入的信息不尽相同，具体取决于您为此 Planning 层级加载器选择的数据源。更改此处的设置会将新数据导入暂存表和列中。
  3. 单击“预览加载器输出”
    。
加载器随即运行，其中包括所有转换和业务规则。随着加载器的执行，系统会弹出状态窗口，其中会显示相关步骤。如果层级可供加载，加载器会创建一个 XML 文件并发送电子邮件通知，该邮件中会附上包含输出内容的压缩 XML 文件。如果未加载任何层级，该 Zip 文件将包含一条消息，指出未加载任何层级。
加载器运行成功后，系统会弹出其他窗口，您可以在此以压缩 XML 文件的形式下载预览加载器输出。下载弹出窗口可能需要花点时间才会显示，具体取决于层级的数量和文件的大小。

运行加载器

保存具有所需设置的 Planning 层级加载器后，手动运行加载器或将其作为已排定时间表的集成任务运行。
每次运行 Planning 层级加载器后，请等待大约 15 到 30 分钟，以便
Adaptive Planning
 有时间与您的导入进行同步。导入内容越大，同步所需的时间越长。等待时间取决于模型大小和其他因素。
如要手动运行加载器，请单击“操作”面板中的“手动运行”
。
您可以直接从源系统加载层级，也可以使用已导入的暂存值运行加载器。加载器运行时，请根据您的需求选择相应行为。选择“绕过数据导入”
可使用现有的暂存表进行加载。如果将电子表格用作数据源，则无法绕过数据导入。
作为运行流程的一部分，加载器会检查暂存表中的数据是否已正确映射。系统会在加载期间应用多重验证。如在加载期间发生有任何错误发生，都表明需要解决相关问题才能成功完成导入。
将 Planning 层级加载器纳入集成任务中
任何集成任务都可以包含一个或多个加载器。一个任务可以包含其他集成任务，例如脚本型加载器。
最佳做法：为每个加载器设置不同的集成任务。
如果某个任务包含多个加载器，当该任务运行时，系统会在提示中显示每个加载器的参数。如果某个任务的加载器中存在通用参数或共享参数，则该任务仅针对该参数提示一次。您可以选择重设参数提示。
在已排定时间表的任务运行时，系统将使用加载器参数的默认值。
问题排查消息和警告
请参见 参考信息：Planning 层级加载器的消息日志 查看有关加载期间记录的消息的描述。