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

创建 Planning 账户加载器

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

基本步骤

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

先决条件

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

导航

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

输入数据源设置

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

配置列映射

您可以借助“列映射”，将数据源中的列映射到“建模”
>“模型管理”
>“账户”
中的可用账户属性。您可以取消映射列，以忽略不想加载的暂存数据。您还可以在加载器运行后每一次只取消映射一列，以排查哪些列在日志中生成了错误。
如果要对多个列进行映射，可通过“显示”
筛选器来选择以下选项：
  • 全部：
    显示所有 Planning 列。
  • 必选：
    显示所有必选的 Planning 列，例如“父级编号”“账户”。
  • 未映射：
    显示所有未映射的 Planning 列。
  • 已映射：
    显示所有已映射的 Planning 列。
通过“种类”
可选择以下选项：
  • 账户详细信息：
    显示与账户详细信息相关的列：
    • 账户代码
    • 短名称
    • 汇总至
    • 描述
    • 类型
    • 加权方式
    • 显示文本
    • 计划值输入方式
    • 实际值输入方式
    • 实际值覆盖
    • 余额类型
    • 在工作流中
      “在工作流中”的值必须为布尔值，1 表示 true，0 表示 false。
  • 全部：显示所有列。您只能在“全部”
    种类中查看“数据输入类型”
    ：
    • “数据输入类型”
      的有效值分为：标准、多维、空白。
    • 若值为空白，“数据输入类型”
      会继承父级账户的类型。
    • 如果父级账户的“数据输入类型”
      为多维，新账户将默认为多维类型。否则，新账户默认为标准类型。
    • 系统会忽略非叶账户的“数据输入类型”
      变更。系统会自动为所有非叶账户计算新的数据输入类型
      。
  • 数据类型
    ：显示与账户数据类型设置相关的列，相关设置包括：账户时间层级、显示格式、默认公式、加权平均折算、重置余额、重置时结转余额、小数位数、汇率。
  • 工作表
    ：显示与账户在工作表上的显示方式相关的列，相关设置包括：不显示在工作表中、首次打开时展开。
  • 账户属性
    ：显示与账户属性相关的列，包括列出与账户关联的所有账户属性。
  • 数据隐私
    ：显示与账户数据的公开或私密程度相关的列，相关设置包括：包含工资详细信息。
  • 合并
    ：显示与合并设置相关的列，相关设置包括：公司间、抵销贸易合作伙伴、子公司。仅适用于已启用合并模块的实例。
您可以使用“搜索”
字段来查找列。输入要搜索的完整名称或部分名称，然后单击放大镜图标。与搜索词匹配的所有暂存列都会显示在结果中。
映射列
  1. 单击“列映射”
    。
  2. 从下拉列表中选择一个未映射的列。可映射的列将显示在列表中。当您映射列时，状态指示器会从感叹号 IntegrationMappingUnmapped.png 变为勾号 IntegrationMappingMapped.png。
“列映射”
选项卡包含以下列：
  • 状态：
    勾号 “已映射的列” 表示该列为已映射列。感叹号 “未映射的列” 表示未映射的列。
  • Planning 列：显示可映射的所有 Planning 列。由 Planning 列组成的列表包含一组必选 Planning 列，后跟所有其他 Planning 列。必选 Planning 列以带星号的粗体文本显示，并包含一个值列。非必选列包含：短名称、描述。
  • “源编号”列：显示暂存表中选自“数据源设置”的列。
  • 源账户代码列：指示账户代码列，以简化映射流程。中的每个账户
    Adaptive 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 文件的形式下载预览加载器输出。下载弹出窗口可能需要花点时间才会显示，具体取决于账户的数量和文件的大小。
以下举例说明已下载且包含输入内容的解压缩 XML 文件：
预览加载器输出 - 元数据的 XML 文件

运行加载器

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