Comment importer les Knowledge Accelerators dans IBM Knowledge Catalog

Retourner à la version anglaise de la documentation

Initiation à Knowledge Accelerators

Dernière mise à jour : 21 juin 2024

Comment importer les Knowledge Accelerators dans IBM Knowledge Catalog

Les composants Knowledge Accelerators doivent d'abord être chargés dans IBM Knowledge Catalog avant de pouvoir être personnalisés.

Un administrateur peut importer les Knowledge Accelerators dans IBM Knowledge Catalog en utilisant les noeuds finaux d'API REST qui sont fournis dans le cadre du contenu.

Pour plus d'informations, voir la documentation sur les API Knowledge Accelerators à l'adresse https://cloud.ibm.com/apidocs/watson-data-api#list-kas ou accédez à l'interface utilisateur Knowledge Accelerators OpenAPI en ajoutant v1/knowledge_accelerators/api/explorer/ à votre URL IBM Cloud Pak for Data .

Démarrage rapide

Le tableau suivant décrit les principales étapes d'importation d'un artefact Knowledge Accelerators .

Les descriptions des noeuds finaux d'API pour Knowledge Accelerators sont disponibles à l'adresse https://cloud.ibm.com/apidocs/watson-data-api#list-kas.

Etape	Noeud final d'action ou d'API	Plus de détails
Exigences et droits d'accès	Vous devez disposer des droits utilisateur suivants: Gérer les catégories de gouvernance Gérer le glossaire	Conditions requises et droits d'accès
Authentifier	Générez un jeton IBM Cloud IAM à l'aide de votre clé d'API. Voir https://cloud.ibm.com/docs/account?topic=account-iamtoken_from_apikey.	Authentification et autorisation
Importer	Importer les éléments Knowledge Accelerator spécifiés dans le glossaire. Voir https://cloud.ibm.com/apidocs/watson-data-api#import-ka-into-ikc.	Voir Importation des Knowledge Accelerators
Statut de l'importation	Importation du statut des actifs. Voir https://cloud.ibm.com/apidocs/watson-data-api#get-import-status.	Vérification du statut du travail d'importation

Regardez cette vidéo, qui explique comment importer les Knowledge Accelerators.

Avertissement vidéo: Cette vidéo fournit une méthode visuelle pour apprendre les concepts et les tâches de cette documentation. Certaines étapes mineures et certains éléments graphiques de cette vidéo peuvent différer de votre déploiement Cloud Pak for Data .

Exigences et droits d'accès

Les Knowledge Accelerators sont disponibles pour l'importation dans IBM Knowledge Catalog, vers les utilisateurs IBM Cloud Pak for Data avec le plan suivant et les droits utilisateur .

Plan d'offre

Vous pouvez ajouter Knowledge Accelerators à votre infrastructure de gouvernance si vous disposez du plan Enterprise IBM Cloud Pak for Data . Pour plus d'informations sur le plan Enterprise, voir Plans de serviceIBM Knowledge Catalog.

Droits requis

Vous devez disposer des droits utilisateur suivants pour importer les Knowledge Accelerators:

Gérer les catégories de gouvernance
Gérer le glossaire

Recherche des Knowledge Accelerators dans le concentrateur de ressources

Connectez-vous au Cloud Pak for Data as a Service concentrateur de ressources https://dataplatform.cloud.ibm.com/gallery.
Sélectionnez Filter > Tags > Knowledge Accelerators.
Cliquez sur la vignette pour afficher les détails d'un secteur Knowledge Accelerators particulier.

Authentification et autorisation

Pour vous authentifier avec Cloud Pak for Data, vous devez générer un jeton IAM IBM Cloud .

Obtenez votre clé d'API. Pour obtenir des instructions, voir https://cloud.ibm.com/docs/account?topic=account-userapikey#create_user_key.
Générez un jeton IAM à l'aide de votre clé d'API. Pour obtenir des instructions, voir https://cloud.ibm.com/docs/account?topic=account-iamtoken_from_apikey.

Choix des éléments Knowledge Accelerator à importer

Lorsque vous prévoyez d'importer du contenu Knowledge Accelerators , tenez compte des deux options principales suivantes.

Importation d'une sélection de portées métier: Une sélection de portées métier Knowledge Accelerator peut être importée séparément, par exemple Data Privacy et d'autres portées spécifiques au secteur. Si une ou plusieurs de ces portées métier existent pour une zone qui vous intéresse, et si vous préférez commencer par un nombre relativement faible de termes métier, par exemple 200 à 500 termes, vous pouvez installer une ou plusieurs de ces portées distinctes.
Importation de tout ou partie des vocabulaires de Knowledge Accelerator: Les vocabulaires Knowledge Accelerators existent pour chacun des quatre secteurs d'activité spécifiques et contiennent le vocabulaire métier complet, les vocabulaires d'alignement métier et tous les portées métier. Vous pouvez choisir d'importer tout ou partie de ces vocabulaires. S'il est nécessaire d'importer un ensemble complet de termes métier pour traiter l'étendue d'un secteur d'activité, par exemple 5 000 à 20 000 termes, sélectionnez cette option.

