跳至主要内容
Adaptive Planning
上次更新时间 :2023-06-23
配置Workday Adaptive Planning Data Agent Manager

配置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 后,必须启动并配置它。
  1. 在本地计算机上搜索并启动Workday Adaptive Planning Data Agent Manager。
  2. 在登录提示中选择
    “Diagnose and Configure Network”
    ,以打开“设置”和“群集 URL”对话框。
  3. 如果您的网络需要代理设置,请提供代理设置,然后选择
    “Update Proxy Settings”
    进行保存。
  4. 选择
    “Test Service Internet Access”
    ,然后
    选择“Test Your Internet Access”
    ,以验证您的连接性。
  5. 选择
    “Cluster URLs”
    并检查设置。
    默认情况下,管理 URL 和服务器 URL 使用Adaptive Planning
    adaptiveplanning.com
    域。
  6. 使用有效的Adaptive Planning用户名和密码登录,打开Workday Adaptive Planning Data Agent Manager。
    如果您的实例已启用 Workday,并且您已将用户从Workday同步到Adaptive Planning,则必须使用您的Workday凭据。请参见使用 Workday 凭据登录数据代理和 Script Editor
  7. 查看“Service Internet Connection”字段,确保“Service Internet Connection”呈现鲜绿色并指示“Healthy”状态
    从数据代理管理器的
    “Setup
    ”选项卡中,选择
    “Refresh”
    ,以重新建立与所选服务器的连接。您也可以选择
    “Diagnose and Configure Network”
    来调整网络设置。
    运行Workday Adaptive Planning Data Agent Manager 的计算机应能够使用端口 443 访问 .adaptiveplanning.com。
  8. (可选)设置“Appliance Cluster Base URL”。
    如果您的Adaptive Planning在自定义群集中作为设备运行,则您可以通过
    “Diagnose and Configure”
    按钮设置设备群集基本 URL。通过此按钮,您还可以设置Adaptive Planning服务器信息的 URL。要进行此类变更,请先联系 Adaptive Planning 支持人员。
    1. 选择
      “Set as Required for this Cluster”
      ,以保存对群集基本 URL 所做的变更。
    2. 选择
      “Apply Cluster Settings”
      可保存对Adaptive Planning服务器信息所做的变更,或选择
      “Restore Defaults”
      可恢复默认值。
    3. 验证数据代理服务管理器
      “Setup
      ”选项卡中的“Service Internet Connection”字段变为绿色并指示
      “Healthy”状态。
  9. 要修改“网关”和“地理位置”设置,请先在Workday Customer Center 中提交工单。
    当您安装和预配代理时,系统会自动填充网关 URL 和地理位置字段。如果
    “Setup”
    选项卡中的“Recommended Actions”指示存在网关地理位置冲突,则
    “Cluster URLs”
    选项卡中的
    “Switch Geography”
    按钮会激活。
  10. 建立网络连接后,请在Workday Adaptive Planning Data Agent Manager 中选择
    “Service Info & Options”
  11. 如果您调整了网络设置,但未看到任何变更,请多按几次
    “刷新”
  12. 检查您的设置:
    选项 描述
    远程访问 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
    文件,以移除您不需要的其他字符。
  13. 要排查任何连接问题,请选择
    “Show Data Agent Service Log”
    以显示日志文件。
  14. 选择
    “Apply Data Agent Service Settings”
    以应用变更。
  15. (可选)创建
    scrubbingRules.txt
    文件,以从 JDBC 和 Microsoft Dynamics GP 的输入文本流中移除指定的字符。
    当数据代理通过 JDBC 数据源或 Microsoft Dynamics GP 数据源加载数据时,系统会将数据以 XML 格式写入本地硬盘。此 XML 文件可能包含控制字符:
    • 制表符 (0x9)
    • 换行符 (0xA)
    • 回车符 (0xD)
    • 其他非打印字符
    数据代理无需编码,即可将数据流式传输到这些 XML 文件。如果流入 XML 字符范围之外的控制字符,则会显示错误。您可以使用
    scrubbingRules.txt
    文件。
    1. 创建一个名为的文本文件
      scrubbingRules.txt
      地点
      C:\Program Files\Workday Adaptive Planning Data Agent.
      对于 7.1.44 及更低版本的数据代理,请使用
      C:\Program Files\Adaptive Data Agent
    2. 列出要在中移除或转换的字符。
      scrubbingRules.txt
      文件。
      • 每一行都必须包含旧字符和新值(以“=”分隔)。
      • 如果要移除某个字符,请将其对应新值留空。每个字符都必须由其对应的 Unicode 值表示。
      • 系统会将以 # 开头的行视为注释。
      示例
      scrubbingRules.txt
      文件内容:
      #Tab, New Line and CR 0009= 000A= 000D= #|=_ 007C=005F
    3. 启动Workday Adaptive Planning Data Agent Manager。
    4. 选择
      “Service Info & Options”
      选项卡,然后选择
      “Scrub Non-printing Characters”
    5. 选择
      “Apply Data Agent Service Settings”
      如果您选择
      “Scrub Non-printing Characters”
      ,则所有非法 XML 字符都将从输入数据中消失,即使这些字符未出现在
      scrubbingRules.txt
      文件。
    6. 重新启动数据代理 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
创建数据代理。