使用範本

最佳作法

如果您正在測試環境中建立一個應用程式，然後打算把它轉移到現有生產環境，最佳做法是先使用生產環境的目前快照來重新整理測試環境，然後建立要轉移的應用程式。這樣能確保全域物件 (例如特性和檢視) 在兩種環境中具有相同的 ID。

注意事項

• 您必須是服務管理員或具備移轉 - 管理精細角色 (請參閱瞭解精確角色和權限)，才能將應用程式與維度匯入和匯出至範本。
• 應用程式匯出包含完整的應用程式或維度，以及所有相依的物件 (例如全域連線)。精細匯出僅包含選取的中繼資料物件，且不會自動包含所有相依性。使用精細匯出時，請確保目標環境中存在必要的相依物件，或已將其包含在範本中，以避免發生匯入錯誤。
• 將應用程式傳輸至目標環境時：
  • 如果來源環境中的應用程式擁有者也存在於目標環境中，則他們會保留為目標環境中的應用程式擁有者。
  • 如果來源環境中的應用程式擁有者不存在於目標環境中，則服務管理員必須為目標環境中的應用程式指派擁有者。
• 您可以傳輸新的或現有應用程式、維度或支援的中繼資料物件。範本匯入程序會透過建立不存在的新物件及修改現有物件，以更新目標環境中的現有應用程式、維度或中繼資料物件。請參閱使用範本更新現有物件。
• 您只能轉移作用中的應用程式。
• 如果來源環境中的封存物件尚不存在於目標環境中，則可以從範本匯入中排除封存的資料鏈物件。

  Note:

  如果相依於封存物件的物件不存在於目標環境中，則這些物件也會從範本匯入中排除。如果相依物件將被部分排除，則該物件將顯示在範本預覽或匯入中，並顯示一則警告訊息，指出無法匯入該物件。

  例如，如果您在匯入過程中排除了封存的維度，並且該維度尚不存在於目標環境中，則如果目標環境中還沒有維度繫結、節點類型、原則和擷取等物件，那麼這些物件也會從範本匯入中排除。

• 您可以在單一範本檔案中同時傳輸應用程式和維度。例如，您可以從 Planning 應用程式選取一個總帳應用程式和兩個維度。但請注意，選取應用程式將會自動包含該應用程式中的所有維度。您無法選取應用程式，然後只選取該應用程式內的維度子集。因此，如果總帳應用程式有三個維度，您可以自行選取兩個維度，但如果您選取整個應用程式，則會自動包含這三個維度。

  Tip:

  如果您在多個應用程式間有節點類型轉換器或訂閱，在單一範本檔案中傳輸這些應用程式和維度會很有幫助。例如，如果您在總帳應用程式的「科目」視點與 Planning 應用程式的「科目」視點之間有訂閱，則可以傳輸總帳應用程式以及 Planning 應用程式的「科目」維度，在單一範本檔案中包含訂閱視點。
• 轉移維度時，包含維度的應用程式必須存在於目標環境中。
• 若要在環境之間轉移應用程式或維度，兩個環境的發行版本必須相同。
• 匯入範本時，如果來源環境和目標環境中都存在使用者或群組，則會匯入關聯物件的以下使用者和群組參照：
  • 權限
  • 原則使用者與群組
  • 訂閱指派人。
  • 使用者和群組的檢視篩選

  如果來源環境中的使用者或群組在目標中不存在，則不會轉移關聯使用者或群組參照。會顯示一則訊息，指示目標環境中缺少的使用者和群組以及未匯入的關聯物件。

• 來源應用程式和目標應用程式或維度都必須存在於目標環境中，才能匯入節點類型轉換器和訂閱。在相同的範本檔案中傳輸來源和目標應用程式，或者首先確保匯入轉換器和訂閱的來源應用程式或維度，以便在匯入目標應用程式或維度時建立轉換器和訂閱。
• 如果您傳輸的維度具有會使用節點資料類型來參照其他維度的特性，則這些來源維度必須已經存在目標系統中。如果並非這種維度，請先傳輸這些來源維度，或使用應用程式範本以同一個範本檔案傳輸所有維度。
• 匯入以下全域物件時，如果該物件已存在於目標環境中，其名稱相同但 ID 不同，則會在目標環境中重新命名來源物件，讓名稱不再重複：
  • 特性
  • 檢視
  • 查詢集
  • 全域連線
• 將應用程式或維度匯出至範本後，您可以在 .json 檢視器中複查範本檔案的內容。

  Caution:

  不支援手動編輯範本檔案。