Risolvere i problemi che si possono incontrare quando si importano gli artefatti di governance con IBM Knowledge Catalog.
- I nomi delle colonne non sono corretti
- Le relazioni con risorse non esistenti vengono ignorate
- La categoria non esiste
- Impossibile trovare le risorse utente dopo l'importazione CSV
- Impossibile trovare le risorse dopo l'importazione ZIP
- Il processo di importazione ZIP crea risorse utente duplicate
- Mancano le relazioni con le classi di dati predefinite e le classificazioni importate da ZIP
I nomi delle colonne non sono corretti
Descrizione problema
L'importazione ha esito negativo con l'errore che un nome colonna non è valido per questo tipo di risorsa utente o che manca una colonna obbligatoria, ma in realtà tutte le colonne nel file sono denominate correttamente e nessuna delle colonne obbligatorie è mancante.
Soluzione temporanea
Le intestazioni potrebbero contenere alcuni caratteri di spazio che non sono visibili nel foglio di calcolo o anche nell'editor di testo. Il carattere spazio impedisce il riconoscimento del nome della colonna.
- Modificare il file con un editor che mostra i caratteri spazio.
- Provare a eliminare le intestazioni e immetterne i nomi manualmente da zero.
- Verificare se la codifica del file è UTF-8e non, ad esempio, UTF-8 BOM.
Le relazioni con risorse utente non esistenti vengono ignorate
Descrizione problema
Quando si definisce un qualsiasi tipo di relazione tra due risorse utente, il processo di importazione ha esito positivo, ma le relazioni con risorse utente non esistenti vengono ignorate. Le relazioni ignorate generano errori simili a questo:
GIM00015E: Artifact Average balance in column Related Terms is not found in the specified hierarchy.
Soluzione temporanea
Se si intende importare più tipi di risorse utente che hanno relazioni tra loro, prima importare tutte le risorse utente, pubblicare le risorse utente importate e quindi importare nuovamente gli stessi file CSV, con il metodo di unione Sostituisci tutti i valori . Il secondo processo di importazione aggiunge le relazioni alle risorse esistenti.
La categoria non esiste
Descrizione problema
Se una categoria principale per una risorsa utente non è definita nel file CVS, le risorse utente vengono importate nella categoria [ senza categoria] per impostazione predefinita. Se una categoria principale per una risorsa utente è definita nel file CSV, ma non esiste nell'ambiente, l'importazione ha esito negativo. Il processo di importazione crea sempre un solo tipo di risorsa utente per importazione. Quando si importano risorse utente diverse dalle categorie, non è possibile creare la categoria principale.
Soluzione temporanea
Prima di importare le risorse utente da un file CSV, assicurarsi che le categorie che si desidera importare siano presenti nell'ambiente. Crearli prima di iniziare il processo d'importazione.
Impossibile trovare le risorse utente dopo l'importazione CSV
Descrizione problema
Le risorse importate dai file CSV non sono visibili nelle pagine Pubblicate.
Soluzione temporanea
È necessario pubblicare le risorse utente prima che vengano visualizzate come Pubblicate e siano disponibili per l'utilizzo. Se le risorse utente si trovano nelle categorie importate, potrebbe essere necessario aggiungere utenti come collaboratori a tali categorie.
Impossibile trovare le risorse utente dopo l'importazione ZIP
Descrizione problema
Le risorse importate dai file ZIP non sono visibili nell'interfaccia utente ma sono disponibili nelle chiamate API.
Soluzione temporanea
È possibile che il servizio wkc-search
non fosse in uno stato ready
durante l'importazione ZIP. Per risolvere il problema, risincronizzare con il seguente comando:
curl -X GET "$CPD_URL/v3/glossary_terms/admin/resync?artifact_type=all" -k -H "accept: application/json" -H "Authorization: Bearer $TOKEN"
Il processo di importazione ZIP crea risorse utente duplicate
Descrizione problema
Le risorse utente nei file ZIP esportati sono identificate con identificatori di risorse utente nella colonna Artifact ID
, invece che dal nome della risorsa utente e dal percorso della categoria. Tuttavia, gli identificatori degli artefatti per i termini aziendali predefiniti, le classi di dati e le classificazioni differiscono tra ogni istanza di IBM Knowledge Catalog. Pertanto, le risorse utente predefinite importate non vengono riconosciute come uguali alle risorse utente predefinite. Pertanto, il processo di importazione crea risorse utente duplicate.
Soluzione temporanea
Eliminare gli artefatti predefiniti esistenti dall'istanza IBM Knowledge Catalog di destinazione prima di importare gli artefatti. Consultare Eliminazione di risorse pubblicate dello stesso tipo.
Per classi di dati e classificazioni predefinite:
- Escludere la categoria [ uncategorized] quando si crea il file ZIP esportando le risorse utente.
- Modificare i file CSV per le classi di dati e le classificazioni e sostituire gli identificativi delle risorse utente per le classi di dati e le classificazioni predefinite nelle colonne Classificazione principale e Classe di dati principale con i percorsi delle categorie e i nomi delle risorse utente predefiniti equivalenti.
- Modificare i file CSV per altre risorse utente e sostituire gli identificativi delle risorse utente per le classi di dati e le classificazioni predefinite con i nomi delle risorse utente predefiniti equivalenti e i percorsi delle categorie nelle colonne Classificazioni e Classi di dati , per tutte le risorse utente che hanno relazioni con le risorse utente predefinite.
Quando si importano le risorse utente, vengono create relazioni con le risorse utente predefinite di destinazione esistenti.
Per i termini di business predefiniti:
- Escludere la categoria Knowledge Accelerator Sample Personal Data quando si crea il file ZIP esportando le risorse utente.
- Modificare i file CSV per le risorse di business termsa e altre risorse utente e sostituire gli identificativi delle risorse utente per i termini di business predefiniti con i percorsi di categoria e i nomi delle risorse utente predefiniti equivalenti nella colonna Termini correlati e in tutte le altre colonne che definiscono le relazioni dei termini di business.
Quando si importano le risorse utente, vengono create relazioni con le risorse utente predefinite di destinazione esistenti.
I set di dati di riferimento predefiniti nella categoria Luoghi hanno gli stessi valori di ID artefatto in tutte le istanze di IBM Knowledge Catalog, non è necessario un workaround.
Mancano le relazioni con le classi di dati e le classificazioni predefinite importate da ZIP
Descrizione problema
Le proprietà personalizzate e i valori di relazione non vengono importati.
Soluzione temporanea
Modificare i file CSV e modificare i valori per le classificazioni e le classi di dati predefinite correlate dagli ID risorsa utente ai nomi risorsa utente e ai percorsi categoria, quindi reimportare.
Argomento principale: Risoluzione dei problemi del IBM Knowledge Catalog