匯出或匯入組織結構和產品配置
套用至：企業
瞭解全域管理員如何透過Global Admin Console中的匯出和匯入功能簡化組織和產品管理。
存取 Global Admin Console 中的組織索引標籤，以匯出或匯入組織結構。 移至 產品配置 索引標籤以檢視配置資料。 選取其他選項 (⋮)圖示，然後選擇 匯出 或匯入。 前往這裡登入Global Admin Console。
匯出組織結構
作為全域系統管理員，您可以匯出組織階層。 您可以下載整個組織階層或其子集的JSON、CSV或XLSX表示法。 然後，您可以使用此資料進行分析或修改。
所選的匯出格式會影響匯出資料的結構：
- CSV格式 — 一次只允許匯出一種資料。 以CSV格式匯出產品設定檔時，設定檔和資源會合併到一個表格中。 產品設定檔具有多個專案，每個資源各一個。
- XLSX格式 — 導致每個組織詳細資訊顯示在單獨的頁面中。 記錄會透過參考ID連線在不同物件型別之間。 在某些情況下，特定物件可能會有多列（例如，當有一組與指定資源關聯的值時，為Resource物件）。
- JSON格式 — 最具彈性。 它可以利用匯出物件之間的結構關係（例如，組織中的產品會直接出現在組織元素中）。 相同的欄位會以所有三種格式匯出，但有些值在JSON格式中是多餘的。
匯出步驟
-
登入Global Admin Console。 在 組織 標籤中，使用組織選擇器來選取您要匯出的組織階層。 會匯出階層中所有組織的資料。
-
選取其他選項⋮選圖示，然後選擇匯出。
-
在 匯出 對話方塊中，選取要匯出的內容以及匯出資料的格式。
-
選取匯出。 匯出檔案可能需要幾分鐘的時間才能產生。 完成之後，若要下載報表，請導覽至Global Admin Console > 深入分析 > 匯出報表。
下載檔案後，您可以操作資料，然後將其匯回。 匯入的更新會顯示在Global Admin Console中，就像您已手動編輯資料一樣。
匯入組織結構
作為全域系統管理員，您可以匯入可能修改過的資料。 上傳後，新資料會與目前資料進行比較，所有變更都會套用至組織階層。 所有匯入作業都會在組織階層的更新復本上執行。 如果您有任何暫止的變更，匯入的變更會新增到階層中現有暫止變更的頂端。
匯入步驟
- 登入Global Admin Console。 在 組織 標籤中，使用組織選擇器來選取您要執行匯入的組織階層。
- 選取其他選項 ⋮圖示並選取匯入。 根據匯入檔案的大小和複雜性，處理作業可能需要幾秒鐘到幾分鐘的時間。
- 選取選取檔案，然後選擇要上傳的JSON、CSV或XLSX檔案。 對於CSV，一次只能匯入一個組織詳細資料，並且不支援匯入產品。 匯入的變更看起來就像您已手動編輯資料。
- 選取關閉。
- 選取檢閱擱置中的變更。 然後，選取 提交變更 以執行它們。 在執行變更之前，擱置動作的顯示方式，與在Global Admin Console中手動編輯時相同。
匯出和匯入結構描述
使用CSV檔案匯入資料時，欄位可以任何順序出現，但必須始終符合其標頭列。
匯入資料時，您必須為每個元素指定操作。 作業可以是下列任一作業：
- 更新：表示編輯。
- 建立：表示建立新物件（例如，組織、使用者群組或管理員）。
- 刪除：表示刪除物件（例如，組織、使用者群組或管理員）。
會忽略不含或空白作業欄位的輸入記錄。
組織
匯入需求：
- 對於更新或刪除，orgId必須參照階層中的現有組織。
- 如果您要建立新組織，可以將orgId欄位保留空白，或將其設定為您可組成的唯一id （例如new-1或new-2）。 此提供的ID可用來指稱要建立的組織。
- 國家/地區代碼應有效。
- 更新和 刪除 作業的orgId應該已存在於組織階層中。
- 標示為 Delete 的orgId不應選取為具有 Update 或 Create 作業的組織的parentOrgId。
- 位於相同層次和相同父項的子組織不應有相同的orgNames。
- 若要建立組織或更新組織名稱，組織的名稱不得與相同父系的現有子系名稱相符。
管理員
匯入需求：
- orgId、email、adminType和userType必須包含有效值。
- countryCode必須有效。
- 如果使用者已存在且正在更新，則userType必須符合使用者。
- 檢查組織中是否有重複的電子郵件地址。
產品設定檔
產品設定檔的匯出和匯入包含兩個部分：產品設定檔詳細資料以及一組與產品設定檔相關聯的資源。 這些資源會識別可設定的服務，通常只是為了啟用或停用它們。
- 資源物件會以JSON格式巢狀內嵌於產品設定檔中。
- 將CSV或XLSX與產品設定檔搭配使用時，設定檔和資源會合併到一個表格中。 產品設定檔會有多個專案，每個資源各一個。
- 資源中選取的欄位可控制服務是否已啟用。
- 匯入產品設定檔時，產品設定檔本身以及任何要更新或建立的資源物件上都必須有「建立」或「更新」作業。
匯入需求：
-
productProfileId、licenseId和orgId必須具有有效值。
-
建立產品設定檔時，productProfileName必須是有效的名稱，且不得與相同組織中的其他產品設定檔名稱或使用者群組名稱重複。
-
配額欄位必須具有單位型別的有效值。 當resourceType=QUOTA或空白時，這是數值或無限制。
-
通知欄位必須為true或false。
-
針對CSV和XLSX匯入，請驗證productProfileId；其所有專案都必須有相同的orgId、licenseId和productProfileName。
-
驗證輸入檔案和組織中的重複productProfileName。
-
要更新和刪除的設定檔必須存在於組織中。
-
要更新和刪除（已停用）的資源必須存在於設定檔中。
-
對於要建立的設定檔，請確保：
- orgId應為新組織或現有組織。
- licenseId應為新產品或現有產品。
- 驗證設定檔的資源。
產品設定檔中的資源
匯入需求：
- 當資源所屬的產品設定檔具有設定為 Delete 或 Create 的作業時，會忽略資源上的作業欄位。
- 不應將任何資源標示為刪除；這是無效的作業。
- 對於要建立的產品設定檔，資源數量應該與來源產品設定檔的資源數量相符。
- 對於具有 更新 操作的資源，該資源必須存在於產品設定檔中。
使用者群組
匯入需求：
-
orgId必須參照現有的組織，或是在相同匯入中建立的組織。
-
userGroupId必須參考現有的群組以進行更新或刪除，而且可以是您為新使用者群組定義的id。
-
對於更新或建立，userGroupName不得為空白，且不得與相同組織中的其他使用者群組或產品設定檔名稱重複。
-
確定userGroupName在輸入檔案和組織中沒有重複。
-
要更新和刪除的userGroups必須存在於組織中。
-
要從使用者群組移除的設定檔必須存在於使用者群組中。 無法在使用者群組的設定檔上執行更新操作。
-
對於要建立的使用者群組，請確定以下事項：
- orgId應為新組織或現有組織。
- 該licenseId （如果適用）應為新產品或現有產品。
- productProfileId應為新的產品設定檔或現有的產品設定檔。
網域
網域資訊提供每個組織中可用網域的唯讀資訊。 此資料不可編輯。
產品和資源 products-and-resources
在XLSX檔案中，有兩個工作表 — 一個用於產品，另一個用於資源。 在JSON中，資源物件會巢狀內嵌於產品物件中。
產品
匯入需求：
- 對於create，licenseId必須是您建立的唯一id。
- 對於更新，licenseId必須是指定組織中現有產品的識別碼。
- orgId必須參照現有的組織，或是相同匯入作業中正在建立的組織。
- 對於create，sourceLicenseId必須參照現有的產品，或您為相同匯入作業中建立的產品定義的ID。
- licenseId和sourceLicenseId對於具有 Create 作業的產品不應相同。
- 驗證產品的組織；組織應為新的組織，或應已存在於組織階層中。
- 針對 更新 和 刪除 作業，產品應該已存在於組織階層中。
- 標示為 Delete 的licenseId不應做為具有 Create 和 Update 作業的產品的sourceLicenseId。
- 對於具有 Create 作業的產品，請驗證sourceLicenseId是否應該存在於父級組織中。
產品的資源
資源物件可出現在產品和產品設定檔中。
匯入需求：
當資源所屬的產品具有設定為 Delete 或 Create 的作業時，會忽略資源上的作業欄位。
- 不應將任何資源標示為刪除；這是無效的作業。
- 對於要建立的產品，資源數量應與來源產品的資源數量相符。
- 對於具有 更新 作業的資源，該資源必須存在於產品中。
匯入和匯出產品配置資料
作為全域管理員，您可以將產品配置資料匯出為JSON或CSV檔案。 然後，您可以修改此資料並上傳它以匯入變更。 上傳可能修改的資料後，新資料會與目前資料進行比較，所有變更都會套用至產品配置資料。 然後，您可以檢閱並提交待處理的變更，以使變更生效。
匯出產品配置模型
若要匯出產品配置模型，請執行下列動作：
- 登入Global Admin Console並導覽至 產品配置 標籤。
- 選取「更多選項」⋮圖示，然後選取「匯出CSV」或「匯出JSON」。 您的檔案已下載。 進一步瞭解匯出格式。
匯入產品配置模型
您可以匯出資料、修改資料，然後匯入修改的檔案。 若要匯入產品配置模型，請執行下列動作：
- 登入Global Admin Console並導覽至 產品配置 標籤。
- 選取其他選項⋮圖示並選取匯入。
- 選取要上傳的JSON或CSV檔案。
- 選取檢閱擱置中的變更。 檢閱變更後，選取 提交變更 以執行它們。
匯出和匯入產品配置的格式
匯出和匯入格式相同。 以CSV格式匯入時，欄位可以任何順序出現，但必須符合標題列。 以JSON格式匯入時，欄位可依任何順序顯示。
匯入產品配置資料時，必須指定作業。 作業可以是下列其中一項：
- 更新：表示編輯（變更grantedQuantity、allowOverAllocation值）。
- 建立：表示將產品資源新增至指定的組織。
- 刪除：表示刪除產品。
如果未指定任何操作，則以CSV或JSON的物件匯入該列的資料時，不會發生任何變更。
在匯出的檔案中，每個產品資源都有一個資料列或記錄。 有些產品有多個資源。
如果產品有多個資源，則「更新」作業可套用至獨立資源，「刪除」作業會刪除產品（包含組織中的所有資源），而「建立」作業則需要匯入檔案中每個資源的記錄，以便指定每個資源的適當數量。 allowOverAllocation欄位是產品範圍，因此此欄位更新所在的資源並不重要。
標題的說明
匯入需求
資料驗證
-
作業欄位必須具有有效的作業。
-
產品匯入資料必須具有必要欄位的屬性和值。
-
產品匯入資料屬性的型別必須正確。
-
不得為不同資源提供產品原則欄位(overAllocation)。
-
grantedQuantity欄位：
- 無法變更為unlimited （如果尚未變更為unlimited）。
- 必須是非負數整數或字串值無限制。
許可權/可存取的驗證
- 與匯入資料關聯的組織必須存在。 如果您要更新，請確定與匯入資料相關聯的產品和資源確實存在。
新增產品驗證
- SourceLicenseId必須存在。
- 與新產品相關聯的組織必須存在。
- 正在建立的產品不得存在（具有相同licenseId的產品）。
- 與正在建立之產品相關聯的資源必須具有符合該產品的productId。