Pour obtenir une liste détaillée de tous les éléments disponibles pour chaque secteur d'activité, y compris une définition, les identificateurs et d'autres informations, consultez les liens suivants.

Vérification des éléments disponibles pour l'importation

Pour vérifier quels Knowledge Accelerators sont disponibles pour l'importation, appelez le noeud final d'API Get all Knowledge Accelerators .

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

Vérification des éléments disponibles pour l'importation par secteur d'activité

Pour vérifier quels Knowledge Accelerators sont disponibles pour l'importation pour un secteur d'activité spécifique, appelez le noeud final d'API Get a specific Knowledge Accelerator .

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

Les valeurs d'ID à utiliser pour chaque secteur d'activité sont répertoriées dans le tableau ci-dessous.

Intersectoriel	Énergie et services publics	Marchés financiers	Soins de santé	Assurance
`kaci20`	`kaeu20`	`kafs20`	`kahc20`	`kain20`

Vérification des Knowledge Accelerators qui sont déjà importés

Pour vérifier si des Knowledge Accelerators sont importés dans une instance d' IBM Knowledge Catalog, appelez le noeud final d'API Obtenir les éléments Knowledge Accelerator importés dans le glossaire .

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

Importation des Knowledge Accelerators

Pour importer des éléments Knowledge Accelerators dans une instance d' IBM Knowledge Catalog, appelez le noeud final d'API Import specified Knowledge Accelerator dans le glossaire .

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

Choisissez les éléments que vous souhaitez installer. Voir Vérification des éléments disponibles pour l'importation et Vérification des éléments disponibles pour l'importation par industrie.
Astuce: Pour chaque secteur d'activité, vous avez la possibilité d'importer des portées métier spécifiques ou le vocabulaire métier de base complet et les vocabulaires d'alignement de secteur d'activité facultatifs. Pour obtenir une liste détaillée de tous les éléments disponibles, y compris une définition, les identificateurs et plus d'informations, voir les liens suivants.

Entrez des valeurs pour les paramètres suivants.

Par exemple :

Paramètre	Descriptif	Exemple
id_ka	ID d'un secteur d'activité	`kafs20`
ID	ID d'un ou de plusieurs éléments Knowledge Accelerator que vous souhaitez importer, séparés par une virgule. Notez que vous ne pouvez importer qu'une seule portée à la fois.	`core-bpi,ccpa,fhir, gdpr`
option_fusionnelle	Option de fusion à utiliser lors de l'importation dans IBM Knowledge Catalog.	`all`
dependencies	Indique les dépendances des ID d'élément spécifiés qui doivent également être importées.	`mandatory`
importation_doo	Sélectionnez `false` pour vérifier les paramètres et savoir ce qui sera importé. Sélectionnez `true` pour l'importation.	`false`

Dans la réponse, notez le "process_id" car vous pouvez l'utiliser pour vérifier le statut du travail d'importation dans la section suivante, Vérification du statut du travail d'importation. Il peut être nécessaire ou souhaitable d'effectuer cette vérification, car l'importation peut parfois prendre un certain temps, en fonction du nombre et de la taille des éléments importés.

Remarque :

Si vous importez plusieurs portées métier KA, certaines relations entre des artefacts partagés tels que des stratégies et des règles et des termes de vocabulaire peuvent être écrasées par une importation ultérieure de portée métier.
Si vous importez Knowledge Accelerators pour plusieurs secteurs d'activité, les relations entre les artefacts partagés, tels que les politiques et les règles, et les termes de vocabulaire, peuvent ne pas être fusionnées pour l'importation suivante-les mappages des artefacts KA initialement importés sont conservés. Vous pouvez ignorer les messages (GIM00010E ou GIM00015E) dans le journal d'importation relatif aux stratégies et aux règles de gouvernance.

Vérification du statut du travail d'importation

Pour vérifier le statut de l'importation, appelez le noeud final d'API Import of assets status .

Voir https://cloud.ibm.com/apidocs/watson-data-api#get-import-status où {process_id} est la valeur de Importation des Knowledge Accelerators.

Le statut d'importation reste "IN_PROGRESS" jusqu'à ce que tous les artefacts soient importés.

Ajout de collaborateurs

Vous devez ajouter des collaborateurs aux catégories Knowledge Accelerators , sinon seule la personne qui importe l'accélérateur peut utiliser les artefacts. Pour plus d'informations sur cette opération, voir Gestion de l'accès à une catégorie .

Copie dans un projet

Vous pouvez également ajouter les artefacts Knowledge Accelerators en tant que fichiers CSV dans un projet Cloud Pak for Data , à l'aide du noeud final d'API Copy Knowledge Accelerator into project .

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

Astuce :

Les fichiers CSV peuvent être téléchargés localement et le contenu peut être importé à l'aide de l'interface utilisateur IBM Knowledge Catalog . Pour plus d'informations sur l'utilisation de l'importation CSV dans IBM Knowledge Catalog, voir la rubrique Importation d'artefacts de gouvernance par type avec des fichiers CSV.