Cómo importar Knowledge Accelerators en IBM Knowledge Catalog

Volver a la versión inglesa de la documentación

Iniciación a Knowledge Accelerators

Última actualización: 21 jun 2024

Cómo importar Knowledge Accelerators en IBM Knowledge Catalog

Los componentes de Knowledge Accelerators deben cargarse primero en IBM Knowledge Catalog para poder personalizarlos.

Un administrador puede importar Knowledge Accelerators a IBM Knowledge Catalog utilizando puntos finales de API REST que se proporcionan como parte del contenido.

Para obtener más información, consulte la documentación de la API de Knowledge Accelerators en https://cloud.ibm.com/apidocs/watson-data-api#list-kas o acceda a la interfaz de usuario de Knowledge Accelerators OpenAPI añadiendo v1/knowledge_accelerators/api/explorer/ al URL de IBM Cloud Pak for Data .

Inicio rápido

En la tabla siguiente se describen los pasos principales para importar un artefacto de Knowledge Accelerators .

Las descripciones de los puntos finales de API para Knowledge Accelerators se pueden encontrar en https://cloud.ibm.com/apidocs/watson-data-api#list-kas.

Paso	Punto final de acción o API	Más detalles
Requisitos y permisos	Debe tener estos permisos de usuario : Gestionar categorías de gobernabilidad Gestionar glosario	Requisitos y permisos
Autenticar	Genere una señal de IAM de IBM Cloud utilizando la clave de API. Consulte https://cloud.ibm.com/docs/account?topic=account-iamtoken_from_apikey.	Autenticación y autorización
Importar	Importar elementos especificados de Knowledge Accelerator en el glosario. Consulte https://cloud.ibm.com/apidocs/watson-data-api#import-ka-into-ikc.	Consulte Importación de Knowledge Accelerators
Estado de importación	Importación del estado de los activos. Consulte https://cloud.ibm.com/apidocs/watson-data-api#get-import-status.	Comprobación del estado del trabajo de importación

Vea este vídeo, que describe cómo importar Knowledge Accelerators.

Declaración de limitación de responsabilidad de vídeo: este vídeo proporciona un método visual para aprender los conceptos y tareas de esta documentación. Algunos pasos menores y elementos gráficos de este vídeo pueden diferir del despliegue de Cloud Pak for Data .

Requisitos y permisos

Los Knowledge Accelerators están disponibles para importarlos a IBM Knowledge Catalog, a usuarios de IBM Cloud Pak for Data con el siguiente plan y permisos de usuario de .

Plan de oferta

Puede añadir Knowledge Accelerators a la infraestructura de gobierno si tiene el plan IBM Cloud Pak for Data Enterprise. Para obtener más información sobre el plan Empresa, consulte Planes de servicio deIBM Knowledge Catalog.

Permisos necesarios

Debe tener estos permisos de usuario para importar Knowledge Accelerators:

Gestionar categorías de gobernabilidad
Gestionar glosario

Búsqueda de Knowledge Accelerators en el concentrador de recursos

Inicie sesión en el Cloud Pak for Data as a Service Centro de recursos https://dataplatform.cloud.ibm.com/gallery.
Seleccione Filtrar > Etiquetas > Knowledge Accelerators.
Pulse en el mosaico para ver los detalles de un sector determinado de Knowledge Accelerators .

Autenticación y autorización

Para autenticarse con Cloud Pak for Data, debe generar una señal de IAM de IBM Cloud .

Obtenga la clave de API. Para obtener instrucciones, consulte: https://cloud.ibm.com/docs/account?topic=account-userapikey#create_user_key.
Genere una señal de IAM utilizando la clave de API. Para obtener instrucciones, consulte: https://cloud.ibm.com/docs/account?topic=account-iamtoken_from_apikey.

Elección de los elementos de Knowledge Accelerator a importar

Cuando tenga previsto importar contenido de Knowledge Accelerators , tenga en cuenta las dos opciones principales siguientes.

Importación de una selección de ámbitos empresariales: Hay una selección de ámbitos empresariales de Knowledge Accelerator disponibles para importarlos por separado, por ejemplo, Data Privacy y otros ámbitos específicos del sector. Si existe uno o más de estos ámbitos de negocio para un área en la que está interesado, y si prefiere empezar con un número relativamente pequeño de términos de negocio, por ejemplo de 200 a 500 términos, puede instalar uno o más de estos ámbitos separados.
Importación de algunos o todos los vocabularios de Knowledge Accelerator: Los vocabularios de Knowledge Accelerators existen para cada uno de los cuatro sectores específicos y contienen el vocabulario empresarial completo, los vocabularios de alineación del sector y todos los ámbitos empresariales. Puede elegir importar todos o una selección de estos vocabularios. Si es necesario importar un amplio conjunto de términos empresariales para abordar la amplitud de una industria, por ejemplo, de 5.000 a 20.000 términos, seleccione esta opción.

Para obtener una lista detallada de todos los elementos disponibles para cada sector, incluida una definición, los identificadores y más información, consulte los enlaces siguientes.

