跳至主要內容
文件
文件
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 維度載入器要求受限於更新階層維度中最多 10000 個維度值，或更新單層維度中最多 40000 個維度值。這些限制不適用於在載入器要求中新建維度值。
Planning 維度載入器可讓您將維度值的相關中繼資料從階段處理區域對應至
Adaptive Planning
。Planning 維度載入器的主要優點是允許您大量匯入維度值，而不需在「建模」>「模型管理」>「維度」中一次建立一個維度值。建立載入器後，您可以手動執行，或將其排定為整合 任務的一部分執行。

若要建立 Planning 維度載入器，請依照以下流程操作︰
  1. 輸入資料來源設定
  2. 配置欄對應
  3. 建立業務規則
  4. 預覽載入器輸出
  5. 執行或排程載入器

開始之前

Planning 維度載入器需要使用從現有 資料來源匯入的階段處理資料。

輸入資料來源設定

「資料來源設定」可讓您從階段處理資料中選擇要使用的來源表格，選取要載入至的 Planning 維度，以及是否應自動新建維度值。
  1. 導覽至
    整合 > 設計工具整合
    。
  2. 在元件庫的「載入器」區域中按一下
    新建載入器
    。
  3. 選取
    Planning 維度載入器
    做為載入器類型。輸入載入器的名稱。
  4. 按一下
    建立
    。
最佳做法︰在「動作」面板中按一下
儲存
，以在建立和編輯載入器時經常儲存。按一下
關閉
，再按一下
否
，即可捨棄任何未儲存的變更。
輸入 Planning 維度載入器一般屬性資訊︰
  • 來源表格︰
    從下拉清單中選取來源表格。清單中的來源表格是您有權存取的階段處理區域中所有可用的表格。
  • Planning 維度︰
    從所有維度中選取一個維度，讓來源載入其中。列出的維度來自「建模」>「模型管理」>「維度」。
  • 建立維度值 (如果在 Planning 中找不到)
    ︰選取此方塊可自動建立在來源系統中找到，但在「建模」>「模型管理」>「維度」中找不到的新維度值。如果未勾選此選項，則只會執行現有維度值更新，而不會新建維度。
    • 如果您載入的維度未在「建模」>「模型管理」>「維度」中啟用「資料匯入自動建立維度值」，則載入器會警告您。
  • 記錄層級︰
    選擇在執行載入器時記錄的詳細資料類型。
    • 「錯誤」
      ：
      僅記錄嚴重錯誤。
    • 「資訊」
      ：
      記錄基本資訊，例如載入器的更新時間。
    • 「詳細資訊」
      ：
      提供所有階段和動作的詳細資訊。此層級主要用於偵錯或稽核，因為其產生的記錄資訊量可能遠超過一般用途實際所需。

配置欄對應

欄對應可讓您將資料來源中的欄對應至「建模」>「模型管理」>「維度」中可用維度值。
如果有多個欄要對應，您可使用
顯示
篩選條件來選取︰
  • 全部︰顯示所有 Planning 欄
  • 必填︰顯示所有必填的 Planning 欄
  • 未對應︰顯示所有未對應的 Planning 欄
  • 已對應︰顯示所有已對應的 Planning 欄
您可以使用
搜尋
欄位來尋找欄。輸入要搜尋的完整或部分名稱，然後按一下放大鏡。任何符合搜尋條件的階段處理欄都會出現在結果中。
對應欄
  1. 按一下
    欄對應
    。
    「欄對應」分頁包含︰
    • 狀態︰
      指出是否已對應 Planning 欄。勾號 已對應的欄 表示已對應的欄。驚嘆號 未對應的欄 表示未對應的欄。
    • Planning 欄︰
      顯示工作表上可供對應的所有 Planning 欄。Planning 欄清單包含一組必填 Planning 欄，其後是其他所有 Planning 欄。必填 Planning 欄以加上星號的粗體字表示，且包含一個「值」欄。非必填欄包含「簡稱」和「說明」。
    • 來源欄︰
      顯示階段處理表內選自「資料來源設定」的欄。
  2. 選取未對應的欄，然後按一下下拉清單。您可以對應的欄清單會顯示在下拉清單中。當您對應欄時，狀態指標會從紅色 IntegrationMappingUnmapped.png 變更為綠色 IntegrationMappingMapped.png。
When
Data import automatically creates dimension values
 is enabled, you can map attributes by code. The attribute name automatically becomes the code.
請參閱 「範例︰從試算表資料來源載入維度值」， 以取得維度值及其父系如何對應至 Planning 的範例。
載入時變更 Planning 維度值名稱
若要在載入時變更 Planning 維度值的名稱︰
  1. 選取在來源中唯一識別維度值的來源欄。
  2. 將 ID 欄對應至維度值 ID。
  3. 將名稱對應至維度值名稱。
