跳至主要內容
文件
文件
Adaptive Planning
上次更新時間 ：2023-06-23
建立 Planning 層級載入器

建立 Planning 層級載入器

Metadata loaders synchronize hierarchical information from source systems into the hierarchies of your planning model. Your hierarchies should already exist in your source system before you attempt to synchronize.
Planning 層級載入器可讓您將組織階層的相關中繼資料從階段處理區域對應至
Adaptive Planning
.使用 Planning 層級載入器大量匯入層級，而不是在層級管理中一次建立一個層級。建立載入器後，您可以手動執行，或將載入器排定為執行任務的一部分。
Integration
 任務
觀看影片
︰1 分 36 秒

基本步驟

  • 輸入資料來源設定
  • 配置欄對應
  • 建立業務規則
  • 預覽載入器輸出
  • 執行或排程載入器

Prerequisites

Planning 層級載入器需要使用從現有資料來源匯入的階段處理資料。請記下您要使用的資料來源。
必要權限︰整合操作人員、資料設計人員

導覽

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

輸入資料來源設定

「資料來源設定」可讓您從整合階段處理資料中選擇要使用的來源表格，並指出是否自動新建層級。
最佳做法︰在建立和編輯載入器時經常儲存。在「動作」面板中按一下
儲存
。若要捨棄任何未儲存的變更，請按一下
關閉
，然後按一下
否
。
  1. 在元件庫的「載入器」區段中按一下
    新建載入器
    。
  2. 選取
    Planning 層級載入器
    做為載入器類型。輸入載入器的名稱。
  3. 按一下
    建立
    。
  4. 輸入 Planning 層級載入器一般屬性資訊︰
    • 來源表格
      ︰從下拉清單中選取來源表格。清單中的來源表格是您有權存取的階段處理區域中所有可用的表格。
    • 建立層級 (如果在 Planning 中找不到)
      ︰勾選此項可自動建立在來源系統中找到，但在
      建模
      模型管理
      層級
      中找不到的新層級。取消勾選僅更新模型中現有的層級。
    • 將適用的層級更新傳播至子系
      ；
      如果變更涉及串聯屬性，勾選此項可
      更新子系層級。如果未勾選此項，則只會變更明確更新的層級。
    • 在停用工作流程時刪除工作流程項目
      ︰如果您停用工作流程，
      勾選此項可刪除
      工作流程內的項目。如果未勾選此項，則在工作流程停用時不會刪除工作流程項目。
    • 更新層級可用性時刪除無法存取的實際值
      ︰如果層級上實際值的開始或結束日期發生變更，使得實際值無法存取，請刪除無法存取的實際值資料。
    • 發布待處理的管理者發布變更
      ︰如果 Concept: Admin Publishing 有待處理的工作流程變更，勾選此項可發布變更。
    • 保留 Planning 中的順序
      ︰選取此項可保留 Adaptive Planning 中已使用的現有層級排序順序。
    • 略過警告繼續進行
      ︰選取此項可在收到警告訊息時繼續載入。
    • 記錄層級
      ︰選擇在執行載入器時要擷取的詳細資料類型。
      • 關閉︰未記錄任何錯誤。
      • 錯誤︰僅記錄嚴重錯誤。
      • 資訊︰記錄基本資訊，例如載入器的更新時間。
      • 詳細資訊︰有關所有階段和動作的詳細資訊。
        主要用於偵錯或稽核。

配置欄對應

「欄對應」可讓您將資料來源中的欄對應至
「建模
模型管理
層級」
中可用的層級。您可以取消對應欄，忽略不想載入的階段處理資料，也可以在載入器執行後，以一次一欄的方式取消對應，找出哪幾欄會在記錄中產生錯誤。
取得現有層級 ID 清單的唯一方法是使用 exportLevelsAPI。層級 ID 不會顯示在應用程式 UI 中的任何位置。當您載入時，層級的來源 ID 欄會變成「層級 ID」。
如果有多個欄要對應，請使用
顯示
篩選條件來選取︰
  • 全部︰顯示所有 Planning 欄
  • 必填︰顯示所有必填的 Planning 欄，例如父系 ID 和層級
  • 未對應︰顯示所有未對應的 Planning 欄
  • 已對應︰顯示所有已對應的 Planning 欄
