0 / 0

Introduzione a Knowledge Accelerators

Ultimo aggiornamento: 09 lug 2025
Come importare Knowledge Accelerators in IBM Knowledge Catalog

Aggiungere i Knowledge Accelerators in IBM Knowledge Catalog utilizzando l'interfaccia utente o le chiamate API e quindi personalizzare i componenti.

Prima di iniziare

  1. Assicurarsi di disporre del piano e delle autorizzazioni utente seguenti:
    Piano dell'offerta
    Il IBM Cloud Pak for Data Piano aziendale. Per ulteriori informazioni, vedere IBM Knowledge Catalog service plans.
    Autorizzazioni richieste
    • Accedi a cataloghi
    • Gestire la scoperta delle risorse
    • Accedi alle risorse utente di governance
    • Gestisci glossario
    • Gestisci categorie di governance
    • Gestisci progetti

Aggiunta dell'elemento Knowledge Accelerators con l'interfaccia utente

Non è possibile importare vocabolari di allineamento industriale con l'interfaccia utente. È invece necessario utilizzare il metodo API. Per importare i Business Scopes o il Business Core Vocabulary e i Business Performance Indicators, utilizzare il metodo di importazione dell'interfaccia utente.
  1. Andare in Amministrazione > Configurazioni e impostazioni e fare clic sul riquadro Add Knowledge Accelerator .
  2. Selezionare un settore per aggiungere vocabolari.
  3. Selezionare l'ambito o gli ambiti di attività che si desidera aggiungere al settore.
    Tutte le voci: importa tutti i vocabolari specifici di Knowledge Accelerators

    È possibile scegliere di importare ciascuno dei vocabolari specifici di Knowledge Accelerators che contengono il vocabolario aziendale completo e tutti gli ambiti aziendali. Se avete bisogno di importare una serie estesa di termini commerciali per coprire l'ampiezza di un settore, ad esempio da 5.000 a 20.000 termini, selezionate questa opzione.

    È possibile importare i vocabolari di allineamento del settore separatamente utilizzando l'API.

    Voce selezionata - Importazione di un Ambito di attività

    È possibile importare separatamente una selezione di Ambiti aziendali Knowledge Accelerators, ad esempio Data Privacy e altri ambiti specifici del settore. Se esiste uno o più di questi ambiti commerciali per un'area di vostro interesse e se preferite iniziare con un numero relativamente piccolo di termini commerciali, ad esempio da 200 a 500 termini, installate uno o più di questi ambiti separati. Ogni ambito aziendale viene importato separatamente.

    Per un elenco dettagliato di tutti gli elementi disponibili per ogni settore, inclusa una definizione, gli identificativi e ulteriori informazioni, consultare i seguenti link.
  4. Impostare le opzioni di fusione per l'importazione.

    Per ulteriori informazioni, vedere Metodi per unire gli artefatti importati e quelli esistenti.

  5. Fare clic su Add per avviare l'importazione.
    Nota:
    • Se si importano più Business scope KA, alcune relazioni tra artefatti condivisi, come le policy e le regole, e termini del vocabolario potrebbero essere sovrascritte da una successiva importazione di business scope.
    • 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.

    Quando viene visualizzato il messaggio di notifica dell'avvio dell'importazione, è possibile chiudere la finestra.

    Non è possibile avviare più lavori di importazione contemporaneamente.

  6. Si noti il valore process_id nella notifica, poiché non si riceve una notifica quando l'importazione è completata.

    Utilizzare process_id per controllare lo stato del lavoro di importazione. A seconda del numero e delle dimensioni degli articoli importati, l'importazione potrebbe richiedere del tempo.

    Una volta completata l'importazione, è possibile iniziare ad aggiungere i collaboratori.

Aggiunta dell'opzione Knowledge Accelerators con API