取消對應欄
若要取消對應欄，請按一下
取消對應
並選擇︰
  • 「全部取消對應」
    ：
    取消對應所有的欄
  • 取消對應選取的項目
    ︰
     僅取消對應選取的欄。
取消對應欄會將其對應狀態圖示變更為紅色 IntegrationMappingUnmapped.png。
對應與清單維度相關聯的屬性內容
您可以對應來自資料來源匯入的欄，將屬性內容與清單維度相關聯。
只有清單維度可以將屬性內容與維度相關聯。您無法將屬性內容與階層維度相關聯。
範圍內
Adaptive Planning
 您可以造訪
模型管理
 >
維度
 ，然後按一下維度以檢視其詳細資料，以確認其是否為清單維度。
在「資料來源設定」中，選取清單維度做為
Planning 維度
。
由於維度是清單維度，因此屬性內容會變成「欄對應」內可用的欄。
由於清單維度不是階層式，因此 parentId 不是來源欄的選項。

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 篩選條件︰
  1. 在
    業務規則
    分頁中，選取
    SQL 篩選條件
    。按一下
    編輯
    。
  2. 輸入 SQL 運算式。您可以按一下「可用欄」清單中的項目，自動將該項目帶入 SQL 運算式，而不必手動輸入。
  3. 按一下
    套用
    以檢查您的 SQL 語法。如果您的語法錯誤，則運算式周圍的框線會變成紅色。將滑鼠移至 SQL 編輯器上方，即可查看語法錯誤資訊。
    如需詳細的 SQL 語法說明，您可以在「編輯 SQL 篩選條件」的「附註」區段中按一下
    線上說明
    。您也可以造訪 SQL 運算式參考。
  4. 更正語法中的任何錯誤，然後按一下
    套用
    。執行載入器時，只會匯入符合 SQL 運算式的階段處理列。

預覽載入器輸出

您可以在執行完整載入之前預覽載入器輸出，以檢查對應是否為您需要的方式。您也可將其輸出下載為 XML 檔案，以便在載入資料來源之前，針對您的需求手動驗證維度值。
  1. 在「動作」面板中按一下
    預覽載入器輸出
    。
  2. (選用) 輸入預覽載入器輸出設定。可輸入的資訊會因您為此 Planning 維度載入器選擇的資料來源而有所不同。在此變更設定會將新資料匯入至階段處理表和欄。
  3. 按一下
    預覽載入器輸出
    。
載入器會開始執行，並在執行過程中套用所有轉換和業務規則。狀態快顯視窗會顯示載入器執行的步驟。如果有要載入的維度值，載入器會建立 XML 檔案並傳送電子郵件通知，內含採用壓縮 XML 附件形式的載入器輸出。
額外的快顯視窗可讓您在載入器成功後，將預覽載入器輸出下載為壓縮的 XML 檔案。視維度值數目和檔案大小而定，下載快顯視窗可能需要一些時間才會顯示。
修正驗證錯誤
載入維度值時，系統會驗證來源資料是否發生下列錯誤︰
  • 資料中缺少維度值的來源 ID 值 (空白)。
  • 資料中有重複的來源 ID。來源 ID 不可重複。
  • 資料中缺少維度值名稱 (空白)。
  • 資料中有重複的維度值名稱。
  • ParentId 與資料中的來源 ID 相同。在這種情況下，此欄會將本身參照為其父系。
  • 匯入子樹狀目錄時，子樹狀目錄的根會對應至 Planning 中的現有節點。在這種情況下，parentID 不在要引入 Planning 的新節點的來源資料中。
  • 現有節點已移至新節點之下，且「新建」標幟已停用。在這種情況下，如果已明確告知載入器不要新建維度值，則現有的維度值會移入新節點中。
  • 資料的階層中有循環參照。在這種情況下，ParentId 會將本身的子系參照為其父系。

執行載入器

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

載入對來源維度值的變更

如果已建立對來源維度值的對應，Planning 維度載入器即可在載入時重新命名維度值。
此表格說明載入器已建立的對應。來源維度值「USA」對應至來源 ID 欄「1001」。
Planning 維度值
來源 ID 欄
來源維度值
USA
1001
USA
加拿大
1002
Canada
在來源系統中，如果「USA」變更為「United States」，則 Planning 維度載入器可在載入時套用此變更，因為載入器會維護來源 ID 欄「1001」與維度值「USA」在 Planning 中的內部 ID 對應。
Planning 維度值
來源 ID 欄
來源維度值
USA
1001
United States
加拿大
1002
Canada
執行載入器後，Planning 中的維度值會從「USA」變更為「United States」。