使用
種類
來選取︰
  • 層級詳細資料︰顯示與層級詳細資料相關的欄，包括「簡稱」、「貨幣」和「在工作流程中」。
    「在工作流程中」必須是布林值 1 (代表 True) 或 0 (代表 False)。
  • 銷除設定︰顯示與銷除設定相關的欄，包括銷除層級和銷除交易夥伴。
    這些布林值必須為 1 (代表 True) 或 0 (代表 False)。
  • 版本設定︰顯示與版本設定相關的欄，包括實際值開始日期和實際值結束日期。
    這些值應為日期格式，例如 01/01/2010。
  • 層級屬性內容︰顯示與層級屬性內容相關的欄。
  • 層級維度︰顯示與層級維度相關的欄。
您可以使用
搜尋
欄位來尋找欄。輸入要搜尋的完整或部分名稱，然後按一下放大鏡。任何符合搜尋條件的階段處理欄都會出現在結果中。
對應欄
  1. 按一下
    欄對應
    。
  2. 從下拉清單中選取未對應的欄。可用於對應的欄會顯示在清單中。對應欄時，狀態指標會從驚嘆號 IntegrationMappingUnmapped.png 變更為勾號 IntegrationMappingMapped.png。
「欄對應」分頁包含以下各欄︰
  • 狀態︰
    勾號 已對應的欄 表示已對應的欄。驚嘆號 未對應的欄 表示未對應的欄。
  • Planning 欄︰
    顯示工作表上可供對應的所有 Planning 欄。Planning 欄清單包含一組必填 Planning 欄，其後是其他所有 Planning 欄。必填 Planning 欄以加上星號的粗體字表示，且包含一個「值」欄。非必填欄包含「簡稱」和「貨幣」。
  • 來源欄︰
    顯示階段處理表內選自「資料來源設定」的欄。
When
Data import automatically creates dimension values
 is enabled, you can map attributes by code. The attribute name automatically becomes the code.
對應層級的父系
父系 ID 欄指出層級的父系 ID。若要載入至階層中的最高層級，來源資料中的父系 ID 值必須為空白。如果您要在最上層之下建立子系層級，則父系 ID 也必須為空白。
請參閱 「範例︰從試算表資料來源載入層級」， 以取得層級及其父系如何對應至 Planning 的範例。
取消對應欄
若要取消對應欄，請按一下
取消對應
並選擇︰
  • 全部取消對應︰取消對應所有的欄
  • 取消對應選定項目︰僅取消對應選定的欄
取消對應欄會將狀態圖示變更為驚嘆號 IntegrationMappingUnmapped.png。
最佳做法︰除了取消對應以排解錯誤和忽略欄外，您還可使用取消對應來協助管理變更。當資料來源中引進新欄時，您可以取消對應較舊的欄，以對應新的欄。

Download and Upload Mappings

You can download, modify, then upload mappings for loaders to quickly resolve mapping errors. Uploads perform an all or nothing, replace-all action. Only 1 sheet of mappings from the file processes on upload. Additional sheets of mappings will error out and cancel the upload.
  1. Click
    Download Member Mappings
     in the
    Actions
     pane.
  2. Download the .XLSX file. You'll also receive an email or a Workday notification with a download link for the mappings file.
  3. Open the file and look up the staging table values in the mappings sheet causing errors.
    Any cells marked (INVALID) in the
    Planning Code
     or
    Planning Name
     columns indicate this code no longer exists in Workday Adaptive Planning.
  4. Correct the errors and click
    Upload Member Mappings
     to load the file. The
    Read Only
     column doesn't upload.
  5. Run the loader again.
Don't click
Clear Member Mappings
 unless instructed by your implementation partner or Workday Adaptive Planning Support.

建立業務規則

您可使用業務規則來建立 SQL 運算式，以限制可供載入的階段處理資料。只會載入符合篩選條件的記錄。
業務規則
分頁包含用於輸入 SQL 的文字區域。
若要建立 SQL 篩選條件︰
  1. 在
    業務規則
    分頁中，選取
    SQL 篩選條件
    。按一下
    編輯
    。
  2. 輸入 SQL 運算式。您可以按一下
    可用欄
    清單中的項目，自動將該項目帶入 SQL 運算式，而不必手動輸入。
  3. 按一下
    套用
    以檢查您的 SQL 語法。如果您的語法錯誤，則運算式周圍的框線會變成紅色。將滑鼠移至 SQL 編輯器上方，即可查看語法錯誤資訊。
    如需詳細的 SQL 語法說明，請在「編輯 SQL 篩選條件」的「附註」區段中按一下
    線上說明
    。請參閱 「SQL 運算式參考」 以取得更多資訊。
  4. 更正語法中的任何錯誤，然後按一下
    套用
    。執行載入器時，只會匯入符合 SQL 運算式的階段處理列。

