Exportación de artefactos de gobierno

Exportación de artefactos de gobierno desde una categoría

Puede exportar un tipo de artefacto de gobernabilidad a la vez desde una categoría o desde una categoría y sus subcategorías. Solo se exportan los artefactos con una relación primaria con la categoría o con sus subcategorías.

Permisos necesarios

Debes ser colaborador con al menos el rol de espectador en una categoría para exportarla, o tener un rol personalizado con permiso para exportar un tipo de artefacto.

Para exportar un tipo de artefacto de gobernabilidad desde una categoría:

1. Elija Gobierno > Categorías.

2. Pulse un nombre de categoría para abrirlo.

3. Pulse Exportar.

4. Seleccione el tipo de artefacto de gobernabilidad que se va a exportar.

5. Opcional. Seleccione esta opción para exportar artefactos desde las subcategorías de la categoría actual.

   Cuando selecciona exportar subcategorías, también tiene la opción de incluir la categoría actual en la exportación. De forma predeterminada, la categoría actual no está incluida. Para exportar la jerarquía completa de categorías (la categoría y todas las subcategorías del árbol), marque ambas casillas. Para exportar todas las categorías principales a la vez, consulte Importar o exportar categorías.

6. Pulse Exportar.

Se descarga un archivo CSV en el sistema. El archivo de exportación tiene la misma estructura que un archivo de importación. Consulte El formato de un archivo CSV de importación. Si exporta la categoría predeterminada del sistema [sin categorizar], el archivo CSV exportado no contiene ningún nombre de categoría para el tipo seleccionado de artefacto de gobernabilidad.

Exportación de todos los artefactos de gobernabilidad de un tipo a la vez

Puede exportar todos los artefactos de gobernabilidad de un tipo seleccionado a la vez utilizando la API REST. Envíe una solicitud de GET /v3/governance_artifact_types/{artifact_type}/export. Sustituya {artifact_type} por el tipo de artefacto que desea exportar. Para exportar todos los artefactos del tipo seleccionado de todas las categorías, deje el campo category_id vacío. Para obtener más detalles, consulte la Documentación de la API.

Permisos necesarios

Debes ser colaborador con al menos el rol de espectador en todas las categorías, o con un rol personalizado con permiso para exportar un tipo de artefacto.

Exportación de todos los artefactos de gobierno a un archivo ZIP

Puede exportar todos los artefactos de gobierno a un único archivo ZIP utilizando la API REST. Utilice este tipo de exportación para trasladar todos los artefactos de gobernanza de una instancia del servicio IBM Knowledge Catalog a otra. El archivo ZIP contiene carpetas para cada tipo de artefacto y cada carpeta contiene un archivo CSV con artefactos. Puede exportar todos los tipos de artefacto o solo los seleccionados. Este método también permite exportar e importar colaboradores de categorías con sus roles de categoría.

Envíe una solicitud de GET /v3/governance_artifact_types/export. En el campo artifact_id_mode, deje el valor predeterminado always, porque los valores de ID de artefacto son necesarios para la importación. Para obtener más detalles, consulte la Documentación de la API.

Permisos necesarios

Debes tener el permiso Administrar glosario.

También puede utilizar el cpd-cli comando para exportar e importar artefactos de gobernanza con un archivo ZIP dentro de un clúster de Cloud Pak for Data o entre diferentes clústeres. Para obtener más información, consulte Migración de artefactos de gobernanza en la documentación de IBM Software Hub.

Consideraciones acerca de la seguridad

A partir de la versión 4.6.0, los datos de gobernanza exportados a archivos de CSV se limpian para protegerlos contra ataques conocidos de inyección de CSV, con el fin de garantizar su seguridad en aquellos programas de hojas de cálculo que interpretan automáticamente los datos de CSV. Como resultado, cualquier valor de texto que comience con uno de los siguientes caracteres:

• igual a (=)
• más (+)
• menos (-)
• en (@)

van precedidos de un carácter de comilla simple ('). Para garantizar la coherencia de la funcionalidad, los archivos « CSV » importados se analizan adicionalmente para eliminar automáticamente el carácter de comilla simple ('). Esta limpieza también se aplica al importar y exportar artefactos de gobernanza a archivos ZIP, ya que estos contienen archivos « CSV ».

Para desactivar esta función:

1. Editar IBM Knowledge Catalog Glosario Implementación del servicio:

   oc edit deployment wkc-glossary-service
   

2. Establezca la variable de entorno ESCAPE_FORMULAS_IN_CSV_FILES en el valor false.

Para obtener más información, consulte « CSV Injection ».

Más información

• Importación de artefactos de gobernabilidad
• Importación o exportación de categorías
• IBM Knowledge Catalog API