Prerequisiti

Prima di importare artefatti di governance con un file CSV, creare il file con il formato corretto e assicurarsi di avere le autorizzazioni richieste.

Preparazione all'importazione di artefatti di governance

Prima di poter importare manufatti di governance, tutte le categorie e le sottocategorie elencate nel file di importazione per tali manufatti devono esistere. In caso contrario, i manufatti con categorie non definite non vengono importati. Per ulteriori informazioni, consultare Risoluzione dei problemi di importazione delle risorse di governance.

Prima di poter importare un file CSV con definizioni di categoria, le categorie di livello superiore devono esistere, a meno che non le definirete nel file.

Per creare le categorie richieste è possibile utilizzare uno di questi metodi:

• Creare le categorie attraverso la UI. Consultare Gestione delle categorie.
• Importare le categorie con un file CSV, tramite la UI o con una richiesta API.

I tuoi file di importazione possono includere relazioni ad altri tipi di artefatti di governance che non hai ancora importato. Vengono creati i manufatti definiti nel file. Tuttavia, le relazioni con gli artefatti che non esistono non vengono create e si riceve un messaggio di errore. È possibile aggiungere le relazioni importando nuovamente i file che hanno ricevuto errori dopo l'importazione e la pubblicazione degli altri tipi di artefatti di governance.

Importazione di un file CSV attraverso la UI

Per importare un file CSV attraverso la UI:

1. Se necessario, creare categorie. Consultare Preparazione all'importazione di artefatti di governance.
2. Dal menu di navigazione, aprire la sezione Governance e selezionare Categorie, Termini di business, Classifiche, classi di dati, Dati di riferimento, Normativeo Regole.
3. Clicca su Aggiungi artifact - tipo > Importa da file. Se il pulsante è disabilitato, accertarsi di disporre delle autorizzazioni richieste.
4. Aggiungi il tuo file CSV.
5. Impostare il metodo di unione per risolvere i conflitti con eventuali manufatti esistenti:
   • Sostituisci tutti i valori
   • Sostituire con valori definiti
   • Sostituisci valori vuoti Per le nuove risorse utente, ciascuno di questi metodi produce gli stessi risultati.
6. Fare clic su Importa. Il processo di importazione viene eseguito in modo asincrono. Se si lascia aperta la finestra di importazione, è possibile visualizzare i risultati dell'importazione. In caso contrario, è possibile chiudere la finestra di importazione per continuare a funzionare. Tuttavia, non viene notificato quando l'importazione è completa e non è possibile accedere ai risultati di importazione.
7. Quando il processo di importazione è completo, finisci i tuoi manufatti e le categorie.

Importazione di file CSV con richiesta API

Nella richiesta API è possibile specificare di eseguire processi di importazione paralleli o impostare la specifica del tipo di contenuto in una codifica diversa rispetto a UTF-8.

Per importare un file CSV utilizzando l'API REST:

1. Se necessario, creare categorie. Consultare Preparazione all'importazione di artefatti di governance.
2. Invia una richiesta POST /v3/governance_artifact_types/{artifact_type}/import . Impostare i parametri della query:
   1. Impostare il parametro opzione di unione per risolvere i conflitti con i manufatti esistenti:
      • all: Sostituisci tutti i valori.
      • specified: Sostituisci con valori definiti
      • empty: Sostituisci valori vuoti
   2. Facoltativo. Impostare il parametro async_mode su true se si desidera eseguire più processi di importazione in parallelo.
   3. Se necessario, includere le informazioni di codifica nella richiesta API. Consultare Importante file CSV con codifica diversa da UTF-8. Vedere la documentazione API: Importazione di valori da un file CSV specificato. Dopo che la richiesta viene inoltrata, viene fornito un ID di processo nella risposta (parametroprocess_id ).
3. Facoltativo. È possibile utilizzare l'ID di processo fornito nella risposta per verificare lo stato dell'importazione. Inoltrare una richiesta GET /v3/governance_artifact_types/import/status/{process_id} per restituire lo stato del processo di importazione. Vedere la documentazione dell'API: Stato dell'importazione.
4. Quando il processo di importazione è completo, finisci i tuoi manufatti e le categorie.

curl -X POST "https://{server}:{port}/v3/governance_artifact_types/{artifact_type}/import?merge_option={merge_option}" -H "accept: application/json" -H "Authorization: $AUTHORIZATION_HEADER" -H "content-type: multipart/form-data" -F "file=@\"./import_glossary.csv\";type=text/csv;charset=windows-1250" -k

Finitura dei tuoi manufatti e categorie

Gli artefatti di governance nel tuo file CSV sono importati come bozze e soggetti a flusso di lavoro. I progetti di artefatti devono seguire il flusso di lavoro per quel tipo di manufatto di governance. È possibile visualizzare i progetti di artefatti di governance nella scheda Bozza per il rispettivo tipo di artefatto, ad esempio i termini aziendali.

Per terminare i tuoi manufatti importati:

1. Dopo aver importato tutti i tipi di manufatti, pubblicare tutte le bozze di manufatti. Vai alla tua Task inbox e avvia il processo di pubblicazione. Devi avere il permesso di pubblicare i manufatti. Vedere Flussi di lavoro per i manufatti di governance.
2. Se necessario, rieseguire l'importazione per i file che hanno ricevuto errori di relazione con il metodo di unione Sostituisci tutti i valori . Poi, pubblicare i manufatti aggiornati.

Le categorie che si importano vengono pubblicate immediatamente perché le categorie non sono soggette al flusso di lavoro. Le categorie importate hanno i seguenti collaboratori:

• Sei un collaboratore in tutte le categorie che importano, con il ruolo Proprietario .
• Se si importano nuove categorie di primo livello, si è l'unico collaboratore.
• Se si importano sottocategorie a categorie esistenti, le nuove sottocategorie ereditano tutti i collaboratori dalle loro categorie di livello superiore.

Per ulteriori informazioni, consultare Risoluzione dei problemi di importazione delle risorse di governance.

Per terminare le tue categorie importate, aggiungete altri collaboratori alle nuove categorie. Se si aggiunge il gruppo Accesso pubblico a una categoria importata, ha il ruolo di categoria Editor assegnato per impostazione predefinita, invece del ruolo Viewer , assegnato a questo gruppo quando si creano manualmente categorie.

Consultare Gestione collaboratori di categoria.

Ulteriori informazioni

• Formato file CSV per l'importazione di manufatti di governance

Argomento principale: Metodi di importazione per i manufatti di governance