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

创建 Planning 属性加载器

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

基本步骤

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

先决条件

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

导航

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

输入数据源设置

您可以通过数据源设置，从暂存数据中选择要使用的源表格，并指示是否自动新建属性。
最佳做法：创建和更新加载器时要经常保存。在“操作”面板中，单击“保存”
。如要放弃任何未保存的变更，请单击“关闭”
，然后单击“否”
。
  1. 在“组件库”的“加载器”版块中，选择“新建加载器”
    。
  2. 对于加载器类型，选择“Planning 属性加载器”
    。输入加载器的名称。
  3. 选择“创建”
    。
  4. 输入属性加载器的常规属性信息：
    • 源表格：从下拉列表中选择源表格。此列表包含您可以访问的暂存区中所有可用的表格。
    • Planning 属性
      ：选择范围内的属性
      Adaptive Planning
       以加载到。
    • 创建属性值（如果在 Planning 中未找到）：如果可以在源系统中找到某个属性值，但在“建模”>“模型管理”>“属性”中找不到，则可选择此选项自动新建属性值。如果取消选择此选项，系统只会更新模型中的现有属性值。
    • 发布待实施的管理员发布变更
      ：如果 概念：管理员发布 具有待处理的工作流变更，选择此选项可发布变更。
    • 日志级别：选择在运行加载器时日志记录的详细信息类型。
      • 关闭：不记录任何错误。
      • 错误：仅记录严重错误。
      • 信息：记录基本信息，例如加载器的更新时间。
      • 详细
        ：记录有关所有阶段和操作的详细信息。主要用于调试或审核。

配置列映射

您可以借助“列映射”，将数据源中的列映射到“建模”
>“模型管理”
>“属性”
中的可用属性。您可以取消映射列，以忽略不想加载的暂存数据。您还可以在加载器运行后每一次只取消映射一列，以排查哪些列在日志中生成了错误。
如果要对多个列进行映射，可通过“显示”
筛选器来选择以下选项：
  • 全部：
    显示所有 Planning 列。
  • 必选：
    显示所有必选的 Planning 列，例如“父级编号”“属性”。
  • 未映射：
    显示所有未映射的 Planning 列。
  • 已映射：
    显示所有已映射的 Planning 列。
您可使用“种类”
来选择所需列。
  • 全部：显示所有列。属性不使用种类。
您可以使用“搜索”
字段来查找列。输入要搜索的完整名称或部分名称，然后单击放大镜图标。与搜索词匹配的所有暂存列都会显示在结果中。
映射列
“列映射”选项卡包含以下列：
  • 状态：
    勾号 “已映射的列” 表示该列为已映射列。感叹号 “未映射的列” 表示未映射的列。
  • Planning 列：
    显示工作表上可映射的所有 Planning 列。由 Planning 列组成的列表包含一组必选 Planning 列，后跟所有其他 Planning 列。必选 Planning 列以带星号的粗体文本显示，并包含一个值列。非必选列包括描述。
  • 源列：
    显示暂存表中选自“数据源设置”的列。
  1. 单击“列映射”
    。
  2. 从下拉列表中选择一个未映射的列。可映射的列将显示在列表中。当您映射列时，状态指示器会从感叹号 IntegrationMappingUnmapped.png 变为勾号 IntegrationMappingMapped.png。
映射属性的父级
“父级编号”列表示属性值父级的编号。如要加载到层次结构中最高层级的属性，源数据中的“父级编号”值必须为空。如果您想在最高层级下创建子级属性值，则“父级编号”的值也必须为空。
取消映射列
如要取消映射列，请单击“取消映射”
，然后选择以下选项：
  • 全部取消映射：取消映射所有列。
  • 取消映射选定项：仅取消映射已选定的列。
取消映射列时，状态图标会变为感叹号 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 与源编号相同。在这种情况下，此列会将自身引用为自身的父级。
  • “已将现有节点移至新节点下”和
    “创建属性值（如果在 Planning 中未找到）”选项
     处于已禁用状态。当加载器设置为不创建新的属性值时，现有属性将移至新节点。
  • 数据在其层次结构中会循环引用。ParentId 将引用自己的子级引用为父级。
您还能以 XML 文件格式下载预览输出，以便首先按照您的要求手动验证数据源中的属性，然后再加载这些属性。
  1. 在“操作”面板中，单击“预览加载器输出”
    。
  2. （可选）对“预览加载器输出”设置进行相关输入。您可以输入的信息不尽相同，具体取决于您为此 Planning 属性加载器选择的数据源。更改此处的设置会将新数据导入暂存表和列中。
  3. 单击“预览加载器输出”
    。
加载器随即运行，其中包括所有转换和业务规则。随着加载器的执行，系统会弹出状态窗口，其中会显示相关步骤。如果属性可供加载，加载器会创建一个 XML 文件并发送电子邮件通知，该邮件中会附上包含输出内容的压缩 XML 文件。如果未加载任何属性，该 Zip 文件将包含一条消息，指出未加载任何属性。
加载器运行成功后，系统会弹出其他窗口，您可以在此以压缩 XML 文件的形式下载预览加载器输出。下载弹出窗口可能需要花点时间才会显示，具体取决于属性的数量和文件的大小。

运行加载器

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