Requisitos previos

Antes de importar artefactos de gobernabilidad con un archivo CSV, cree el archivo con el formato correcto y asegúrese de que tiene los permisos necesarios.

Preparación para importar artefactos de gobernabilidad

Para poder importar artefactos de gobernabilidad, deben existir todas las categorías y subcategorías que se listan en el archivo de importación para dichos artefactos. De lo contrario, los artefactos con categorías no definidas no se importan. Para obtener más información, consulte Resolución de problemas de importación de artefactos de gobernabilidad.

Para poder importar un archivo CSV con definiciones de categoría, deben existir las categorías de nivel superior, a menos que las defina en el archivo.

Para crear las categorías necesarias, puede utilizar cualquiera de estos métodos:

• Cree las categorías a través de la interfaz de usuario. Consulte Gestión de categorías.
• Importe las categorías con un archivo CSV, ya sea a través de la interfaz de usuario o con una solicitud de API.

Los archivos de importación pueden incluir relaciones con otros tipos de artefactos de gobernabilidad que todavía no ha importado. Se crean los artefactos definidos en el archivo. Sin embargo, las relaciones con artefactos que no existen no se crean y recibe un mensaje de error. Puede añadir las relaciones importando de nuevo los archivos que han recibido errores después de importar y publicar los otros tipos de artefactos de gobernabilidad.

Importación de un archivo CSV a través de la interfaz de usuario

Para importar un archivo CSV a través de la interfaz de usuario:

1. Si es necesario, cree categorías. Consulte Preparación para importar artefactos de gobernabilidad.
2. En el menú de navegación, abra la sección Gobierno y seleccione Categorías, Términos de negocio, Clasificaciones, Clases de datos, Datos de referencia, Políticaso Reglas.
3. Pulse Añadir tipo de artefacto > Importar desde archivo. Si el botón está inhabilitado, asegúrese de que tiene los permisos necesarios.
4. Añada el archivo CSV.
5. Establezca el método de fusión para resolver conflictos con cualquier artefacto existente:
   • Sustituir todos los valores
   • Sustituir por valores definidos
   • Sustituir valores vacíos Para artefactos nuevos, cada uno de estos métodos produce los mismos resultados.
6. Haga clic en Importar. El proceso de importación se ejecuta de forma asíncrona. Si deja abierta la ventana de importación, puede ver los resultados de la importación. De lo contrario, puede cerrar la ventana de importación para continuar trabajando. Sin embargo, no se le notifica cuando se completa la importación y no puede acceder a los resultados de la importación.
7. Cuando finalice el proceso de importación, finalice los artefactos y las categorías.

Importación de archivos CSV con una solicitud de API

En la solicitud de API, puede especificar que se ejecuten procesos de importación paralelos o establecer la especificación de tipo de contenido en una codificación distinta de UTF-8.

Para importar un archivo CSV utilizando la API REST:

1. Si es necesario, cree categorías. Consulte Preparación para importar artefactos de gobernabilidad.
2. Envíe una solicitud de POST /v3/governance_artifact_types/{artifact_type}/import. Establezca los parámetros de consulta:
   1. Establezca el parámetro merge option para resolver conflictos con artefactos existentes:
      • all: Sustituir todos los valores.
      • specified: Sustituir por valores definidos
      • empty: Sustituir valores vacíos
   2. Opcional. Establezca el parámetro async_mode en true si desea ejecutar varios procesos de importación en paralelo.
   3. Si es necesario, incluya información de codificación en la solicitud de API. Consulte Importación de archivos CSV con codificación distinta de UTF-8. Consulte la documentación de la API: Importar valores de un archivo CSV especificado. Después de enviar la solicitud, se proporciona un ID de proceso en la respuesta (parámetro process_id).
3. Opcional. Puede utilizar el ID de proceso que se proporciona en la respuesta para comprobar el estado de la importación. Envíe una solicitud GET /v3/governance_artifact_types/import/status/{process_id} para devolver el estado del proceso de importación. Consulte la documentación de la API: Estado de la importación.
4. Cuando finalice el proceso de importación, finalice los artefactos y las categorías.

curl -X POST "https://{server}:{port}/v3/governance_artifact_types/{artifact_type}/import?merge_option={merge_option}" -H "accept: application/json" -H "Authorization: $AUTHORIZATION_HEADER" -H "content-type: multipart/form-data" -F "file=@\"./import_glossary.csv\";type=text/csv;charset=windows-1250" -k

Finalización de los artefactos y categorías

Los artefactos de gobernabilidad del archivo CSV se importan como borradores y están sujetos al flujo de trabajo. Los artefactos de borrador deben seguir el flujo de trabajo para ese tipo de artefacto de gobernabilidad. Puede ver los artefactos de gobernabilidad de borrador en la pestaña Borrador para el tipo de artefacto respectivo, por ejemplo, términos empresariales.

Para finalizar los artefactos importados:

1. Después de importar todos los tipos de artefactos, publique todos los artefactos de borrador. Vaya a la Bandeja de entrada de tareas e inicie el proceso de publicación. Debe tener permiso para publicar los artefactos. Consulte Flujos de trabajo para artefactos de gobernabilidad.
2. Si es necesario, vuelva a ejecutar la importación para los archivos que han recibido errores de relación con el método de fusión Sustituir todos los valores . A continuación, publique los artefactos actualizados.

Las categorías que importe se publican inmediatamente porque las categorías no están sujetas al flujo de trabajo. Las categorías importadas tienen los siguientes colaboradores:

• Es un colaborador en todas las categorías que importa, con el rol Propietario .
• Si importa nuevas categorías de nivel superior, es el único colaborador.
• Si importa subcategorías a categorías existentes, las nuevas subcategorías heredan todos los colaboradores de sus categorías de nivel superior.

Para obtener más información, consulte Resolución de problemas de importación de artefactos de gobernabilidad.

Para finalizar las categorías importadas, añada otros colaboradores a las nuevas categorías. Si añade el grupo Acceso público a una categoría importada, tiene el rol de categoría Editor asignado de forma predeterminada, en lugar del rol Visor , que se asigna a este grupo cuando crea manualmente categorías.

Consulte Gestión de colaboradores de categoría.

Más información

• Formato de archivo CSV para importar artefactos de gobernabilidad

Tema padre: Importar métodos para artefactos de gobernabilidad