Exportation d'artefacts de gouvernance d'une catégorie

Vous pouvez exporter un type d'artefact de gouvernance à la fois à partir d'une catégorie ou à partir d'une catégorie et de ses sous-catégories. Seuls les artefacts ayant une relation principale avec la catégorie ou ses sous-catégories sont exportés.

Autorisations requises

Vous devez être un collaborateur avec au moins le rôle Afficheur dans une catégorie pour l'exporter, ou avec un rôle personnalisé avec le droit d'exporter un type d'artefact.

Pour exporter un type d'artefact de gouvernance à partir d'une catégorie :

1. Choisissez Gouvernance > Catégories.

2. Cliquez sur le nom d'une catégorie pour ouvrir celle-ci.

3. Cliquez sur Exporter.

4. Sélectionnez le type d'artefact de gouvernance à exporter.

   Vous pouvez exporter jusqu'à 400 artefacts de gouvernance par type.

5. Facultatif. Choisissez d'exporter des artefacts à partir des sous-catégories de la catégorie en cours.

   Lorsque vous choisissez d'exporter des sous-catégories, vous avez également la possibilité d'inclure la catégorie en cours dans l'exportation. Par défaut, la catégorie en cours n'est pas incluse. Pour exporter la hiérarchie de catégories complète (la catégorie et toutes les sous-catégories de l'arborescence), cochez les deux cases. Pour exporter toutes les catégories racine à la fois, voir Importation ou exportation de catégories.

6. Cliquez sur Exporter.

Un fichier CSV est téléchargé sur votre ordinateur. Le fichier d'exportation possède la même structure qu'un fichier d'importation. Voir Format d'un fichier CSV d'importation. Si vous exportez la catégorie par défaut du système [sans catégorie], le fichier CSV exporté ne contient pas de nom de catégorie pour le type d'artefact de gouvernance sélectionné.

Exportation simultanée de tous les artefacts de gouvernance d'un type donné

Avec l'API REST, vous pouvez exporter jusqu'à 400 artefacts de gouvernance d'un type sélectionné. Soumettez une demande GET /v3/governance_artifact_types/{artifact_type}/export. Remplacez {artifact_type} par le type d'artefact que vous souhaitez exporter. Pour exporter des artefacts du type sélectionné dans toutes les catégories, laissez la zone category_id vide. Pour plus d'information, voir la documentation d'API.

Autorisations requises

Vous devez être un collaborateur avec au moins le rôle Afficheur sur toutes les catégories, ou avec un rôle personnalisé avec le droit d'exporter un type d'artefact.

Exportation de tous les artefacts de gouvernance dans un fichier ZIP

Vous pouvez exporter tous les artefacts de gouvernance dans un même fichier ZIP avec l'API REST. Ce type d'exportation permet de déplacer tous les artefacts de gouvernance d'une instance de service IBM Knowledge Catalog vers une autre. Le fichier ZIP contient un dossier pour chaque type d'artefact et chaque dossier contient un fichier CSV avec les artefacts. Vous pouvez exporter tous les types d'artefact ou seulement des types sélectionnés. Le nombre maximum d'artefacts de gouvernance que vous pouvez exporter est de 400. Cette méthode permet également d'exporter et d'importer des collaborateurs de catégorie avec leurs rôles de catégorie.

Soumettez une demande GET /v3/governance_artifact_types/export. Dans la zone artifact_id_mode , laissez la valeur par défaut always, car les valeurs d'ID d'artefact sont requises pour l'importation. Pour plus d'information, voir la documentation d'API.

Autorisations requises

• Vous devez avoir un rôle de service Gestionnaire.

Remarques relatives à la sécurité

Les données de gouvernance exportées dans des fichiers CSV sont assainies contre les attaques par injection CSV connues, afin d'être sûres pour les tableurs qui interprètent automatiquement les données CSV. Par conséquent, toute valeur texte commençant par l'un des caractères suivants:

• est égal à (=)
• plus (+)
• moins (-)
• à (@)

sont précédés d'une apostrophe ('). Pour rendre la fonctionnalité cohérente, les fichiers CSV importés sont également analysés pour supprimer automatiquement le guillemet simple ('). L'assainissement s'applique également lors de l'importation et de l'exportation d'artefacts de gouvernance dans des fichiers ZIP, car ils contiennent des fichiers CSV.

Pour désactiver cette fonctionnalité:

1. Modifier le glossaire IBM Knowledge Catalog Déploiement de services :

   oc edit deployment wkc-glossary-service
   

2. Définissez la variable d'environnement ESCAPE_FORMULAS_IN_CSV_FILES sur la valeur false.

Pour plus d'informations, voir Injection CSV.

En savoir plus

• Importation d'artefacts de gouvernance
• Importation ou exportation de catégories
• IBM Knowledge Catalog API

Rubrique parent : Gestion des artefacts de gouvernance