Prerequisiti

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

Modifica del contenuto del file ZIP

Il file ZIP esportato contiene una cartella separata per ogni tipo di artefatto con un file CSV che contiene quel tipo di manufatto.

È possibile modificare manualmente il contenuto del file ZIP esportato. Seguire queste indicazioni:

• Non creare cartelle aggiuntive, ad esempio una cartella principale.
• Non modificare i nomi della cartella. Le cartelle per ogni tipo di artefatto nel file ZIP devono avere i seguenti nomi: category, classification, data_class, glossary_term, policy, rulee reference_data.
• Mantenere il formato corretto di ogni file CSV. Vedere formato file CSV per l'importazione di artefatti di governance.
• Non rimuovere o rinominare la colonna Artifact ID in ogni file CSV. Questa colonna specifica l'identificativo del manufatto in aggiunta al nome dell'artefatto.
• Definire una relazione tra due artefatti di governance per uno solo degli artefatti. Esistono due eccezioni:
  1. La relazione è tra una politica e una regola di governance. In questo caso, definire la relazione per entrambi i manufatti in entrambi i file CSV. Nel file CSV con le policy, aggiungere la relazione nella colonna Rule . Nel file CSV con regole di governance, aggiungere la relazione nella colonna Parent Policies .
  2. Si sta utilizzando l'opzione di unione all . In questo caso, è necessario assicurarsi che tutto il contenuto CSV sia congruente per quanto riguarda le relazioni tra le risorse utente. Ad esempio, se il file di importazione ZIP contiene sia un termine che una classe di dati collegati con una relazione, questa relazione deve essere presente in entrambe le classi di dati CSV e CSV. In caso contrario, il comportamento dell'importazione della relazione è imprevedibile, la relazione può essere importata o meno.

Preparazione all'importazione di un file ZIP

Prima di importare un file ZIP è necessario completare le seguenti attività:

• Eseguire l'azione appropriata per evitare artefatti predefiniti duplicati
• Crea qualsiasi proprietà e relazioni personalizzate

opzioni di unione

Le seguenti opzioni di unione sono disponibili quando si esegue l'importazione ZIP:

all

Sostituire tutti i valori. I valori importati sostituiscono i valori esistenti in un catalogo.

specified

Sostituisci con valori definiti. I valori importati non vuoti sostituiscono i valori esistenti in un catalogo.

empty

Sostituire i valori vuoti. I valori importati sostituiscono solo i valori vuoti in un catalogo.

specified viene utilizzato come valore predefinito.

Quando si importano file che contengono valori di dati di riferimento, è necessario utilizzare sempre merge_option=all.

Per ulteriori informazioni sulle opzioni di unione, consultare Metodi per l'unione di risorse utente importate ed esistenti

Importazione di un file ZIP

Per importare un file ZIP di manufatti di governance:

1. Se necessario, eliminare i manufatti predefiniti esistenti o modificare le relazioni su manufatti predefiniti. Consultare Preparazione all'importazione di un file ZIP.
2. Inoltrare la richiesta POST /v3/governance_artifact_types/import . Includere l'opzione di unione e il percorso al file ZIP. Consultare la documentazione di API: i valori di importazione dal file ZIP specificato. Tutti i manufatti vengono pubblicati immediatamente senza flusso di lavoro.
3. Quando il processo di importazione è completo, aggiungere altri collaboratori alle nuove categorie. Consultare Gestione collaboratori di categoria.

È necessario attendere che il processo di importazione si completa, oppure si ripulisce il processo in stallo, prima di poter avviare un nuovo processo di importazione.

Monitoraggio del processo di importazione

Dopo aver inoltrato la richiesta di importazione del file ZIP, viene fornito un ID di processo nella risposta (parametroprocess_id ). È possibile utilizzare l'ID di processo per verificare lo stato dell'importazione. Inoltrare una richiesta GET /v3/governance_artifact_types/import/status/{process_id} per interrogare lo stato di importazione. Vedere la documentazione dell'API: Stato dell'importazione.

Pulizia di un processo di importazione in stallo

Sperimentale Si tratta di un rilascio sperimentale e non è ancora supportato per l'utilizzo negli ambienti di produzione.

Se le bancarelle di importazione, è possibile ripulire il processo di importazione e quindi importare nuovamente il file ZIP. Non è possibile avviare un nuovo processo di importazione fino a quando il precedente non si completa o si pulisce il processo in stallo. Tutti i processi di importazione vengono puliti automaticamente dopo 24 ore di inattività.

È possibile verificare lo stato del processo di importazione inoltrando una richiesta GET /v3/governance_artifact_types/import/status/{process_id} . Il processo è in stallo se lo stato è IN_PROGRESS, ma i manufatti non vengono importati.

Per ripulire un processo di importazione in stallo o non riuscito, inoltrare la richiesta POST /v3/governance_artifact_types/import/cleanup/{process_id} .

Vedere la documentazione dell'API: Pulire il processo di importazione ZIP.

Ulteriori informazioni

• Importazione di manufatti di governance con file CSV

• Esportare tutti gli artefatti di governance in un file ZIP

• Risoluzione dei problemi di importazione delle risorse di governance

• Documentazione API: Valori di importazione dal file ZIP specificato

Argomento principale: Metodi di importazione per i manufatti di governance