配置Workday Adaptive Planning Data Agent Manager
- 确保您已下载并安装Workday Adaptive Planning Data Agent Manager。请参见安装Workday Adaptive Planning Data Agent 管理器。
- 确认您有权访问有效的Adaptive Planning用户名和密码。
- 确认您的网络允许*.adaptiveplanning.com域,并且您的计算机上已开放端口 443。
- 安全性:“数据设计者”权限
在 PC 上安装Workday Adaptive Planning Data Agent Manager 后,必须启动并配置它。
- 在本地计算机上搜索并启动Workday Adaptive Planning Data Agent Manager。
- 在登录提示中选择“Diagnose and Configure Network”,以打开“设置”和“群集 URL”对话框。
- 如果您的网络需要代理设置,请提供代理设置,然后选择“Update Proxy Settings”进行保存。
- 选择“Test Service Internet Access”,然后选择“Test Your Internet Access”,以验证您的连接性。
- 选择“Cluster URLs”并检查设置。默认情况下,管理 URL 和服务器 URL 使用Adaptive Planningadaptiveplanning.com域。
- 使用有效的Adaptive Planning用户名和密码登录,打开Workday Adaptive Planning Data Agent Manager。如果您的实例已启用 Workday,并且您已将用户从Workday同步到Adaptive Planning,则必须使用您的Workday凭据。请参见使用 Workday 凭据登录数据代理和 Script Editor。
- 查看“Service Internet Connection”字段,确保“Service Internet Connection”呈现鲜绿色并指示“Healthy”状态。从数据代理管理器的“Setup”选项卡中,选择“Refresh”,以重新建立与所选服务器的连接。您也可以选择“Diagnose and Configure Network”来调整网络设置。运行Workday Adaptive Planning Data Agent Manager 的计算机应能够使用端口 443 访问 .adaptiveplanning.com。
- (可选)设置“Appliance Cluster Base URL”。如果您的Adaptive Planning在自定义群集中作为设备运行,则您可以通过“Diagnose and Configure”按钮设置设备群集基本 URL。通过此按钮,您还可以设置Adaptive Planning服务器信息的 URL。要进行此类变更,请先联系 Adaptive Planning 支持人员。
- 选择“Set as Required for this Cluster”,以保存对群集基本 URL 所做的变更。
- 选择“Apply Cluster Settings”可保存对Adaptive Planning服务器信息所做的变更,或选择“Restore Defaults”可恢复默认值。
- 验证数据代理服务管理器“Setup”选项卡中的“Service Internet Connection”字段变为绿色并指示“Healthy”状态。
- 要修改“网关”和“地理位置”设置,请先在Workday Customer Center 中提交工单。当您安装和预配代理时,系统会自动填充网关 URL 和地理位置字段。如果“Setup”选项卡中的“Recommended Actions”指示存在网关地理位置冲突,则“Cluster URLs”选项卡中的“Switch Geography”按钮会激活。
- 建立网络连接后,请在Workday Adaptive Planning Data Agent Manager 中选择“Service Info & Options”。
- 如果您调整了网络设置,但未看到任何变更,请多按几次“刷新”。
- 检查您的设置:
选项 描述 远程访问 URL(主机提示)(只读)该 URL 唯一标识将Workday Adaptive Planning Data Agent Manager 与 Integration 服务器连接的网关。数据代理服务编号(只读)唯一标识特定的代理服务。当将代理服务编号附加到远程访问 URL 时,所生成的 URL 会提供对特定数据代理服务进行寻址的完整 URL。每个代理的最大磁盘存储空间 (MB)用于存储每个代理提取的信息的磁盘存储空间(以 MB 为单位)。在此字段中输入 -1 表示无限制。Kettle 作业运行器的数量此计算机上允许的 Kettle 作业运行器数量,通常为 1。最佳做法是运行器越少越好,因为运行器越多,占用的 RAM 就越多。每个作业运行器的最大内存 (MB)每个作业运行器的最大内存大小(以 MB 为单位)。每个作业运行器的临时磁盘大小上限 (MB)每个作业运行器的临时磁盘大小上限(以 MB 为单位)。在此字段中输入 -1 表示无限制。可信租户允许租户通过 Internet 在此计算机上创建新代理,而无需登录此计算机。您还可以选择“Users fromanyTenantcan createAgents on this PC(不推荐)”,但这样做并不能保证您可以控制对数据的访问。限制作业运行器对文件的访问权限默认选中。限制访问受数据代理直接控制的本地文件。如果取消选中,则可以访问整个文件系统中的文件。详细日志记录选择此选项可进行详细日志记录。记录所有通讯记录Workday Adaptive Planning Data Agent Manager 与代理之间的所有数据库和网络通信条目。擦除非打印字符从输入文本流中移除或转换非法 XML 字符和不需要的字符。需要scrubbingRules.txt文件,以移除您不需要的其他字符。 - 要排查任何连接问题,请选择“Show Data Agent Service Log”以显示日志文件。
- 选择“Apply Data Agent Service Settings”以应用变更。
- (可选)创建scrubbingRules.txt文件,以从 JDBC 和 Microsoft Dynamics GP 的输入文本流中移除指定的字符。当数据代理通过 JDBC 数据源或 Microsoft Dynamics GP 数据源加载数据时,系统会将数据以 XML 格式写入本地硬盘。此 XML 文件可能包含控制字符:
- 制表符 (0x9)
- 换行符 (0xA)
- 回车符 (0xD)
- 其他非打印字符
数据代理无需编码,即可将数据流式传输到这些 XML 文件。如果流入 XML 字符范围之外的控制字符,则会显示错误。您可以使用scrubbingRules.txt文件。- 创建一个名为的文本文件scrubbingRules.txt地点C:\Program Files\Workday Adaptive Planning Data Agent.对于 7.1.44 及更低版本的数据代理,请使用C:\Program Files\Adaptive Data Agent
- 列出要在中移除或转换的字符。scrubbingRules.txt文件。
- 每一行都必须包含旧字符和新值(以“=”分隔)。
- 如果要移除某个字符,请将其对应新值留空。每个字符都必须由其对应的 Unicode 值表示。
- 系统会将以 # 开头的行视为注释。
示例scrubbingRules.txt文件内容:#Tab, New Line and CR 0009= 000A= 000D= #|=_ 007C=005F - 启动Workday Adaptive Planning Data Agent Manager。
- 选择“Service Info & Options”选项卡,然后选择“Scrub Non-printing Characters”。
- 选择“Apply Data Agent Service Settings”。如果您选择“Scrub Non-printing Characters”,则所有非法 XML 字符都将从输入数据中消失,即使这些字符未出现在scrubbingRules.txt文件。
- 重新启动数据代理 Windows 服务。
“Scrub Non-printing Characters”不会影响脚本型数据源。您可以使用脚本按需移除或转换字符。请参见步骤:设置脚本型数据源。
查找用于排查数据代理问题的日志:
- C:Windows\System32\config\systemprofile\AppData\Local\Adaptive AgentService\Agents\<agentId>\Logs\AgentLog.txt
- C:Windows\System32\config\systemprofile\AppData\Local\AdaptiveDaemon\DaemonLog.txt
创建数据代理。