Exportar o importar la estructura de la organización y las asignaciones de productos
Se aplica a: Empresa
Descubra cómo los administradores globales pueden optimizar la administración de organizaciones y productos con las funciones de exportación e importación de Global Admin Console.
Acceda a la ficha Organizaciones en Global Admin Console para exportar o importar la estructura de la organización. Vaya a la pestaña Asignación de productos para ver los datos de asignación. Seleccione el icono Más opciones (⋮) y, a continuación, elija Exportar o Importar. Vaya aquí para iniciar sesión en Global Admin Console.
Exportar la estructura de la organización
Como administrador global, puede exportar la jerarquía de la organización. Puede descargar una representación JSON, CSV o XLSX de toda la jerarquía de la organización o un subconjunto de ella. A continuación, puede utilizar estos datos para su análisis o modificación.
El formato de exportación elegido afecta a la estructura de los datos exportados:
- Formato CSV: permite exportar sólo un tipo de datos a la vez. Al exportar perfiles de producto en formato CSV, los perfiles y recursos se combinan en una tabla. Hay varias entradas para el perfil del producto, una para cada recurso.
- Formato XLSX: los resultados de cada detalle de organización se muestran en una hoja independiente. Los registros están conectados entre los distintos tipos de objeto mediante un ID de referencia. En algunos casos, puede haber varias filas para un objeto en particular (por ejemplo, objetos Resource cuando hay un conjunto de valores asociados a un recurso determinado).
- Formato JSON: el más flexible. Puede aprovechar las relaciones estructurales entre los objetos exportados (por ejemplo, los productos de una organización aparecen directamente en el elemento de la organización). Los mismos campos se exportan en los tres formatos, pero algunos valores son redundantes en el formato JSON.
Pasos a exportar
-
Inicie sesión en Global Admin Console. En la ficha Organizaciones, use el selector de organizaciones para seleccionar la jerarquía de organizaciones a la que desea exportar. Se exportan los datos de todas las organizaciones de la jerarquía.
-
Seleccione el icono de ⋮ Más opciones y elija Exportar.
-
En el cuadro de diálogo Exportar, seleccione lo que desea exportar y un formato en el que exportar los datos.
-
Seleccione Exportar. El archivo de exportación puede tardar varios minutos en generarse. Una vez finalizado, para descargar el informe, vaya a Global Admin Console > Información > Exportar informes.
Después de descargar el archivo, puede manipular los datos y, a continuación, importarlos de nuevo. Las actualizaciones importadas aparecen en Global Admin Console como si los datos se hubieran editado manualmente.
Importar la estructura de la organización
Como administrador global, puede importar datos potencialmente modificados. Cuando se cargan, los nuevos datos se comparan con los datos actuales y los cambios se aplican a la jerarquía de la organización. Todas las operaciones de importación se realizan en la copia actualizada de la jerarquía de la organización. Si tiene cambios pendientes, los cambios importados se agregan sobre los cambios pendientes existentes en la jerarquía.
Pasos para la importación
- Inicie sesión en Global Admin Console. En la ficha Organizaciones, use el selector de organizaciones para seleccionar la jerarquía de organizaciones donde desea realizar la importación.
- Seleccione el icono Más opciones ⋮ y seleccione Importar. Según el tamaño y la complejidad del archivo de importación, el procesamiento puede tardar entre unos segundos y varios minutos.
- Seleccione Seleccionar un archivo y elija un archivo JSON, CSV o XLSX para cargar. Para el CSV, solo se puede importar un detalle de organización a la vez y no admite la importación de productos. Los cambios importados aparecen como si los datos se hubieran editado manualmente.
- Seleccione Cerrar.
- Seleccione Revisar cambios pendientes. A continuación, seleccione Enviar cambios para ejecutarlos. Antes de ejecutar los cambios, las acciones pendientes se muestran del mismo modo que cuando las ediciones se realizan manualmente en Global Admin Console.
Exportación e importación de esquemas
Al importar datos mediante un archivo CSV, los campos pueden aparecer en cualquier orden, pero siempre deben coincidir con su fila de encabezado.
Al importar datos, debe especificar una operación para cada elemento. La operación puede ser cualquiera de las siguientes:
- Update: indica una edición.
- Crear: indica la creación de un nuevo objeto (por ejemplo, organización, grupo de usuarios o administrador).
- Eliminar: indica la eliminación de un objeto (por ejemplo, organización, grupo de usuarios o administrador).
Los registros de entrada sin campo de operación o en blanco se omiten.
Organizaciones
Requisitos de importación:
- Para actualizar o eliminar, orgId debe hacer referencia a una organización existente en su jerarquía.
- Si está creando una nueva organización, puede dejar en blanco el campo orgId o establecerlo en un ID único que pueda configurar (como new-1 o new-2). Esto proporciona un ID que se puede utilizar para hacer referencia a la organización que se va a crear.
- El código de país debe ser válido.
- orgId para la operación Update y Delete ya debería estar presente en la jerarquía de la organización.
- orgId marcado como Delete no debería seleccionarse como parentOrgId para organizaciones con actualización o creación de la operación.
- Las organizaciones secundarias del mismo nivel y del mismo padre no deben tener los mismos orgNames.
- Para crear una organización o actualizar un nombre de organización, el nombre de la organización no debe coincidir con el nombre de un hijo existente del mismo padre.
Administradores
Requisitos de importación:
- orgId, email, adminType y userType deben contener valores válidos.
- countryCode debe ser válido.
- Si el usuario ya existe y se está actualizando, userType debe coincidir con el usuario.
- Compruebe si hay direcciones de correo electrónico duplicadas en la organización.
Perfiles de producto
Las exportaciones e importaciones de perfiles de producto constan de dos partes: los detalles del perfil de producto y un conjunto de recursos asociados al perfil de producto. Estos recursos identifican los servicios que se pueden configurar, normalmente solo para habilitarlos o deshabilitarlos.
- Los objetos de recurso están anidados dentro del perfil de producto en formato JSON.
- Cuando se utiliza CSV o XLSX con perfiles de producto, los perfiles y recursos se combinan en una tabla. Habrá varias entradas para el perfil del producto, una para cada recurso.
- El campo seleccionado en el recurso controla si el servicio está habilitado.
- Al importar perfiles de producto, debe haber una operación Crear o Actualizar en el propio perfil de producto y en cualquier objeto de recurso que se vaya a actualizar o crear.
Requisitos de importación:
-
productProfileId, licenseId y orgId deben tener valores válidos.
-
Al crear un perfil de producto, productProfileName debe ser un nombre válido y no debe duplicar otro nombre de perfil de producto o nombre de grupo de usuarios en la misma organización.
-
El campo de cuota debe tener un valor válido para el tipo de unidad. Es numérico o ilimitado cuando resourceType=QUOTA o en blanco en caso contrario.
-
El campo de notificación debe ser true o false.
-
Para las importaciones CSV y XLSX, valide productProfileId; todas sus entradas deben tener los mismos orgId, licenseId y productProfileName.
-
Valide el productProfileName duplicado en el archivo de entrada y en la organización.
-
Los perfiles que se van a actualizar y eliminar deben estar presentes en la organización.
-
Los recursos que se van a actualizar y eliminar (desactivar) deben estar presentes en el perfil.
-
Para que se creen los perfiles, asegúrese de lo siguiente:
- El orgId debe ser una organización nueva o una existente.
- El ID de licencia debe ser un producto nuevo o existente.
- Valide los recursos del perfil.
Recursos en perfiles de producto
Requisitos de importación:
- El campo de operación de los recursos se omite cuando el perfil de producto al que pertenecen tiene las operaciones establecidas como Delete o Create.
- No se debe marcar ningún recurso para eliminar; la operación no es válida.
- Para que se creen los perfiles de producto, el número de recursos debe coincidir con el número de recursos del perfil de producto de origen.
- Para los recursos con la operación Update, el recurso debe estar presente en el perfil del producto.
Grupos de usuarios
Requisitos de importación:
-
orgId debe hacer referencia a una organización existente o a una organización que se está creando en la misma importación.
-
userGroupId debe hacer referencia a un grupo existente para actualizarlo o eliminarlo, y puede ser un id que defina para nuevos grupos de usuarios.
-
Para la actualización o creación, userGroupName no debe estar en blanco y no debe duplicar otro nombre de grupo de usuarios o perfil de producto en la misma organización.
-
Asegúrese de que userGroupName no esté duplicado en el archivo de entrada y en la organización.
-
userGroups que se va a actualizar y eliminar debe estar presente en la organización.
-
El perfil que se va a eliminar del grupo de usuarios debe estar presente en el grupo de usuarios. No se pueden realizar operaciones de actualización en el perfil de un grupo de usuarios.
-
Para que se creen grupos de usuarios, asegúrese de lo siguiente:
- El orgId debe ser una organización nueva o una existente.
- El ID de licencia, si corresponde, debe ser un producto nuevo o uno existente.
- productProfileId debe ser un perfil de producto nuevo o uno existente.
Dominios
La información de dominio proporciona información de solo lectura sobre los dominios disponibles en cada organización. Estos datos no pueden editarse.
Productos y recursos products-and-resources
En los archivos XLSX, hay dos hojas: una para los productos y otra para los recursos. En JSON, los objetos de recursos están anidados en el objeto de producto.
Productos
Requisitos de importación:
- Para crear, el ID de licencia debe ser un ID único que usted cree.
- Para la actualización, el ID de licencia debe ser el ID de un producto existente en la organización especificada.
- orgId debe hacer referencia a una organización existente o a una que se esté creando en la misma operación de importación.
- Para crear, sourceLicenseId debe hacer referencia a un producto existente o al ID definido para un producto que se está creando en la misma operación de importación.
- licenseId y sourceLicenseId no deben ser iguales para los productos con la operación Create.
- Validar organizaciones de productos; la organización debe ser una nueva o ya debe estar presente en la jerarquía de la organización.
- Para la operación Actualizar y Eliminar, el producto ya debe estar presente en la jerarquía de la organización.
- El ID de licencia marcado como Delete no debe usarse como sourceLicenseId de productos con las operaciones Create y Update.
- Para los productos con la operación Create, valide que sourceLicenseId debe estar presente en la organización principal.
Recursos para productos
Los objetos de recursos pueden aparecer en los productos y en los perfiles de producto.
Requisitos de importación:
El campo de operación de los recursos se omite cuando el producto al que pertenecen tiene las operaciones establecidas como Delete o Create.
- No se debe marcar ningún recurso para eliminar; la operación no es válida.
- Para que se creen los productos, el número de recursos debe coincidir con el número de recursos del producto de origen.
- Para los recursos con la operación Update, el recurso debe estar presente en el producto.
Importar y exportar datos de asignación de productos
Como Administrador global, puede exportar los datos de asignación de productos como un archivo JSON o CSV. A continuación, puede modificar estos datos y cargarlos para importar los cambios. Cuando se cargan los datos potencialmente modificados, los nuevos datos se comparan con los datos actuales y cualquier cambio se aplica a los datos de asignación del producto. A continuación, puede revisar y enviar los cambios pendientes para que surtan efecto.
Exportar el modelo de asignación de productos
Para exportar el modelo de asignación de productos, haga lo siguiente:
- Inicie sesión en Global Admin Console y vaya a la pestaña Asignación de productos.
- Seleccione el icono de ⋮ Más opciones y luego seleccione Exportar CSV o Exportar JSON. Se ha descargado el archivo. Más información sobre los formatos de exportación.
Importar el modelo de asignación de productos
Puede exportar datos, modificarlos y, a continuación, importar el archivo modificado. Para importar el modelo de asignación de productos, haga lo siguiente:
- Inicie sesión en Global Admin Console y vaya a la pestaña Asignación de productos.
- Seleccione el icono de ⋮ Más opciones y seleccione Importar.
- Seleccione un archivo JSON o CSV para cargar.
- Seleccione Revisar cambios pendientes. Después de revisar los cambios, selecciona Enviar cambios para ejecutarlos.
Exportar e importar formatos para la asignación de productos
Los formatos de exportación e importación son los mismos. Al importar en formato CSV, los campos pueden aparecer en cualquier orden, pero deben coincidir con la fila de encabezado. Al importar en formato JSON, los campos pueden aparecer en cualquier orden.
Debe especificar la operación al importar los datos de asignación del producto. La operación puede ser una de las siguientes:
- Update: indica una edición (cambio a grantedQuantity, allowOverAllocation values).
- Crear: indica que se debe agregar un recurso de producto a la organización especificada.
- Eliminar: indica la eliminación del producto.
Si no se proporciona ninguna operación, no se producirán cambios cuando se importen datos para esa fila en CSV o un objeto en JSON.
En el archivo exportado, hay una fila o registro para cada recurso de producto. Algunos productos tienen más de un recurso.
Si un producto tiene más de un recurso, las operaciones de actualización se pueden aplicar a recursos independientes, una operación de eliminación elimina el producto, incluidos todos los recursos de una organización, y una operación de creación necesita un registro para cada uno de los recursos del archivo de importación para que se pueda especificar la cantidad adecuada de cada uno de ellos. El campo allowOverAllocation es para todo el producto y no importa en qué recurso se encuentre una actualización de este campo.
Descripción de los encabezados
Requisitos de importación
Validación de datos
-
El campo de operación debe tener una operación válida.
-
Los datos de importación del producto deben tener propiedades y valores para los campos obligatorios.
-
Las propiedades de los datos de importación del producto deben ser del tipo correcto.
-
El campo de directiva de producto (overAllocation) no debe proporcionarse para recursos diferentes.
-
El campo grantedQuantity:
- No se puede cambiar a ilimitado si aún no es ilimitado.
- Debe ser un entero no negativo o el valor de cadena ilimitado.
Validación de permiso/acceso
- La organización asociada con los datos de importación debe existir. Si está actualizando, asegúrese de que el producto y el recurso asociados con los datos de importación existan realmente.
Agregar validación de producto
- SourceLicenseId debe existir.
- La organización asociada al nuevo producto debe existir.
- El producto que se está creando no debe existir (producto con el mismo ID de licencia).
- Los recursos asociados con un producto que se está creando deben tener un productId correspondiente que coincida con ese producto.