Come importare Knowledge Accelerators in IBM Knowledge Catalog

Torna alla versione inglese della documentazione

Introduzione a Knowledge Accelerators

Ultimo aggiornamento: 21 giu 2024

Come importare Knowledge Accelerators in IBM Knowledge Catalog

I componenti di Knowledge Accelerators devono essere caricati in IBM Knowledge Catalog prima di poter essere personalizzati.

Un amministratore può importare Knowledge Accelerators in IBM Knowledge Catalog utilizzando gli endpoint API REST forniti come parte del contenuto.

Per ulteriori informazioni, consultare la documentazione dell'API Knowledge Accelerators all'indirizzo https://cloud.ibm.com/apidocs/watson-data-api#list-kas o accedere all'interfaccia utente Knowledge Accelerators OpenAPI accodando v1/knowledge_accelerators/api/explorer/ al proprio URL IBM Cloud Pak for Data .

Avvio rapido

La seguente tabella illustra i passi principali per importare una risorsa utente di Knowledge Accelerators .

Le descrizioni degli endpoint API per Knowledge Accelerators sono disponibili all'indirizzo https://cloud.ibm.com/apidocs/watson-data-api#list-kas.

Fase	Azione o endpoint API	Ulteriori dettagli
Requisiti e autorizzazioni	Devi disporre delle seguenti autorizzazioni utente : Gestisci categorie di governance Gestisci glossario	Requisiti e autorizzazioni
Esegui autenticazione	Genera un token IAM IBM Cloud utilizzando la chiave API. Vedere https://cloud.ibm.com/docs/account?topic=account-iamtoken_from_apikey.	Autenticazione e autorizzazione
Importa	Importare gli elementi Knowledge Accelerator specificati nel glossario. Vedi https://cloud.ibm.com/apidocs/watson-data-api#import-ka-into-ikc.	Consultare la sezione Importazione di Knowledge Accelerators
Stato di importazione	Importazione dello stato degli asset. Vedere https://cloud.ibm.com/apidocs/watson-data-api#get-import-status.	Controllo dello stato del lavoro di importazione

Questo video descrive come importare Knowledge Accelerators.

Esonero di responsabilità video: questo video fornisce un metodo visivo per apprendere i concetti e le attività in questa documentazione. Alcuni passi secondari ed elementi grafici in questo video potrebbero differire dalla distribuzione di Cloud Pak for Data .

Requisiti e autorizzazioni

I Knowledge Accelerators sono disponibili per l'importazione in IBM Knowledge Catalog, per utenti IBM Cloud Pak for Data con il seguente piano e le seguenti autorizzazioni utente .

Piano dell'offerta

È possibile aggiungere Knowledge Accelerators al proprio framework di governance se si dispone del piano Enterprise IBM Cloud Pak for Data . Per ulteriori informazioni sul piano Enterprise, vedi Piani di servizioIBM Knowledge Catalog.

Autorizzazioni richieste

È necessario disporre delle seguenti autorizzazioni utente per importare Knowledge Accelerators:

Gestisci categorie di governance
Gestisci glossario

Ricerca di Knowledge Accelerators in Resource hub

Accedi a Cloud Pak for Data as a Service Resource hub https://dataplatform.cloud.ibm.com/gallery.
Selezionare Filtro > Tag > Knowledge Accelerators.
Fare clic sul riquadro per visualizzare i dettagli per un particolare settore Knowledge Accelerators .

Autenticazione e autorizzazione

Per autenticarti con Cloud Pak for Data, devi generare un IBM Cloud IAM.

Ottieni la chiave API. Per istruzioni, consultare: https://cloud.ibm.com/docs/account?topic=account-userapikey#create_user_key.
Genera un token IAM utilizzando la chiave API. Per istruzioni, consultare: https://cloud.ibm.com/docs/account?topic=account-iamtoken_from_apikey.

Scelta degli elementi di Knowledge Accelerator da importare

Quando si prevede di importare il contenuto di Knowledge Accelerators , considerare le seguenti due opzioni principali.

Importazione di una selezione di ambiti di business: È possibile importare separatamente una selezione di Knowledge Accelerator Business Scope, ad esempio Data Privacy e altri ambiti specifici del settore. Se uno o più di questi ambiti di business esiste per un'area a cui si è interessati e se si preferisce iniziare con un numero relativamente basso di termini di business, ad esempio da 200 a 500 termini, è possibile installare uno o più di questi ambiti separati.
Importazione di alcuni o di tutti i vocabolari di Knowledge Accelerator: I vocabolari Knowledge Accelerators esistono per ciascuno dei quattro settori specifici e contengono il vocabolario di business completo, i vocabolari di allineamento di settore e tutti gli ambiti di business. È possibile scegliere di importare tutti o una selezione di questi vocabolari. Se è necessario importare una serie estesa di termini di business per affrontare l'ampiezza di un settore, ad esempio da 5.000 a 20.000 termini, selezionare questa opzione.

