跳至主要內容
文件
文件
Adaptive Planning
上次更新時間 ：2023-06-23
配置 Workday Adaptive Planning Data Agent Manager

配置 Workday Adaptive Planning Data Agent Manager

在您的 PC 上安裝 Workday Adaptive Planning Data Agent Manager 後，您必須啟動並配置它。

Prerequisites

  • 必要權限︰整合 > 資料設計人員
  • 確認您有權存取有效的 Adaptive Planning 使用者名稱和密碼。
  • 驗證您的網路允許
    *.adaptiveplanning.com
     域，且您電腦上的 443 連接埠已開啟。

導覽

Compass.png From the nav menu, go to
Integration
Design Integrations

步驟

  1. 啟動 Workday Adaptive Planning Data Agent Manager 並驗證連線能力。
  2. 配置 Workday Adaptive Planning Data Agent Manager。

啟動 Workday Adaptive Planning Data Agent Manager 並驗證連線能力

  1. 在您的本機電腦上搜尋並啟動 Workday Adaptive Planning Data Agent Manager。
  2. 在登入提示中選取
    Diagnose and Configure Network
     (診斷和配置網路)，以開啟設定和叢集 URL 對話方塊。
  3. 如果您的網路需要 Proxy 設定，請加以提供，然後選取
    Update Proxy Settings
     (更新 Proxy 設定) 以儲存這些設定。
  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 憑證登入資料代理程式和指令碼編輯器」。
  7. 檢視「Service Internet Connection」(服務網際網路連線) 欄位，確認服務網際網路連線呈現亮綠色的「Healthy」(良好) 狀態。
從 Data Agent Manager 的
Setup
 (設定) 分頁，選取
Refresh
 (重新整理) 以重新建立與所選伺服器的連線。
您也可以選取
Diagnose and Configure Network
 (診斷和配置網路) 來調整網路設定。
執行 Workday Adaptive Planning Data Agent Manager 的電腦應可使用連接埠 443 存取 .adaptiveplanning.com。
(選用) 設定設備叢集的基底 URL
Diagnose and Configure (診斷和配置)
 按鈕可讓您設定設備叢集基礎的 URL (如果您的
Dashboards
 在自訂叢集中做為裝置執行。此按鈕還可讓您設定您的
Adaptive Planning
 伺服器資訊。進行變更前，請先聯絡 Adaptive Planning 支援人員。
  1. 選取
    Set as Required for this Cluster
     (針對此叢集設為必要)，儲存叢集基底 URL 的變更。
  2. 選取
    Apply Cluster Settings (套用叢集設定)
    ，儲存變更
    Adaptive Planning
     伺服器資訊，或選取
    「還原預設值」
     以還原預設值。
  3. 在 Data Agent Manager 的
    Setup
     (設定) 分頁中，確認「Service Internet Connection」(服務網際網路連線) 欄位是否變成綠色並呈現「Healthy」(良好) 的狀態。
閘道 URL 和地理位置
當您安裝和佈建代理程式時，系統會自動填入閘道 URL 和地理位置欄位。
如果「Setup」(設定) 分頁中「Recommended Actions」(建議的動作) 中指出有閘道地理位置衝突，「Cluster URLs」(叢集 URL) 分頁中的
Switch Geography
 (切換地理位置) 按鈕便會啟用。
在修改閘道和地理位置設定之前，請先在 Workday Customer Center 建立個案。

配置 Workday Adaptive Planning Data Agent Manager

建立網路連線之後︰
  1. 在 Workday Adaptive Planning Data Agent Manager 中選取
    「Service Info & Options」(服務資訊與選項)
    。
  2. 如果您調整了網路設定，但未看到變更，請選取
    Refresh
     (重新整理) 數次。
  3. 檢閱您的設定︰
    • 遠端存取 URL (主機提示)︰
      (唯讀) 此 URL 可唯一識別連接 Workday Adaptive Planning Data Agent Manager 與 Integration 伺服器的閘道。
    • Data Agent Service Id
       (資料代理程式服務 ID)︰(唯讀) 可唯一識別特定代理程式服務。當代理程式服務 ID 附加至遠端存取 URL 時，產生的 URL 會提供定址特定資料代理程式服務的完整 URL。
    • Max Disk Storage per Agent (MB)
       (每個代理程式的磁碟儲存空間上限 (MB))︰用於儲存每個代理程式所擷取資訊的磁碟儲存空間 (以 MB 為單位)。輸入 -1 表示無限制。
    • Number of Kettle Job Runners
       (Kettle 作業執行器數目)︰此電腦允許的 Kettle 作業執行器數目，通常只有 1 個。最佳做法︰越少越好，因為執行器越多，佔用的 RAM 空間越大。
    • Max Memory per Job Runner (MB)
       (每個作業執行器的記憶體上限 (MB))︰每個作業執行器的記憶體上限 (以 MB 為單位)。
    • Max Temp Disk Size per Job Runner (MB)
       (每個作業執行器的臨時磁碟大小上限 (MB))︰每個作業執行器的臨時磁碟大小上限 (以 MB 為單位)。輸入 -1 表示無限制。
    • Trusted Tenants
       (受信任的用戶)︰允許用戶在不登入此電腦的情況下，透過網際網路在此電腦上新建代理程式。您也可以選取「Users from any Tenant can create Agents on this PC」(任何用戶的使用者均可在此 PC 建立代理程式)，但不建議您這樣做，因為無法確保您可以控制資料的存取權。
    • Restrict Job Runner Access to Files
       (限制作業執行器存取檔案)︰預設為勾選狀態。限制存取直接在資料代理程式控制之下的本機檔案。取消勾選即可存取整個檔案系統的檔案。
    • Verbose Logging
       (詳細記錄)︰選取以進行詳細記錄。
    • 記錄所有通訊︰
      記錄 Workday Adaptive Planning Data Agent Manager 與代理程式之間的所有資料庫和網路通訊。
    • Scrub Non-printing characters
       (清除非列印字元)︰從輸入文字資料流中移除或轉換非法的 XML 字元和不需要的字元。必須有
      scrubbingRules.txt
       檔案，用於移除不需要的其他字元。請參閱下一節「從 JDBC 和 Microsoft Dynamics GP 的輸入文字資料流中移除指定的字元」，以取得詳細資訊。
  4. 選取
    Show Data Agent Service Log
     (顯示資料代理程式服務記錄) 來顯示記錄檔，並排解任何連線問題。
  5. 選取
    Apply Data Agent Service Settings
     (套用資料代理程式服務設定) 以套用變更。
從 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