預覽載入器輸出

您可以在執行載入器之前，先預覽載入器輸出，以檢查對應並修正驗證錯誤。
在執行預覽載入器輸出或手動載入時，系統會驗證來源資料是否有錯誤。驗證的範例包括檢查是否︰
  • 已建立子層級，但未指出其父系層級。
  • 層級屬性內容已獲派其找不到的屬性內容值。
  • 資料中缺少層級的來源 ID 值 (空白)。
  • 資料中有重複的來源 ID 或層級名稱。來源 ID 不可重複。
  • ParentId 與資料中的來源 ID 相同。若是如此，此欄會將本身參照為其父系。
  • 匯入子層級時，子層級的根會對應至中的現有節點。
    Adaptive Planning
    。引入的新節點的來源資料中沒有 parentID
    Adaptive Planning
    。
  • 現有節點已移至新節點之下，且「新建」標幟已停用。當載入器設為不產生新的層級時，現有層級會移入新節點。
  • 資料的階層中有循環參照。ParentId 會將本身的子系參照為其父系。
  • 有個層級設為銷除交易夥伴，而其中一個子系層級設為銷除層級。設為銷除交易夥伴的層級不能有屬於銷除層級的子系。
您也可以將預覽輸出下載為 XML 檔案，以便在載入之前，依據您的需求手動驗證資料來源中的層級。
  1. 在「動作」面板中按一下
    預覽載入器輸出
    。
  2. (選用) 輸入預覽載入器輸出設定。可輸入的資訊會因您為此 Planning 層級載入器選擇的資料來源而有所不同。在此變更設定會將新資料匯入至階段處理表和欄。
  3. 按一下
    預覽載入器輸出
    。
載入器隨即執行，包括所有轉換和業務規則。狀態快顯視窗會在載入器執行時顯示步驟。如果層級可供載入，載入器會建立 XML 檔案並傳送電子郵件通知，內含採用壓縮 XML 附件形式的輸出。如果未載入任何層級，則 zip 將包含一則訊息，指出未載入任何內容。
額外的快顯視窗可讓您在載入器成功後，將預覽載入器輸出下載為壓縮的 XML 檔案。視層級數目和檔案大小而定，下載快顯視窗可能需要一些時間才會顯示。

執行載入器

使用必要設定儲存 Planning 層級載入器之後，請手動執行載入器，或將其當做排定的整合任務執行。
每次執行 Planning 層級載入器請間隔約 15 - 30 分鐘，
Adaptive Planning
 有時間與您的匯入同步。較大型的匯入需要更長時間進行同步。等候時間取決於模型大小和其他因素。
若要手動執行載入器，請在「動作」面板中按一下
手動執行
。
您可以直接從來源系統載入層級，也可以使用已匯入的階段處理值來執行載入器。請於載入器執行時選擇您想採用的方式。選擇
略過資料匯入
以使用現有的階段處理表進行載入。使用試算表做為資料來源時，無法使用略過資料匯入功能。
在執行流程中，載入器會檢查階段處理表中的資料是否已正確對應。載入期間會套用多重驗證。載入過程中出現的所有錯誤都會指出您需要解決哪些問題，才能順利完成匯入。
在整合任務中包含 Planning 層級載入器
任何整合任務均可有一或多個載入器。任務可以包含其他整合任務，例如指令碼載入器。
最佳做法︰每個載入器各有不同的整合任務。
如果任務包含多個載入器，則在任務執行時，每個載入器的參數都會顯示在提示中。如果任務內的載入器中有一般或共用參數，則該任務只會提示輸入參數一次。您可以選擇覆寫參數提示。
執行排定的任務時，系統會使用載入器的參數預設值。
訊息和警告疑難排解
請參閱「」 Reference: Log Messages for Planning Level Loaders 查看載入期間記錄的訊息說明。