导出或导入组织结构和产品分配
应用于：企业
了解全局管理员如何通过Global Admin Console中的导出和导入功能简化组织和产品管理。
访问 Global Admin Console 中的组织选项卡以导出或导入组织结构。 转到 产品分配 选项卡以查看分配数据。 选择更多选项 (⋮)图标，然后选择 导出 或导入。 转到此处登录到Global Admin Console。
导出组织结构
作为全局管理员，您可以导出组织层次结构。 您可以下载整个组织层次结构或其子集的JSON、CSV或XLSX表示形式。 然后，您可以使用此数据进行分析或修改。
选择的导出格式会影响导出数据的结构：
- CSV格式 — 允许一次仅导出一种数据。 以CSV格式导出产品用户档案时，用户档案和资源将合并到一个表中。 产品配置文件有多个条目，每个资源一个。
- XLSX格式 — 导致每个组织详细信息显示在单独的工作表中。 记录通过引用ID连接在不同对象类型之间。 在某些情况下，特定对象（例如，当存在与给定资源关联的一组值时，资源对象）可能有多行。
- 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。
- 对于具有 更新 或 创建 操作的组织，不应选择标记为 删除 的orgId作为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应为新产品或现有产品。
- 验证用户档案的资源。
产品配置文件中的资源
导入要求：
- 当资源所属的产品配置文件的操作设置为 删除 或 创建 时，将忽略资源的操作字段。
- 不应将任何资源标记为删除；这是一个无效的操作。
- 对于要创建的产品配置文件，资源数应与源产品配置文件的资源数匹配。
- 对于具有 更新 操作的资源，该资源必须存在于产品配置文件中。
用户组
导入要求：
-
orgId必须引用现有组织或在同一导入中创建的组织。
-
userGroupId必须引用要更新或删除的现有组，并且可以是您为新用户组定义的ID。
-
对于更新或创建，userGroupName不能为空，并且不得与同一组织中的其他用户组或产品配置文件名称重复。
-
确保userGroupName在输入文件和组织中不重复。
-
要更新和删除的用户组必须存在于组织中。
-
要从用户组中删除的配置文件必须存在于用户组中。 无法对用户组的配置文件执行更新操作。
-
对于要创建的用户组，请确保以下各项：
- orgId应为新组织或现有组织。
- 该licenseId （如果适用）应当为新产品或现有产品。
- productProfileId应该是新产品配置文件或现有产品配置文件。
域
域信息提供有关每个组织中可用域的只读信息。 此数据不可编辑。
产品和资源 products-and-resources
在XLSX文件中，有两个工作表，一个用于产品，另一个用于资源。 在JSON中，资源对象嵌套在产品对象中。
产品
导入要求：
- 对于create，licenseId必须是您创建的唯一id。
- 对于更新，licenseId必须是指定组织中现有产品的ID。
- orgId必须引用现有组织或在同一导入操作中创建的组织。
- 对于create，sourceLicenseId必须引用现有产品，或您为在同一导入操作中创建的产品定义的ID。
- 对于具有 创建 操作的产品，licenseId和sourceLicenseId不应相同。
- 验证产品的组织；组织应为新组织或组织层次结构中已存在组织。
- 对于 更新 和 删除 操作，组织层次结构中应该已存在产品。
- 标记为 Delete 的licenseId不应用作具有 创建 和 更新 操作的产品的sourceLicenseId。
- 对于具有 Create 操作的产品，请验证sourceLicenseId应存在于父组织中。
产品的资源
资源对象可以显示在产品和产品配置文件中。
导入要求：
当资源所属的产品具有设置为 删除 或 创建 的操作时，资源上的操作字段将被忽略。
- 不应将任何资源标记为删除；这是一个无效的操作。
- 对于要创建的产品，资源的数量应该与源产品的资源数量匹配。
- 对于具有 更新 操作的资源，该资源必须存在于产品中。
导入和导出产品分配数据
作为全局管理员，您可以将产品分配数据导出为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。