匯出或匯入組織結構和產品配置

匯入需求：

• 如果是更新或刪除，orgId 必須參照您階層中的現有組織。
  
• 如果您要建立新組織，您可以將 orgId 欄位保留空白或將其設定為您可以構成的唯一 ID，例如 new-1 或 new-2。如此會提供一個可用於參照要建立之組織的 ID。
  
• 國家/地區代碼應該要有效。
• 用於更新和刪除操作的 orgId 應該已存在組織階層中。
• 已標記為刪除的 orgId 不應該選為要進行更新或建立操作的組織的 parentOrgId。
• 相同層級且父級相同的下層組織不應有相同的 orgName。
• 如果要建立組織或更新組織名稱，該組織的名稱不得與相同父系的現有下層名稱相符。
  

匯入需求：

• orgId、email、adminType 和 userType 必須包含有效值。
• countryCode 必須有效。
• 如果使用者已存在且正在更新，則 userType 必須與使用者相符。
  
• 檢查組織中是否有重複的電子郵件地址。

產品設定檔的匯出和匯入是由兩個部分所組成：產品設定檔詳細資料，以及與產品設定檔相關聯的一組資源。這些資源會識別可以設定的服務，通常只是為了啟用或停用這些服務。

• 資源物件會以 JSON 格式巢嵌在產品設定檔中。
• 在搭配產品設定檔使用 CSV 或 XLSX 格式時，設定檔和資源會合併到一個表格中。產品設定檔將會有多個項目，每個資源一個項目。
  
• 資源中的「selected」欄位會控制是否啟用服務。
• 在匯入產品設定檔時，產品設定檔本身以及要更新或建立的任何資源物件上必須有建立或更新操作。

匯入需求：

• productProfileId、licenseId 和 orgId 必須具有有效值。
• 在建立產品設定檔時，productProfileName 必須是有效的名稱，而且不得與相同組織中的其他產品設定檔或使用者群組名稱重複。
  
• quota 欄位必須有單位類型的有效值。當 resourceType=QUOTA 或空白時，這會是數值或「不受限制」。
• notification 欄位必須為 true 或 false。
  
• 如果是 CSV 和 XLSX 匯入，請驗證 productProfileId，其所有項目都必須有相同的 orgId、licenseId 和 productProfileName。
• 驗證輸入檔案和組織中是否有重複的 productProfileName。
• 要更新和刪除的設定檔必須存在於組織中。
• 要更新和刪除 (停用) 的資源必須存在於設定檔中。
• 對於要建立的設定檔，請確定以下事項：
  • orgId 應該是新組織或現有組織。
  • licenseId 應該是新產品還是現有產品。
  • 驗證設定檔的資源。

產品設定檔中的資源：

匯入需求：

當資源所屬的產品設定檔將操作設定為刪除或建立時，則會忽略資源上的 operation 欄位。

• 沒有任何資源應該被標記為刪除，這是一項無效的操作。
• 對於要建立的產品設定檔，資源數量應該要符合來源產品設定檔的資源數量。
• 對於要進行更新操作的資源，該資源必須存在於產品設定檔中。

匯入需求：

• orgId 必須參照現有組織或在相同匯入中建立的組織。
• userGroupId 必須參照現有群組以進行更新或刪除，而且可以是您為新使用者群組定義的 ID。
• 如果是更新或建立操作，則 userGroupNameorganization 不得空白，而且不得與相同組織中的另一個使用者群組或產品設定檔名稱重複。
• 請確定 userGroupName 在輸入檔案和組織中不會重複。
• 要更新或刪除的 userGroups 必須存在於組織中。
• 要從使用者群組中移除的設定檔必須存在於該使用者群組中。無法對使用者群組的設定檔執行更新操作。
• 對於要建立的使用者群組，請確定以下事項：
  • orgId 應該是新組織或現有組織。
  • licenseId (如果適用) 應該是新產品還是現有產品。
  • productProfileId 應該是新產品設定檔還是現有產品設定檔。

網域資訊會提供有關每個組織之可用網域的唯讀資訊。此資料無法編輯。

在 XLSX 檔案中，有兩張工作表：一張用於產品，一張用於資源。在 JSON 中，資源物件會巢嵌在產品物件中。

產品：

匯入需求：

• 如果是建立操作，licenseId 必須是您建立的唯一 ID。 
• 如果是更新操作，licenseId 必須是指定的組織中現有產品的 ID。
• orgId 必須參照現有組織或在相同匯入操作中建立的組織。
• 如果是建立操作，sourceLicenseId 必須參照現有產品，或是您針對相同匯入操作中建立的產品所定義的 ID。
• 對於要進行建立操作的產品而言，licenseId 和 sourceLicenseId 不應該相同。
• 驗證產品組織，該組織應該是新組織或已存在於組織階層中。
• 如果是更新和刪除操作，產品應該已存在組織階層中。
• 標記為刪除的 licenseId 不應該當做要進行建立和更新操作的產品的 sourceLicenseId 使用。
• 對於要進行建立操作的產品，驗證 sourceLicenseId 應該已存在於父級組織中。

產品的資源：

資源物件可出現在產品和產品設定檔中。

匯入需求：

當資源所屬的產品將操作設定為刪除或建立時，則會忽略資源上的 operation 欄位。

• 沒有任何資源應該被標記為刪除，這是一項無效的操作。
• 對於要建立的產品，資源數量應該要符合來源產品的資源數量。
• 對於要進行更新操作的資源，該資源必須存在於產品中。