Resuelva los problemas que pueda encontrar al importar artefactos de gobernanza con IBM Knowledge Catalog.
- Los nombres de columna son incorrectos
- Se omiten las relaciones con artefactos no existentes
- La categoría no existe
- No se pueden encontrar los artefactos después de la importación de CSV
- No se pueden encontrar los artefactos después de la importación de ZIP
- El proceso de importación de ZIP crea artefactos duplicados
- Faltan las relaciones con las clases de datos predefinidas y las clasificaciones importadas de ZIP
Los nombres de columna son incorrectos
Descripción del problema
La importación falla con el error de que un nombre de columna no es válido para este tipo de artefacto, o que falta una columna obligatoria, pero de hecho todas las columnas del archivo se nombran correctamente y no falta ninguna de las columnas obligatorias.
Solución temporal
Las cabeceras pueden contener algunos caracteres de espacio en blanco que no son visibles en la hoja de cálculo o incluso en el editor de texto. El carácter de espacio en blanco impide que se reconozca el nombre de columna.
- Edite el archivo con un editor que muestre caracteres de espacio en blanco.
- Intente suprimir las cabeceras y escriba sus nombres manualmente desde cero.
- Compruebe si la codificación del archivo es UTF-8y no, por ejemplo, UTF-8 BOM.
Se omiten las relaciones con artefactos no existentes
Descripción del problema
Cuando define cualquier tipo de relación entre dos artefactos, el proceso de importación se realiza correctamente, pero se omiten las relaciones con artefactos no existentes. Las relaciones omitidas dan como resultado errores similares a los siguientes:
GIM00015E: Artifact Average balance in column Related Terms is not found in the specified hierarchy.
Solución temporal
Si tiene previsto importar varios tipos de artefactos que tienen relaciones entre sí, primero importe todos los artefactos, publique los artefactos importados y, a continuación, vuelva a importar los mismos archivos CSV, con el método de fusión Sustituir todos los valores . El segundo proceso de importación añade las relaciones a los artefactos existentes.
La categoría no existe
Descripción del problema
Si una categoría padre para un artefacto no está definida en el archivo CVS, los artefactos se importan a la categoría [sin categorizar] de forma predeterminada. Si una categoría padre para un artefacto está definida en el archivo CSV, pero no existe en el entorno, la importación falla. El proceso de importación siempre crea sólo un tipo de artefacto por importación. Cuando se importan artefactos que no son categorías, no se puede crear la categoría padre.
Solución temporal
Antes de importar artefactos desde un archivo CSV, asegúrese de que las categorías que desea importar existan en el entorno. Créelos antes de iniciar el proceso de importación.
No se pueden encontrar los artefactos después de la importación de CSV
Descripción del problema
Los artefactos que importan los archivos CSV no están visibles en las páginas publicadas.
Solución temporal
Debe publicar los artefactos antes de que aparezcan como Publicados y estén disponibles para su uso. Si los artefactos están en las categorías importadas, es posible que tenga que añadir usuarios como colaboradores a dichas categorías.
No se pueden encontrar los artefactos después de la importación de ZIP
Descripción del problema
Los artefactos que importan los archivos ZIP no están visibles en la interfaz de usuario, pero están disponibles en las llamadas de API.
Solución temporal
Es posible que el servicio wkc-search
no estuviera en un estado ready
durante la importación de ZIP. Para resolver el problema, vuelva a sincronizar con el mandato siguiente:
curl -X GET "$CPD_URL/v3/glossary_terms/admin/resync?artifact_type=all" -k -H "accept: application/json" -H "Authorization: Bearer $TOKEN"
El proceso de importación de ZIP crea artefactos duplicados
Descripción del problema
Los artefactos de los archivos ZIP exportados se identifican con identificadores de artefacto en la columna Artifact ID
, en lugar de mediante el nombre de artefacto y la vía de acceso de categoría. Sin embargo, los identificadores de artefactos para términos empresariales predefinidos, clases de datos y clasificaciones difieren entre cada instancia de IBM Knowledge Catalog. Por lo tanto, los artefactos predefinidos importados no se reconocen como los mismos que los artefactos predefinidos existentes. Por lo tanto, el proceso de importación crea artefactos duplicados.
Solución temporal
Elimine los artefactos predefinidos existentes de la instancia de IBM Knowledge Catalog de destino antes de importar artefactos. Consulte Supresión de artefactos publicados del mismo tipo.
Para clases de datos y clasificaciones predefinidas:
- Excluya la categoría [sin categorizar] cuando cree el archivo ZIP exportando artefactos.
- Edite los archivos CSV para las clases de datos y clasificaciones y sustituya los identificadores de artefacto para las clases de datos y clasificaciones predefinidas en las columnas Clasificación padre y Clase de datos padre por los nombres de artefacto predefinidos equivalentes y las vías de acceso de categoría.
- Edite los archivos CSV para otros artefactos y sustituya los identificadores de artefacto para las clases de datos y clasificaciones predefinidas por los nombres de artefacto predefinidos equivalentes y las vías de acceso de categoría en las columnas Clasificaciones y Clases de datos , para cualquier artefacto que tenga relaciones con los artefactos predefinidos.
Al importar los artefactos, se crean las relaciones con los artefactos predefinidos de destino existentes.
Para términos empresariales predefinidos:
- Excluya la categoría Datos personales de ejemplo de Knowledge Accelerator cuando cree el archivo ZIP exportando artefactos.
- Edite los archivos CSV para termsa de negocio y otros artefactos y sustituya los identificadores de artefacto para términos de negocio predefinidos por los nombres de artefacto predefinidos equivalentes y las vías de acceso de categoría en la columna Términos relacionados y en cualquier otra columna que defina relaciones de términos de negocio.
Al importar los artefactos, se crean las relaciones con los artefactos predefinidos de destino existentes.
Los conjuntos de datos de referencia predefinidos de la categoría Ubicaciones tienen los mismos valores de ID de artefacto en todas las instancias de IBM Knowledge Catalog, por lo que no es necesaria una solución.
Faltan las relaciones con las clases de datos predefinidas y las clasificaciones importadas de ZIP
Descripción del problema
Las propiedades personalizadas y los valores de relación no se importan.
Solución temporal
Edite los archivos CSV y edite los valores para las clases de datos predefinidas relacionadas y las clasificaciones de los ID de artefacto a nombres de artefacto y vías de acceso de categoría y, a continuación, vuelva a importar.
Tema principal: Solución de problemas IBM Knowledge Catalog