跳至主要內容
文件
文件
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
.使用科目載入器從外部系統大量匯入科目並進行同步，而不是在科目管理中一次建立一個科目。建立載入器後，您可以手動執行，或將載入器排定為執行任務的一部分。
Integration
 任務
觀看影片
︰1 分 36 秒

基本步驟

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

Prerequisites

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

導覽

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

輸入資料來源設定

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

配置欄對應

「欄對應」可讓您將資料來源中的欄，對應至
建模
 >
模型管理
 >
科目
中可用的科目屬性。您可以取消對應欄，忽略不想載入的階段處理資料，也可以在載入器執行後，以一次一欄的方式取消對應，找出哪幾欄會在記錄中產生錯誤。
如果有多個欄要對應，請使用
顯示
篩選條件來選取︰
  • 全部︰顯示所有 Planning 欄
  • 必填︰顯示所有必填的 Planning 欄，例如父系 ID 和科目
  • 未對應︰顯示所有未對應的 Planning 欄
  • 已對應︰顯示所有已對應的 Planning 欄
使用
種類
來選取︰
  • 「科目詳細資料」
    ：
    顯示與科目詳細資料相關的欄：
    • 科目代碼
    • 簡稱
    • 彙總至
    • 說明
    • 類型
    • 加權依據
    • 顯示文字
    • 規劃依據
    • 實際值依據
    • 實際值套疊
    • 餘額類型
    • 在工作流程中
      「在工作流程中」必須是布林值 1 (代表 True) 或 0 (代表 False)。
  • 全部︰顯示所有欄。
    您只能在「所有」種類中檢視「資料輸入類型」︰
    • 「資料輸入類型」的有效值為「標準」、「CUBE」或「空白」。
    • 如為空白，則「資料輸入類型」會繼承父系科目的類型。
    • 如果父系「資料輸入類型」為 CUBE，則新科目會預設為 CUBE。
      否則，新科目會預設為「標準」。
    • 系統會忽略非分葉科目的「資料輸入類型」變更，
      並自動計算所有非分葉科目的新「資料輸入類型」。
  • 資料類型︰顯示與科目資料類型設定相關的欄，包括「科目時間級別」、「顯示為」、「預設公式」、「加權平均換算」、「重設餘額」、「重設時轉移餘額」、「小數位數」和「匯率」。
  • 工作表︰顯示與工作表以何種方式顯示科目有關的欄，包括「在工作表上隱藏」和「開始時展開」。
  • 科目屬性內容︰顯示與科目屬性內容相關的欄，包括列出所有與科目相關聯的科目屬性內容。
  • 資料隱私保護︰顯示與科目資料公開或隱私程度相關的欄，包括「包含薪資明細」。
  • 合併︰顯示與合併設定相關的欄，包括公司間、銷除交易夥伴和子公司設定。
    僅適用於已啟用「合併」的實例。
您可以使用
搜尋
欄位來尋找欄。輸入要搜尋的完整或部分名稱，然後按一下放大鏡。任何符合搜尋條件的階段處理欄都會出現在結果中。
對應欄
  1. 按一下
    欄對應
    。
  2. 從下拉清單中選取未對應的欄。可用於對應的欄會顯示在清單中。對應欄時，狀態指標會從驚嘆號 IntegrationMappingUnmapped.png 變更為勾號 IntegrationMappingMapped.png。
欄對應
分頁包含以下各欄︰
  • 狀態︰
    勾號 已對應的欄 表示已對應的欄。驚嘆號 未對應的欄 表示未對應的欄。
  • Planning 欄︰
    顯示所有可供對應的 Planning 欄。Planning 欄清單包含一組必填 Planning 欄，其後是其他所有 Planning 欄。必填 Planning 欄以加上星號的粗體字表示，且包含一個「值」欄。非必填欄包含「簡稱」和「說明」。
  • 來源 ID 欄︰
    顯示階段處理表內選自「資料來源設定」的欄。
  • 來源科目代碼欄︰
    指出科目代碼欄，以簡化對應流程。中的每個科目
    Adaptive 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 也必須為空白。
取消對應欄
若要取消對應欄，請按一下
取消對應
並選擇︰
  • 全部取消對應︰取消對應所有的欄
  • 取消對應選定項目︰僅取消對應選定的欄
取消對應欄會將狀態圖示變更為驚嘆號 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 附件形式的輸出。如果未載入任何科目，則壓縮檔將包含一則訊息，指出未載入任何內容。
額外的快顯視窗可讓您在載入器成功後，將預覽載入器輸出下載為壓縮的 XML 檔案。視科目數目和檔案大小而定，下載快顯視窗可能需要一些時間才會顯示。
這是已下載的解壓縮輸出 XML 檔案的範例︰
預覽載入器輸出 - 中繼資料的 XML

執行載入器

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