Desde la interfaz de usuario, puede exportar un tipo de artefacto cada vez desde una única categoría. Puede utilizar la API de IBM Knowledge Catalog para exportar todos los artefactos de gobernanza de un tipo. La información se exporta a un archivo CSV que se graba en la carpeta de descarga predeterminada. El nombre de archivo predeterminado es <category_name>-<artifact_type>-csv-export.csv
. Puede modificar este archivo fuera del catálogo y luego importarlo.
- Exportación de artefactos desde una categoría
- Exportación de todos los artefactos de gobernabilidad de un tipo a la vez
- Exportación de todos los artefactos de gobierno a un archivo ZIP
- Consideraciones acerca de la seguridad
Para obtener información sobre las categorías de exportación, consulte Categorías de importación o exportación.
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
- Debe ser un colaborador con al menos el rol de Visor en una categoría para exportarlo, o con un rol personalizado con el permiso para exportar un tipo de artefacto.
Para exportar un tipo de artefacto de gobernabilidad desde una categoría:
Elija Gobierno > Categorías.
Pulse un nombre de categoría para abrirlo.
Pulse Exportar.
Seleccione el tipo de artefacto de gobernabilidad que se va a exportar.
Puede exportar hasta 400 artefactos de gobierno por tipo.
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 una jerarquía de categorías completa (la categoría y todas las subcategorías del árbol), marque ambos recuadros de selección. Para exportar todas las categorías raíz a la vez, consulte Importación o exportación de categorías.
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 hasta 400 artefactos de gobierno de un tipo seleccionado 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 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
- Debe ser un colaborador con al menos el rol de Visor en todas las categorías, o con un rol personalizado con el 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 mover todos los artefactos de gobernanza de una instancia de 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. El número máximo de artefactos de gobierno que puede exportar es 400. Este método también permite exportar e importar colaboradores de categoría 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
- Debe tener un rol de servicio de Gestor.
Consideraciones acerca de la seguridad
Los datos de gobierno exportados a archivos CSV se sanean frente a ataques de inyección CSV conocidos, para ser seguros para los programas de hoja de cálculo que interpretan automáticamente los datos CSV. Como resultado, cualquier valor de texto que empiece por uno de los siguientes caracteres:
- es igual a (=)
- más (+)
- menos (-)
- a las (@)
están precedidos por un carácter de comilla simple ('). Para que la funcionalidad sea coherente, los archivos CSV importados se analizan adicionalmente para eliminar automáticamente el carácter de comilla simple ('). El saneamiento también se aplica al importar y exportar artefactos de gobernabilidad a archivos ZIP, ya que contienen archivos CSV.
Para inhabilitar esta funcionalidad:
Editar el glosario de IBM Knowledge Catalog Despliegue del servicio:
oc edit deployment wkc-glossary-service
Establezca la variable de entorno
ESCAPE_FORMULAS_IN_CSV_FILES
en el valorfalse
.
Para obtener más información, consulte Inyección de CSV.
Más información
- Importación de artefactos de gobernabilidad
- Importación o exportación de categorías
- API IBM Knowledge Catalog
Tema principal: Gestión de artefactos de gobierno