Comprobación de qué elementos están disponibles para la importación

Para comprobar qué Knowledge Accelerators están disponibles para su importación, llame al punto final de la API Get all Knowledge Accelerators .

Consulte https://cloud.ibm.com/apidocs/watson-data-api#list-kas

Comprobación de qué artículos están disponibles para la importación por sector

Para comprobar qué Knowledge Accelerators están disponibles para su importación para un sector específico, llame al punto final de la API Obtener un Knowledge Accelerator específico .

Consulte https://cloud.ibm.com/apidocs/watson-data-api#get-ka-by-id.

Los valores de ID a utilizar para cada sector se encuentran en la tabla siguiente.

Varios sectores	Energía y servicios públicos	Servicios financieros	Salud	Seguro
`kaci20`	`kaeu20`	`kafs20`	`kahc20`	`kain20`

Comprobación de qué Knowledge Accelerators ya se han importado

Para comprobar si los Knowledge Accelerators se importan en una instancia de IBM Knowledge Catalog, llame al punto final de la API Obtener qué elementos de Knowledge Accelerator se importan en el glosario .

Consulte https://cloud.ibm.com/apidocs/watson-data-api#get-ka-status.

Importación de Knowledge Accelerators

Para importar elementos de Knowledge Accelerators en una instancia de IBM Knowledge Catalog, llame al punto final de la API Importar elementos de Knowledge Accelerator especificados en el glosario .

Consulte https://cloud.ibm.com/apidocs/watson-data-api#import-ka-into-ikc.

Elija los elementos que desea instalar. Consulte Comprobación de qué elementos están disponibles para la importación y Comprobación de qué elementos están disponibles para la importación por sector.
Sugerencia: Para cada sector, tiene la opción de importar ámbitos de negocio específicos o el vocabulario de núcleo de negocio del sector completo y vocabularios de alineación de sector opcionales. Para obtener una lista detallada de todos los elementos disponibles, incluida una definición, los identificadores y más información, consulte los enlaces siguientes.

Especifique valores para los parámetros siguientes.

Por ejemplo:

Parámetro	Descripción	Ejemplo
ka_id	El ID de un sector	`kafs20`
ID	El ID de uno o varios elementos de Knowledge Accelerator que desea importar separados por una coma. Tenga en cuenta que sólo puede importar un ámbito a la vez.	`core-bpi,ccpa,fhir, gdpr`
opción_fusión	La opción de fusión que se utilizará al importar en IBM Knowledge Catalog.	`all`
dependencies	Indica qué dependencias de los ID de elemento especificados también deben importarse.	`mandatory`
importación_punto	Seleccione `false` para comprobar los parámetros y averiguar qué se importará. Seleccione `true` para importar.	`false`

En la respuesta, tome nota de "process_id", ya que puede utilizarlo para comprobar el estado del trabajo de importación en la sección siguiente, Comprobación del estado del trabajo de importación. Es posible que sea necesario o deseable realizar esta comprobación, ya que a veces la importación puede tardar algún tiempo, en función del número y tamaño de los elementos que se han importado.

Nota:

Si importa varios ámbitos de negocio KA, una importación de ámbito de negocio posterior puede sobrescribir algunas relaciones de artefactos compartidos como, por ejemplo, políticas y reglas a términos de vocabulario.
Si importa Knowledge Accelerators para varios sectores, las relaciones de artefactos compartidos como, por ejemplo, de políticas y reglas a términos de vocabulario, no se pueden fusionar para la importación posterior: las correlaciones de los artefactos KA importados inicialmente se conservan. Puede ignorar los mensajes (GIM00010E o GIM00015E) en el registro de importación relacionados con las políticas y las reglas de gobierno.

Comprobación del estado del trabajo de importación

Para comprobar el estado de la importación, llame al punto final de la API Importar estado de activos .

Consulte https://cloud.ibm.com/apidocs/watson-data-api#get-import-status donde {process_id} es el valor de Importación de Knowledge Accelerators.

El estado de importación permanece "IN_PROGRESS" hasta que se importan todos los artefactos.

Adición de colaboradores

Debe añadir colaboradores a las categorías de Knowledge Accelerators ; de lo contrario, sólo la persona que importa el acelerador puede utilizar los artefactos. Consulte Gestión del acceso a una categoría para obtener detalles sobre cómo hacerlo.

Copia en un proyecto

También puede añadir los artefactos de Knowledge Accelerators como archivos CSV en un proyecto Cloud Pak for Data , utilizando el punto final de API Copiar elementos de Knowledge Accelerator en el proyecto .

Consulte https://cloud.ibm.com/apidocs/watson-data-api#copy-ka-into-ikc

Consejo:

Los archivos CSV se pueden descargar localmente y el contenido se puede importar con la interfaz de usuario de IBM Knowledge Catalog . Para obtener más información sobre cómo utilizar la importación CSV en IBM Knowledge Catalog, consulte el tema Importación de artefactos de gobernabilidad por tipo con archivos CSV.