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

创建 Planning 维度加载器

元数据加载器可将源系统中的分层信息同步到 Planning 模型的层次结构。在您尝试同步之前，层次结构必须已存在于源系统中。
Planning 维度加载器请求具有最大值限制，在分层维度中最多只能更新 10000 个维度值，而在单层维度中最多只能更新 40000 个维度值。在加载器请求中新建维度值时，这些限制则不适用。
您可以使用 Planning 维度加载器，将有关维度值的元数据从暂存区映射到
Adaptive Planning
。Planning 维度加载器的主要优势在于，您可以借助该加载器批量导入维度值，而无需在“建模”>“模型管理”>“维度”中逐一创建。创建加载器后，您可以手动运行加载器，也可以排定时间表让加载器作为集成 任务的一部分运行。

如要创建 Planning 维度加载器，请按以下流程操作：
  1. 输入数据源设置。
  2. 配置列映射。
  3. 创建业务规则。
  4. 预览加载器输出。
  5. 运行加载器或为其排定时间表。

准备工作

Planning 维度加载器需要通过导入现有的 数据源来获取暂存数据。

输入数据源设置

在“数据源设置”中，您可以从暂存数据中选择要使用的源表格，选择要加载的 Planning 维度，以及是否应自动创建新维度值。
  1. 导航至“集成”>“设计集成”
    。
  2. 在“组件库”的“加载器”区域中，单击“新建加载器”
    。
  3. 对于加载器类型，选择“Planning 维度加载器”
    。输入加载器的名称。
  4. 单击“创建”
    。
最佳做法：创建和编辑加载器时，要经常在“操作”面板中单击“保存”
。如果您想放弃任何未保存的变更，单击“关闭”
，然后再单击“否”
。
输入 Planning 维度加载器的常规属性信息：
  • 源表格：
    从下拉列表中选择源表格。该列表中列出了暂存区中您有权访问的所有可用源表格。
  • Planning 维度：
    从所有维度中选择一个维度，以便源载入其中。列出的维度来自“建模”>“模型管理”>“维度”。
  • 创建维度值（如果在 Planning 中未找到）：
    如果可以在源系统中可以找到某个维度，但在“建模”>“模型管理”>“维度”中找不到，则选中此框即可自动新建维度值。如果未选中此选项，则系统仅对现有维度值执行更新，而不会创建新维度。
    • 如果在“建模”>“模型管理”>“维度”中，您载入的维度未启用“导入数据时自动创建维度值”，则加载器将向您发出警告。
  • 日志级别：
    选择运行加载器时日志记录的详细信息类型。
    • 错误
      ：仅记录严重错误。
    • 信息
      ：记录基本信息，例如加载器的更新时间。
    • 详细
      ：提供有关所有阶段和操作的详细信息。此级别主要用于调试或审核，因为其产生的日志信息量可能超出一般用途的实际所需。

配置列映射

您可以借助“列映射”，将数据源中的列映射到“建模”>“模型管理”>“维度”中的可用维度值。
如果要对多个列进行映射，您可以使用“显示”
筛选器来选择以下选项：
  • 全部：
    显示所有 Planning 列。
  • 必选：
    显示所有必选的 Planning 列。
  • 未映射：
    显示所有未映射的 Planning 列。
  • 已映射：
    显示所有已映射的 Planning 列。
您可以使用“搜索”
字段来查找列。输入要搜索的完整名称或部分名称，然后单击放大镜图标。与搜索词匹配的所有暂存列都会显示在结果中。
映射列
  1. 单击“列映射”
    。
    “列映射”选项卡包含以下项目：
    • 状态：
      指示某个 Planning 列是否已映射。勾号的“ 已映射的列” 表示该列为已映射列。感叹号 “未映射的列” 表示未映射的列。
    • Planning 列：
      显示工作表上可映射的所有 Planning 列。由 Planning 列组成的列表包含一组必选 Planning 列，后跟所有其他 Planning 列。必选 Planning 列以带星号的粗体文本显示，并包含一个值列。非必选列包含：短名称、描述。
    • 源列：
      显示暂存表中选自“数据源设置”的列。
  2. 选择一个未映射的列，然后单击下拉列表。下拉列表中将显示一个列表，其中包括各个可作为映射目标的列。映射列时，状态指示器会从红色 IntegrationMappingUnmapped.png 变为绿色 IntegrationMappingMapped.png。
启用“导入数据时自动创建维度值”
后，您可以按代码映射属性。属性名称将自动变成代码。
有关维度值及其父级如何映射到 Planning 的示例，请参见 示例：从电子表格数据源加载维度值。
加载时更改 Planning 维度值名称
如要在加载时更改 Planning 维度值的名称，请执行以下操作：
  1. 选择在源中唯一标识维度值的源列。
  2. 将编号列映射到维度值编号。
  3. 将名称映射到维度值名称。
取消映射列
如要取消映射列，请单击“取消映射”
，然后选择以下选项：
  • 全部取消映射
    ：取消映射所有列。
  • 取消映射选定项
    ：
     仅取消映射选定的列。
取消映射列时，其映射状态图标会变为红色 IntegrationMappingUnmapped.png。
映射与列表维度关联的属性
您可以通过映射数据源导入中的列，将属性与列表维度相关联。
将属性与维度相关联仅适用于列表维度。您不能将属性与分层维度相关联。
范围内
Adaptive Planning
 您可以访问
“模型管理”
>
“维度”
，然后单击某个维度来查看其详细信息，从而确定该维度是否为列表维度。
在“数据源设置”中，选择一个列表维度作为“Planning 维度”
。
由于维度是列表维度，因此属性可作为列映射中的列。
由于列表维度并非分层维度，因此“源列”中没有 ParentId 选项。

下载和上传映射

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

创建业务规则

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

预览加载器输出

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

运行加载器

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

加载对源维度值的更改

如果已对源维度值建立映射，则 Planning 维度加载器可以在加载时重命名维度值。
下表说明了加载器已建立的映射。源维度值“美国”映射到源编号列“1001”。
Planning 维度值
源编号列
源维度值
美国
1001
美国
加拿大
1002
加拿大
在源系统中，如果将“美国”更改为“美利坚合众国”，则 Planning 维度加载器可以在加载时应用此变更，因为加载器会维持源编号列“1001”与维度值“美国”的 Planning 内部编号之间的映射。
Planning 维度值
源编号列
源维度值
美国
1001
美利坚合众国
加拿大
1002
加拿大
运行加载器会将 Planning 中的维度值从“美国”更改为“美利坚合众国”。