Le descrizioni degli endpoint API per Knowledge Accelerators sono disponibili nella documentazione API.

  1. Facoltativo: Controllare quali Knowledge Accelerators sono già importati chiamando l'endpoint API Get what Knowledge Accelerator items are imported into glossary.
  2. Facoltativo: Controllare quali elementi è possibile importare:
  3. Se si utilizza l'API per aggiungere Knowledge Accelerators è necessario autenticarsi con Cloud Pak for Data generando un token IAM IBM Cloud :
    1. Ottenere la chiave API come descritto in Creazione di una chiave API nella console.
    2. Generare un token IAM utilizzando la propria chiave API come descritto in Generazione di un token IAM IBM Cloud utilizzando una chiave API.
  4. Richiama l'endpoint dell'API di glossario Importa gli elementi di Knowledge Accelerator specificati.
  5. Scegliere gli elementi che si desidera installare.
    Nota:
    • Se si importano più Business scope KA, alcune relazioni tra artefatti condivisi, come le policy e le regole, e termini del vocabolario potrebbero essere sovrascritte da una successiva importazione di business scope.
    • 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.
    Tutti gli elementi
    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.
    Voci selezionate - Importazione di un Ambito di attività
    È disponibile una selezione di ambiti aziendali di Knowledge Accelerator da importare separatamente, 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.
    Per un elenco dettagliato di tutti gli elementi disponibili per ogni settore, inclusa una definizione, gli identificativi e ulteriori informazioni, consultare i seguenti link.
  6. 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. necessary
    importa_do_import
    • Selezionare false per verificare i parametri e scoprire cosa verrà importato.
    • Selezionare true da importare.
    		 false
  7. Si noti il valore process_id nella notifica, poiché non si riceve una notifica quando l'importazione è completata.

    Utilizzare process_id per controllare lo stato del lavoro di importazione. A seconda del numero e delle dimensioni degli articoli importati, l'importazione potrebbe richiedere del tempo.

    Una volta completata l'importazione, è possibile iniziare ad aggiungere i collaboratori.

Controllo dello stato dell'importazione

Controllare lo stato dell'importazione chiamando l'endpoint dell'API Import of assets status, dove {process_id} è il valore del passaggio 4 dell'aggiunta dell'opzione Knowledge Accelerators con l'API.

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

Ricerca di Knowledge Accelerators in Resource hub

  • Accedere al Cloud Pak for Data as a Service Hub delle risorse https://dataplatform.cloud.ibm.com/gallery.
  • Selezionare Filtro > Tag > Knowledge Accelerators.
  • Fare clic sul riquadro per visualizzare i dettagli di un particolare settore Knowledge Accelerators settore.

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.

Assegnazione di termini agli asset del modello logico dei dati

Questa Knowledge Accelerators assegna automaticamente i termini di Knowledge Accelerators termini di business agli asset dei modelli di dati logici importati in un catalogo IBM Cloud Pak for Data catalogo.

Prerequisiti
È necessario importare un modello di dati logici in un catalogo IBM Cloud Pak for Data catalogo. È possibile importare un modello utilizzando i seguenti passaggi:
Prerequisiti Passi e dove trovare maggiori informazioni
1. Installare la linea di dati automatizzata MANTA.  
2. Abilita l'importazione del lignaggio.  
3. Per gli utenti dei seguenti modelli industriali IBM, è necessario preparare i modelli per l'importazione.
  1. Aprire il file erwin Data Modeler per il modello logico dei dati.
  2. Rimuovere tutti i diagrammi dal modello. Per ulteriori informazioni, consultare questa pagina di supporto https://www.ibm.com/support/pages/node/7070054
  3. Salvare il modello come XML standard.
  4. Comprimere o zippare il file XML standard.

Per ulteriori informazioni, contattare l 'assistenza IBM.
4. Importare il modello logico dei dati.  
Per chiamare l'endpoint

