配置 Workday Adaptive Planning Data Agent Manager

先决条件

所需权限：集成 > 数据设计者。
确认您已下载并 安装 Workday Adaptive Planning Data Agent Manager。
确认您有权访问有效的 Adaptive Planning 用户名和密码。
确认您的网络允许
*.adaptiveplanning.com
域，并且您的计算机上已开放端口 443。

导航

从导航菜单中，转至“集成”

“设计集成”。

步骤

启动 Workday Adaptive Planning Data Agent Manager 并验证连接性。
配置 Workday Adaptive Planning Data Agent Manager。

启动 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 Planning
adaptiveplanning.com
域。
使用有效身份证件登录
Adaptive Planning
使用用户名和密码打开 Workday Adaptive Planning Data Agent Manager。如果您的实例已启用 Workday，并且您已将 Workday 中的用户同步到
Adaptive Planning
，则必须使用 Workday 凭据。请参见 使用 Workday 凭据登录数据代理和脚本编辑器。
查看“Service Internet Connection”字段，确保“Service Internet Connection”呈现鲜绿色并指示“Healthy”状态
。

（可选）设置设备群集的基本 URL

通过

“Diagnose and Configure”

按钮，您可以设置设备群集基准的 URL（如果您

面板

作为自定义群集中的设备运行。通过此按钮，您还可以设置

Adaptive Planning

服务器信息。要进行此类变更，请先联系 Adaptive Planning 支持人员。

选择“Set as Required for this Cluster”
，以保存对群集基本 URL 所做的变更。
选择
“Apply Cluster Settings”，以保存对群集设置
所做的变更。
Adaptive Planning
服务器信息，或选择
“恢复默认值”
以恢复默认值。
确保数据代理服务管理器“Setup”
选项卡中的“Service Internet Connection”字段变为绿色并指示“Healthy”
状态。

网关 URL 和地理位置

当您安装和预配代理时，系统会自动填充网关 URL 和地理位置字段。

如果“Setup”

选项卡中的“Recommended Actions”

指出存在网关地理位置冲突，则“Cluster URLs”选项卡中的“Switch Geography”

按钮将激活。

在修改网关和地理位置设置之前，请前往 Workday Customer Center 提交个案以获得支持。

配置 Workday Adaptive Planning Data Agent Manager

在 Workday Adaptive Planning Data Agent Manager 中选择
“Service Info & Options”
。
如果您调整了网络设置，但未看到任何变化，请多按几次“Refresh”
。
检查您的设置：
Remote Access URL (Host Hint)：（
只读）该 URL 唯一标识将 Workday Adaptive Planning Data Agent Manager 与 Integration 服务器连接的网关。
Data Agent Service Id：
（只读）唯一标识特定代理服务。当将代理服务编号附加到远程访问 URL 时，所生成的 URL 会提供对特定数据代理服务进行寻址的完整 URL。
Max Disk Storage per Agent (MB)：
用于存储每个代理提取的信息的磁盘存储空间（以 MB 为单位）。在此字段中输入 -1 表示无限制。
Number of Kettle Job Runners：
此计算机上允许的 Kettle 作业运行器数量，通常为 1。最佳做法是运行器越少越好，因为运行器越多，占用的 RAM 就越多。
Max Memory per Job Runner (MB)：
每个作业运行器的内存上限（以 MB 为单位）。
Max Temp Disk Size per Job Runner (MB)：
每个作业运行器的临时磁盘大小上限（以 MB 为单位）。在此字段中输入 -1 表示无限制。
Trusted Tenants：
此类租户可以在不登录此计算机的情况下，通过 Internet 在此计算机上创建新代理。您也可以选择“Users from any Tenant can create Agents on this PC”
（不推荐），但选择该选项无法保证您能控制对数据的访问。
Restrict Job Runner Access to Files：
默认选中。限制访问受数据代理直接控制的本地文件。如果取消选中，则可以访问整个文件系统中的文件。
Verbose Logging：
选择此选项可进行详细日志记录。
Log all Comms：
记录 Workday Adaptive Planning Data Agent Manager 与代理之间的所有数据库和网络通信条目。
Scrub Non-printing characters：
从输入文本流中移除或转换非法 XML 字符和不需要的字符。需要
scrubbingRules.txt
文件，以移除您不需要的其他字符。有关详细信息，请参见下一版块“从 JDBC 和 Microsoft Dynamics GP 的输入文本流中移除指定的字符”
。
选择“Show Data Agent Service Log”
可显示日志文件，以排查所有连接问题。
选择“Apply Data Agent Service Settings”
以应用变更。
转至 “创建数据代理”继续操作。

从 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”

不会影响 脚本型数据源。您可以使用脚本按需移除或转换字符。

查找日志以排查数据代理问题