Per un elenco dettagliato di tutti gli elementi disponibili per ogni settore, inclusa una definizione, gli identificativi e ulteriori informazioni, consultare i seguenti link.

Verifica degli elementi disponibili per l'importazione

Per verificare quali Knowledge Accelerators sono disponibili per l'importazione, richiamare l'endpoint API Get all Knowledge Accelerators .

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

Controllo degli elementi disponibili per l'importazione per settore

Per controllare quali Knowledge Accelerators sono disponibili per l'importazione per un determinato settore, richiamare l'endpoint API Get a specific Knowledge Accelerator .

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

I valori ID da utilizzare per ciascun settore sono riportati nella seguente tabella.

Multisettore	Energia e pubblica utilità	Servizi finanziari	Sanità	Settore assicurativo
`kaci20`	`kaeu20`	`kafs20`	`kahc20`	`kain20`

Verifica dell'importazione di Knowledge Accelerators

Per verificare se gli Knowledge Accelerators vengono importati in un'istanza di IBM Knowledge Catalog, richiamare l'endpoint API Get what Knowledge Accelerator items are importato nel glossario .

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

Importazione di Knowledge Accelerators

Per importare Knowledge Accelerators elementi in un'istanza di IBM Knowledge Catalog, richiamare l'endpoint API Importa elementi Knowledge Accelerator specificati nel glossario .

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

Scegliere gli elementi che si desidera installare. Consultare Verifica degli elementi disponibili per importazione e Verifica degli elementi disponibili per l'importazione per settore.
Suggerimento: per ogni settore, è possibile importare ambiti di business specifici o il vocabolario Business Core completo e i vocabolari di allineamento di settore facoltativi. Per un elenco dettagliato di tutti gli elementi disponibili, inclusa una definizione, gli identificatori e ulteriori informazioni, consultare i seguenti link.

Immettere i valori per i seguenti parametri.

Ad esempio:

Parametro	Descrizione	Esempio
id_ka_	L'id per un settore	`kafs20`
ID	L'ID per uno o più elementi Knowledge Accelerator che si desidera importare separati da una virgola. Notare che è possibile importare solo un ambito alla volta.	`core-bpi,ccpa,fhir, gdpr`
opzione_unione	L'opzione di unione da utilizzare durante l'importazione in IBM Knowledge Catalog.	`all`
dipendenze	Indica quali dipendenze degli ID elemento specificati devono essere importate.	`mandatory`
importa_do_import	Selezionare `false` per verificare i parametri e scoprire cosa verrà importato. Selezionare `true` da importare.	`false`

Nella risposta, prendere nota di "process_id" poiché è possibile utilizzarlo per controllare lo stato del lavoro di importazione nella sezione successiva, Controllo dello stato del lavoro di importazione. Potrebbe essere necessario o opportuno eseguire questo controllo, poiché a volte l'importazione può richiedere del tempo, a seconda del numero e della dimensione degli elementi che sono stati importati.

Nota:

Se si importano più ambiti di business KA, alcune relazioni da risorse condivise come politiche e regole ai termini del vocabolario potrebbero essere sovrascritte da una successiva importazione di ambito di business.
Se si importano Knowledge Accelerators per più settori, le relazioni dalle risorse utente condivise, ad esempio dalle politiche e dalle regole ai termini del vocabolario, non possono essere unite per l'importazione successiva - le associazioni dalle risorse utente KA importate inizialmente vengono conservate. È possibile ignorare i messaggi (GIM00010E o GIM00015E) nel log di importazione relativo alle politiche e alle regole di governance.

Controllo dello stato del lavoro di importazione

Per controllare lo stato dell'importazione, richiamare l'endpoint API Importazione dello stato degli asset .

Vedere https://cloud.ibm.com/apidocs/watson-data-api#get-import-status dove {process_id} è il valore di Importazione di Knowledge Accelerators.

Lo stato di importazione rimane "IN_PROGRESS" fino a quando tutte le risorse utente non vengono importate.

Aggiunta di collaboratori

È necessario aggiungere collaboratori alle categorie Knowledge Accelerators , altrimenti solo la persona che importa l'acceleratore può utilizzare le risorse utente. Vedi Gestione dell'accesso a una categoria per dettagli su come eseguire questa operazione.

Copia in un progetto

È anche possibile aggiungere le risorse Knowledge Accelerators come file CSV in un progetto Cloud Pak for Data , utilizzando l'endpoint API Copia elementi Knowledge Accelerator nel progetto .

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

Suggerimento:

I file CSV possono essere scaricati localmente e il contenuto può essere importato con l'interfaccia utente di IBM Knowledge Catalog . Per ulteriori informazioni su come utilizzare l'importazione CSV in IBM Knowledge Catalog, fare riferimento alla sezione Importazione delle risorse utente di governance per tipo con i file CSV.