Per assegnare termini di Knowledge Accelerators esistenti alle risorse del modello di dati logico, chiamare l'endpoint API Assegna termini alla risorsa utilizzando la strategia specificata, ad esempio \ \ industrymodels_ldm.

  1. Vedere https://cloud.ibm.com/apidocs/watson-data-api-cpd#post-add-assignment.
  2. Trova gli id del catalogo, della risorsa e della categoria nell'interfaccia utente IBM Knowledge Catalog interfaccia utente.
    Per trovare l'ID del catalogo:
    1. Dal menu principale IBM Cloud Pak for Data espandere Cataloghi e selezionare Tutti i cataloghi.
    2. Andare al catalogo in uso.
    3. Nel browser URL, l'id del catalogo si trova tra le stringhe "/catalogs/" e "?context=icp4data". Ad esempio, nel seguente URL, l'id è 67ea9e1f-b2d9-423c-ab9e-c234945f9c0b : https://api.dataplatform.cloud.ibm.com/67ea9e1f-b2d9-423c-ab9e-c234945f9c0b/?context=icp4data
    Per trovare l'id della risorsa:
    1. Dal catalogo, fare clic sull'icona del filtro, selezionare " Modello logico " come Asset Type e fare clic su Applica.
    2. Fare clic su "Logical Model" elencato nel set di risultati, ad esempio Modello di magazzino atomico.
    3. Nel browser URL, è possibile trovare l'id della risorsa tra le stringhe "/asset/" e "?context=icp4data". Ad esempio, nel seguente URL, l'id è 7948818c-d3b5-4844-bf1b-5cc22f6fe6e1 : https://api.dataplatform.cloud.ibm.com/67ea9e1f-b2d9-423c-ab9e-c234945f9c0b/7948818c-d3b5-4844-bf1b-5cc22f6fe6e1/?context=icp4data
    Per trovare l'id della categoria:
    1. Dal menu principale IBM Cloud Pak for Data espandere Governance e selezionare Categorie.
    2. Andate alla categoria che state utilizzando.
    3. Nel browser URL, l'id del catalogo si trova dopo la stringa "/categories/". Ad esempio, nel seguente URL, l'id è dc559b02-a39a-4132-8832-d42cd51af994 : https://api.dataplatform.cloud.ibm.com/gov/categories/dc559b02-a39a-4132-8832-d42cd51af994
  3. Inserire i valori nel corpo della richiesta.
    Ad esempio:
    Valore Specifica Valore predefinito Descrizione Esempio
    strategia Facoltativo industrymodel_ldm La strategia di assegnazione dei termini da applicare all'asset. industrymodel_ldm
    asset_id Facoltativo Il Modello logico dei dati nel catalogo. L'id dell'asset nel catalogo, per il quale assegnare i Business Terms. 7948818c-d3b5-4844-bf1b-5cc22f6fe6e1
    iD_categoria Facoltativo Il Vocabolario di base dell'acceleratore di conoscenza installato. L'id della categoria da cui ricavare i Business Terms a cui mappare l'asset. Questo includerà automaticamente le sottocategorie della categoria fornita e, per estensione, i loro termini. dc559b02-a39a-4132-8832-d42cd51af994
    ldm_type Facoltativo Il tipo di assegnazioni memorizzate del Modello industriale del Modello logico da usare per le assegnazioni di entità e nomi di colonne ai termini. Il tipo di assegnazioni memorizzate del Modello industriale del Modello logico da utilizzare per l'assegnazione dei nomi di entità/colonne ai termini. bfmdw_awm
    metodo_di_matching_termini Facoltativo È supportato solo il metodo di corrispondenza dei termini, artifact_id (id). È supportato solo il metodo di corrispondenza dei termini, artifact_id (id). id
    catalogo_id Obbligatorio L'id del catalogo che contiene l'asset a cui si desidera assegnare i termini commerciali. L'id del catalogo che contiene l'asset a cui si desidera assegnare i termini commerciali. Fornire un ID catalogo o un ID progetto, ma non più di uno. 67ea9e1f-b2d9-423c-ab9e-c234945f9c0b
  4. Nella risposta, prendere nota di "process_id", che può essere utilizzato per verificare lo stato del lavoro di importazione nella sezione successiva, Verifica dello stato del processo di assegnazione dei termini. Potrebbe essere necessario o auspicabile effettuare questo controllo, poiché il processo di assegnazione può richiedere del tempo, a seconda del numero e delle dimensioni degli asset del modello logico dei dati e dei termini del glossario importati.

Controllo dello stato del processo di assegnazione del termine

Per monitorare l'avanzamento dell'assegnazione dei termini aziendali alle risorse del modello di dati logici, richiamare l'endpoint Gets the status of assigning terms to the asset API, dove {process_id} è il valore di Assigning terms to logical data model assets.

Vedi https://cloud.ibm.com/apidocs/watson-data-api-cpd#get-mappings-added

Copia in un progetto

È anche possibile aggiungere gli artefatti di Knowledge Accelerators come file CSV in un progetto Cloud Pak for Data, utilizzando l'endpoint API Copy Knowledge Accelerator items into project.

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

Suggerimento: È possibile scaricare i file CSV localmente e importare il contenuto con l'interfaccia utente. Per ulteriori informazioni, vedere https://cloud.ibm.com/apidocs/knowledge-catalog#copy-ka-into-ikc.