跳至主要內容
文件
文件
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
。使用屬性內容載入器從外部系統大量匯入屬性內容並加以同步，而不是在屬性內容管理中一次建立一個屬性內容。建立載入器後，您可手動執行，或排定在執行整合任務時一併執行載入器。
觀看影片
︰1 分 32 秒

基本步驟

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

Prerequisites

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

導覽

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

輸入資料來源設定

「資料來源設定」可讓您從階段處理資料中選擇要使用的來源表格，並指出是否自動新建屬性內容。
最佳做法︰在建立和更新載入器時經常儲存。在「動作」面板中按一下
儲存
。若要捨棄任何未儲存的變更，請按一下
關閉
，然後按一下
否
。
  1. 在元件庫的「載入器」區段中選取
    新建載入器
    。
  2. 選取
    Planning 屬性內容載入器
    做為載入器類型。輸入載入器的名稱。
  3. 選取
    建立
    。
  4. 輸入屬性內容載入器一般屬性資訊︰
    • 來源表格
      ︰從下拉清單中選取來源表格。該清單包含您可存取的階段處理區域中的所有可用表格。
    • Planning 屬性內容
      ︰選取內的屬性內容
      Adaptive Planning
       要載入的項目。
    • 建立屬性內容值 (如果在 Planning 中找不到)
      ︰選取此項可自動建立在來源系統中找到，但在「建模」>「模型管理」>「屬性內容」中找不到的新屬性內容值。取消選取此項只會更新模型中現有的屬性內容值。
    • 發布待處理的管理者發布變更
      ︰如果 Concept: Admin Publishing 有待處理的工作流程變更，選取以發布變更。
    • 記錄層級︰選擇在執行載入器時要擷取的詳細資料類型。
      • 關閉︰未記錄任何錯誤。
      • 錯誤︰僅記錄嚴重錯誤。
      • 資訊︰記錄基本資訊，例如載入器的更新時間。
      • 詳細資訊︰有關所有階段和動作的詳細資訊。
        主要用於偵錯或稽核。

配置欄對應

欄對應可讓您將資料來源中的欄對應至
建模
 >
模型管理
 >
屬性內容
中可用的屬性內容。您可以取消對應欄，忽略不想載入的階段處理資料，也可以在載入器執行後，以一次一欄的方式取消對應，找出哪幾欄會在記錄中產生錯誤。
如果有多個欄要對應，請使用
顯示
篩選條件來選取︰
  • 全部︰顯示所有 Planning 欄
  • 必填︰顯示所有必填的 Planning 欄，例如父系 ID 和屬性內容
  • 未對應︰顯示所有未對應的 Planning 欄
  • 已對應︰顯示所有已對應的 Planning 欄
使用
種類
來選取。
  • 全部︰顯示所有欄。
    屬性內容不會使用種類。
您可以使用
搜尋
欄位來尋找欄。輸入要搜尋的完整或部分名稱，然後按一下放大鏡。任何符合搜尋條件的階段處理欄都會出現在結果中。
對應欄
「欄對應」分頁包含以下各欄︰
  • 狀態︰
    勾號 已對應的欄 表示已對應的欄。驚嘆號 未對應的欄 表示未對應的欄。
  • Planning 欄︰
    顯示工作表上可供對應的所有 Planning 欄。Planning 欄清單包含一組必填 Planning 欄，其後是其他所有 Planning 欄。必填 Planning 欄以加上星號的粗體字表示，且包含一個「值」欄。非必填欄包括「說明」。
  • 來源欄︰
    顯示階段處理表內選自「資料來源設定」的欄。
  1. 按一下
    欄對應
    。
  2. 從下拉清單中選取未對應的欄。可用於對應的欄會顯示在清單中。對應欄時，狀態指標會從驚嘆號 IntegrationMappingUnmapped.png 變更為勾號 IntegrationMappingMapped.png。
對應屬性內容的父系
父系 ID 欄指出屬性內容值的上層 ID。若要載入至階層中的最上層屬性內容，來源資料中的父系 ID 值必須為空白。如果您要在最上層之下建立子系屬性內容值，則父系 ID 也必須為空白。
取消對應欄
若要取消對應欄，請按一下
取消對應
並選擇︰
  • 全部取消對應︰取消對應所有的欄
  • 取消對應選定項目︰僅取消對應選定的欄
取消對應欄會將狀態圖示變更為驚嘆號 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 相同。若是如此，此欄會將本身參照為其父系。
  • 現有節點已移至新節點之下，並已停用
    「如果在 Planning 中找不到則建立屬性內容值」
    。當載入器設為不產生新的屬性內容值時，現有屬性內容會移入新節點。
  • 資料的階層中有循環參照。ParentId 會將本身的子系參照為其父系。
您也可以將預覽輸出下載為 XML 檔案，以便在載入之前，依據您的需求手動驗證資料來源中的屬性內容。
  1. 在「動作」面板中按一下
    預覽載入器輸出
    。
  2. (選用) 輸入預覽載入器輸出設定。可輸入的資訊會因您為此 Planning 屬性內容載入器選擇的資料來源而有所不同。在此變更設定會將新資料匯入至階段處理表和欄。
  3. 按一下
    預覽載入器輸出
    。
載入器隨即執行，包括所有轉換和業務規則。狀態快顯視窗會在載入器執行時顯示步驟。如果屬性內容可供載入，載入器會建立 XML 檔案並傳送電子郵件通知，內含採用壓縮 XML 附件形式的輸出。如果未載入任何屬性內容，則 zip 將包含一則訊息，指出未載入任何屬性內容。
額外的快顯視窗可讓您在載入器成功後，將預覽載入器輸出下載為壓縮的 XML 檔案。視屬性內容數目和檔案大小而定，下載快顯視窗可能需要一些時間才會顯示。

執行載入器

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