创建规划关联加载器
通过 Planning 关联加载器,您可以将有关用户维度和层级关联的元数据从暂存区映射到
Adaptive Planning
。关联可将层级和自定义维度与用户连接。层级所有权是一种用户关联,可将用户与层级连接。与常规层级关联不同,层级所有权还附带其他权限。请参见。创建加载器后,您可以手动运行加载器,或排定时间表让加载器作为集成任务的一部分运行。请参见 创建集成任务。
先决条件
先决条件
- Planning 关联加载器需要通过导入现有的 数据源来获取暂存数据。
- 所需权限:模型、集成操作者、数据设计者。
基本步骤
- 输入数据源设置。
- 配置列映射。
- 创建业务规则。
- 预览加载器输出。
- 运行加载器或为其排定时间表。
导航
从导航菜单中,转至“集成”“设计集成”。 输入数据源设置
您可以通过数据源设置,从集成暂存数据中选择要使用的源表格,并选择要加载的关联。
- 在“组件库”的“加载器”窗格中,选择“新建加载器”。
- 对于加载器类型,选择“规划关联加载器”。输入加载器的名称。
- 单击“创建”。
- 在“数据源设置”选项卡中,输入关联加载器常规属性信息:
- 源表格:从下拉列表中选择源表格。该列表列出了暂存区中您有权访问的所有可用源表格。
- 映射配置文件:您可以在加载器创建过程中链接到映射配置文件。从下拉列表中选择映射配置文件。该列表列出了您有权访问的映射配置文件。详情请参见 Planning 数据加载器的映射配置文件版块。此映射配置文件以及作为元数据加载器的一部分加载的所有映射,都会映射 Planning 层级和维度。请参见 创建 Planning 数据加载器。示例:如果关联加载器的层级列值为“999999”(对于 Workday,则为 WID),那么映射配置文件将确定所引用的 Planning 层级。
- 层级或维度:选择层级所有权或层级关联所对应的层级。选择维度以加载维度关联。
- 属性:(可选)为层级或维度选择一个 Adaptive Planning 属性。这样,您就可以映射和加载层级或维度属性的关联。
- 模式:选择“更新”以针对层级子集修改关联或所有权指定。此操作会更新层级,而不是用户。更新层级需要负载中所有用户与该层级关联。选择“全部替换”可删除负载中提及的关联内的所有用户,并进行替换。
- 如果您将 Adaptive Planning 与 Workday Human Capital Management 或 Workday Financials 搭配使用,则系统会通过“更新”自动填充“模式”。
- 如果您未将 Adaptive Planning 与 Workday Human Capital Management 或 Workday Financials 搭配使用,则系统会通过“全部替换”自动填充“模式”。
- 在出现警告时继续:选中此项可在出现警告时继续运行加载器。如果您未选中此项,则加载器将在遇到警告时停止运行。启用此功能意味着加载器会跳过未映射的维度或层级并在日志中创建警告,同时系统将允许加载器继续进行处理。
- 日志级别:选择在运行加载器时日志记录的详细信息类型。
- 关闭:不记录任何错误。
- 错误:仅记录严重错误。
- 信息:记录基本信息,例如加载器的更新时间。
- 详细:记录有关所有阶段和操作的详细信息。主要用于调试或审核。
配置列映射
您可以借助“列映射”,将数据源中的列映射到“建模”>“模型管理”>“层级”或“建模”>“模型管理”>“维度”中的可用关联。您必须映射用户列和 Planning 列。
如果您是在此环境中运行用户同步的 Workday 客户,则必须将用户列映射到包含 Workday 编号的源列。如果您未运行用户同步或不是 Workday 客户,则需要将用户列映射到包含用户名或电子邮件地址的源列。
如果存在多个要映射的 Planning 列,请使用“显示”
筛选器来选择以下选项:
- 全部:显示所有用户。
- 必选:显示所有必选的 Planning 列,例如“用户”“层级”。
- 未映射:显示所有未映射的 Planning 列。
- 已映射:显示所有已映射的 Planning 列。
您可以使用“搜索”
字段来查找列。输入要搜索的完整名称或部分名称,然后单击放大镜图标。与搜索词匹配的所有暂存列都会显示在结果中。
- 映射列
- 单击“列映射”选项卡。“列映射”选项卡包含以下列:
- 状态:勾号
表示该列为已映射列。感叹号
表示未映射的列。 - Planning 列:显示可映射的所有 Planning 列。必选 Planning 列以带星号的粗体文本显示。
- 源列:显示暂存表中选自“数据源设置”的列。
- 选择一个未映射的列,然后单击下拉列表。下拉列表中将显示一个列表,其中包括各个可作为映射目标的列。映射列时,状态指示器会从红色
变为绿色
。
- 针对层级所有权的映射列
- 如果您只想加载层级所有权,请勿映射“源列”中层级的关联代码标识符。将关联代码留空会在“管理”>“关联”中生成层级所有权。
- 针对层级和维度关联的映射列
- 如要加载层级和维度关联,请映射“源列”中关联代码的标识符,例如“参考编号”。您不能在单个加载器中同时加载层级所有权和层级关联,而是需要创建一个用于层级所有权的加载器,再单独创建一个用于层级关联的加载器。
- 用于属性关联的映射列
- 如果要加载具有关联的层级或维度属性,请在“源列”中映射这些属性。属性显示在映射底部的“关联名称”下方。
- 取消映射列
- 您可以取消映射列,以忽略不想加载的暂存数据。您还可以在加载器运行后每一次只取消映射一列,以排查哪些列在日志中生成了错误。如要取消映射列,请单击“取消映射”,然后选择以下选项:
- 全部取消映射:取消映射所有列。
- 取消映射选定项:仅取消映射已选定的列。
取消映射列时,状态图标会变为感叹号
。
创建业务规则。
您可以使用业务规则创建 SQL 表达式,以限制可供加载的暂存数据。系统只会加载符合筛选条件的记录。
“业务规则”选项卡包含用于输入 SQL 的文本区域:
如要创建 SQL 筛选器,请执行以下操作:
- 在“业务规则”选项卡中,选择“SQL 筛选器”。单击“编辑”。
- 输入 SQL 表达式。您可以单击“可用列”列表中的条目,以将该列添加到 SQL 表达式中,而无需键入该列。
- 单击“应用”以检查您的 SQL 语法。如果存在语法错误,表达式周围的边框会变红。将光标悬停在 SQL 编辑器上可查看语法错误信息。如需详细的 SQL 语法帮助,请在“编辑 SQL 筛选器”的“注释”版块中单击“在线帮助”。请参见 参考信息:SQL 表达式。
- 更正所有语法错误,然后单击“应用”。当您运行加载器时,系统只会导入与 SQL 表达式匹配的暂存行。
预览加载器输出
您可以在执行完全加载之前预览加载器输出,以检查映射是否按您的要求执行。您还能以 XML 文件格式下载加载器输出,以便首先按照您的要求手动验证数据源中的用户层级所有权关联,再加载这些值。
在“操作”窗格中,单击“预览加载器输出”。
加载器随即运行,在运行过程中会应用所有转换和业务规则。随着加载器的执行,系统会弹出状态窗口,其中会显示相关步骤。如果存在需要加载的用户关联值,加载器会创建一个 XML 文件并发送电子邮件通知,该邮件中会附上包含加载器输出内容的压缩 XML 文件。
加载器运行成功后,系统会弹出其他窗口,您可以在此以压缩 XML 文件的形式下载预览加载器输出。下载弹出窗口可能需要花点时间才会显示,具体取决于关联值的数量和文件的大小。
- 修复验证错误
- 当预览加载器输出或手动加载时,系统会验证源数据是否存在错误。以下举例说明验证会检查哪些条件:
- 数据中不存在用户或层级的源编号值以及维度值的源编号值(即为空)。
- 源编号未映射。
运行加载器
为规划关联加载器配置完所有必需的设置并保存后,您可以手动运行该加载器,也可以排定时间表让其作为集成任务运行。
每次运行 Planning 关联加载器后,等待大约 15 到 30 分钟,以便
Adaptive Planning
有时间与您的导入进行同步。导入内容越大,同步所需的时间越长。等待时间取决于模型大小和其他因素。您可以直接从源系统导入,也可以使用已导入的暂存值运行加载器。加载器运行时,请根据您的需求选择相应行为。选择“绕过数据导入”可使用现有的暂存表进行加载。如果将电子表格用作数据源,则无法绕过数据导入。
作为运行流程的一部分,加载器会检查暂存表中的数据是否已正确映射。系统会在加载期间应用多重验证。如在加载期间发生有任何错误发生,都表明需要解决相关问题才能成功完成导入。
- 将规划关联加载器纳入集成任务中
- 任何集成 任务 都可以包含一个或多个加载器。任务还可以包含其他集成任务以及 Discovery 指标加载器和脚本型加载器。最佳做法:为每个加载器设置不同的集成任务。如果某个任务包含多个加载器,则在运行任务时会显示每个加载器的参数。如果在某个任务内的加载器中使用了通用/共享参数,则该任务仅会对此参数作出一次提示。您可以选择重设参数提示。在运行已排定时间表的任务时,系统将使用在创建加载器时所存储参数的默认值。