Prérequis

Avant d'importer des artefacts de gouvernance avec un fichier CSV, créez le fichier au format correct et vérifiez que vous disposez des droits requis.

Préparation de l'importation des artefacts de gouvernance

Pour que vous puissiez importer des artefacts de gouvernance, toutes les catégories et sous-catégories qui sont répertoriées dans le fichier d'importation pour ces artefacts doivent exister. Sinon, les artefacts avec des catégories non définies ne sont pas importés. Pour plus d'informations, voir Résolution des problèmes d'importation d'artefacts de gouvernance.

Pour pouvoir importer un fichier CSV avec des définitions de catégorie, les catégories de niveau supérieur doivent exister, sauf si vous les définissez dans le fichier.

Pour créer les catégories requises, vous pouvez utiliser l'une des méthodes suivantes:

• Créez les catégories via l'interface utilisateur. Voir Gestion des catégories.
• Importez les catégories avec un fichier CSV, via l'interface utilisateur ou avec une demande d'API.

Vos fichiers d'importation peuvent inclure des relations à d'autres types d'artefacts de gouvernance que vous n'avez pas encore importés. Les artefacts définis dans le fichier sont créés. Toutefois, les relations aux artefacts qui n'existent pas ne sont pas créées et vous recevez un message d'erreur. Vous pouvez ajouter les relations en important à nouveau les fichiers qui ont reçu des erreurs après l'importation et la publication des autres types d'artefacts de gouvernance.

Importation d'un fichier CSV via l'interface utilisateur

Pour importer un fichier CSV via l'interface utilisateur:

1. Si nécessaire, créez des catégories. Voir Préparation à l'importation d'artefacts de gouvernance.
2. Dans le menu de navigation, ouvrez la section Gouvernance et sélectionnez Catégories, Termes métier, Classifications, Classes de données, Données de référence, Stratégiesou Règles.
3. Cliquez sur Ajouter un type d'artefact > Importer à partir d'un fichier. Si le bouton est désactivé, vérifiez que vous disposez des droits requis.
4. Ajoutez votre fichier CSV.
5. Définissez la méthode de fusion pour résoudre les conflits avec les artefacts existants:
   • Remplacer toutes les valeurs
   • Remplacer par les valeurs définies
   • Remplacer les valeurs vides Pour les nouveaux artefacts, chacune de ces méthodes produit les mêmes résultats.
6. Cliquez sur Import. Le processus d'importation s'exécute de manière asynchrone. Si vous laissez la fenêtre d'importation ouverte, vous pouvez afficher les résultats de l'importation. Sinon, vous pouvez fermer la fenêtre d'importation pour continuer à travailler. Toutefois, vous n'êtes pas averti lorsque l'importation est terminée et vous ne pouvez pas accéder aux résultats de l'importation.
7. Une fois le processus d'importation terminé, terminez vos artefacts et vos catégories.

Importation de fichiers CSV avec une demande d'API

Dans la demande d'API, vous pouvez spécifier d'exécuter des processus d'importation parallèles ou définir la spécification de type de contenu sur un codage différent de UTF-8.

Pour importer un fichier CSV à l'aide de l'API REST:

1. Si nécessaire, créez des catégories. Voir Préparation à l'importation d'artefacts de gouvernance.
2. Soumettez une demande POST /v3/governance_artifact_types/{artifact_type}/import. Définissez les paramètres de requête:
   1. Définissez le paramètre merge option pour résoudre les conflits avec les artefacts existants:
      • all: Remplacez toutes les valeurs.
      • specified: Remplacer par les valeurs définies
      • empty: Remplacer les valeurs vides
   2. Facultatif. Définissez le paramètre async_mode sur true si vous souhaitez exécuter plusieurs processus d'importation en parallèle.
   3. Si nécessaire, incluez les informations de codage dans la demande d'API. Voir Importation de fichiers CSV avec un codage autre que UTF-8. Voir la documentation de l'API : Importer des valeurs à partir d'un fichier CSV spécifié. Une fois la demande soumise, un ID de processus est fourni dans la réponse (paramètreId_processus ).
3. Facultatif. Vous pouvez utiliser l'ID de processus fourni dans la réponse pour vérifier le statut de l'importation. Soumettez une demande GET /v3/governance_artifact_types/import/status/{process_id} pour renvoyer le statut du processus d'importation. Voir la documentation de l'API : Statut de l'importation.
4. Une fois le processus d'importation terminé, terminez vos artefacts et vos catégories.

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

Finalisation de vos artefacts et de vos catégories

Les artefacts de gouvernance de votre fichier CSV sont importés en tant que brouillons et soumis à un flux de travaux. Les brouillons d'artefact doivent suivre le flux de travaux pour ce type d'artefact de gouvernance. Vous pouvez afficher les brouillons d'artefacts de gouvernance dans l'onglet Brouillon pour le type d'artefact respectif, par exemple, les termes métier.

Pour terminer vos artefacts importés:

1. Après avoir importé tous les types d'artefact, publiez tous les brouillons d'artefact. Accédez à votre boîte de réception des tâches et démarrez le processus de publication. Vous devez disposer des droits permettant de publier les artefacts. Voir Flux de travaux pour les artefacts de gouvernance.
2. Si nécessaire, réexécutez l'importation pour les fichiers qui ont reçu des erreurs de relation avec la méthode de fusion Remplacer toutes les valeurs . Ensuite, publiez les artefacts mis à jour.

Toutes les catégories que vous importez sont publiées immédiatement car elles ne sont pas soumises à un flux de travaux. Les catégories importées ont les collaborateurs suivants:

• Vous êtes un collaborateur dans toutes les catégories que vous importez, avec le rôle Propriétaire .
• Si vous importez de nouvelles catégories de niveau supérieur, vous êtes le seul collaborateur.
• Si vous importez des sous-catégories dans des catégories existantes, les nouvelles sous-catégories héritent de tous les collaborateurs de leurs catégories de niveau supérieur.

Pour plus d'informations, voir Résolution des problèmes d'importation d'artefacts de gouvernance.

Pour terminer vos catégories importées, ajoutez d'autres collaborateurs aux nouvelles catégories. Si vous ajoutez le groupe Accès public à une catégorie importée, le rôle de catégorie Editeur lui est affecté par défaut, à la place du rôle Afficheur , qui est affecté à ce groupe lorsque vous créez manuellement des catégories.

Voir Gestion des collaborateurs de catégorie.

En savoir plus

• Format de fichier CSV pour l'importation d'artefacts de gouvernance

Rubrique parent: Importation de méthodes pour les artefacts de gouvernance