使用範本

最佳作法

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

注意事項

• 您必須是服務管理員或具備移轉 - 管理應用程式角色 (請參閱瞭解應用程式角色和權限)，才能將應用程式與維度匯入和匯出至範本。
• 將應用程式傳輸至目標環境時：
  • 如果來源環境中的應用程式擁有者也存在於目標環境中，則他們會保留為目標環境中的應用程式擁有者。
  • 如果來源環境中的應用程式擁有者不存在於目標環境中，則服務管理員必須為目標環境中的應用程式指派擁有者。
• 您可以將新的應用程式或維度從來源環境轉移至目標環境，也可以轉移目標環境中已經存在的應用程式或維度。範本匯入過程會建立尚未存在的物件並修改目標應用程式或維度的現有物件，以更新目標環境中的現有應用程式或維度。請參閱使用範本更新現有的應用程式或維度。
• 您只能轉移作用中的應用程式。
• 如果來源環境中的封存物件尚不存在於目標環境中，則可以從範本匯入中排除封存的資料鏈物件。

  Note:

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

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

• 您可以在單一範本檔案中傳輸多個應用程式。如果要在維度層級進行傳輸，則無法在單一範本檔案中傳輸多個維度。
• 轉移維度時，包含維度的應用程式必須存在於目標環境中。
• 若要在環境之間轉移應用程式或維度，兩個環境的發行版本必須相同。
• 匯入範本時，如果來源環境和目標環境中都存在使用者或群組，則會匯入關聯物件的以下使用者和群組參照：
  • 權限
  • 原則使用者與群組
  • 訂閱指派人。
  • 使用者和群組的檢視篩選

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

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

  Caution:

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