CSV format de fichier pour l'importation d'artefacts de gouvernance

Le fichier CSV utilisé pour importer un seul type d'artefacts de gouvernance doit respecter certaines règles de formatage.

Règles générales de mise en forme
Règles de mise en forme des colonnes

Règles générales de mise en forme

Le fichier « CSV » doit respecter le format commun et le type MIME des fichiers de valeurs séparées par des virgules ( CSV ).

Le fichier CSV se compose d'une ligne d'en-tête qui nomme les colonnes et de plusieurs lignes de valeurs séparées par des virgules.

Restrictions

La taille maximale recommandée pour le fichier d'importation CSV est de 50 Mo.

Ligne d'en-tête

La ligne d'en-tête du fichier CSV indique les propriétés importées pour les artefacts.

Suivez ces directives pour la ligne d'en-tête :

La ligne d'en-tête doit être la première ligne du fichier et ne doit pas être répétée.
Séparez les noms de colonnes par une virgule. Si vous créez le fichier dans un tableur, les virgules sont ajoutées automatiquement lorsque vous enregistrez le fichier au format CSV.
La ligne d'en-tête doit inclure les colonnes obligatoires pour le type d'artefact.
Vous pouvez omettre toutes les colonnes facultatives.
Utilisez les noms de colonnes exacts dans la ligne d'en-tête, à l'exception des colonnes de propriétés personnalisées et de relations personnalisées. Certaines colonnes ont des noms alternatifs. Les noms des colonnes sont sensibles à la casse.
Assurez-vous que les noms des colonnes ne contiennent pas d'espaces supplémentaires. Des espaces blancs peuvent être ajoutés par un tableur ou un éditeur de texte, mais ne sont pas visibles. Si vous recevez une erreur d'importation indiquant que les noms des colonnes sont incorrects, même si vos colonnes sont orthographiées et mises en majuscules correctement, vérifiez s'il y a des espaces blancs. Pour plus d'informations, consultez la section Résolution des problèmes d'importation des artefacts de gouvernance.

Délimiteurs de colonnes

Pour délimiter les valeurs des différentes colonnes, utilisez une virgule. Si vous créez le fichier dans un tableur, les virgules sont ajoutées automatiquement lorsque vous enregistrez le fichier au format CSV.

Pour omettre une valeur dans une colonne, utilisez une virgule directement après la virgule précédente, sans aucun autre caractère. Par exemple, deux virgules consécutives indiquent que la deuxième colonne est vide.

Pour inclure une virgule dans une valeur, placez la valeur entre guillemets doubles. Par exemple, pour importer une valeur de test, utilisez le format suivant :

"test,"

Chemins de catégorie

Vous devez spécifier le chemin d'accès complet aux catégories et aux relations avec les artefacts. Si vous ne précisez pas la catégorie, la catégorie par défaut est [non classé].

Pour délimiter le chemin d'accès à la catégorie, utilisez deux symboles « supérieur à » (>>) entre chaque niveau de la hiérarchie des catégories et entre le chemin d'accès à la catégorie et le nom de l'artefact.

Format des champs Catégorie et Sous-catégorie

Dans les champs Catégorie ou Catégories secondaires, indiquez la hiérarchie des catégories, depuis le nom de la catégorie de niveau supérieur jusqu'au nom de la catégorie finale, en séparant chacune d'elles par les symboles >>. Par exemple, pour créer une catégorie de troisième niveau, votre champ Catégorie pourrait ressembler à ceci :

myCategory1 >> myCategory2 >> myCategory3

Pour spécifier la catégorie [non classée] dans le champ Catégorie, laissez le champ vide. Vous ne pouvez pas spécifier la catégorie [non classée] comme catégorie secondaire et elle ne peut pas avoir de sous-catégories.

Pour spécifier un artefact associé, tel que Classification, Termes associés, Partie des termes, indiquez le chemin d'accès complet à la catégorie et le nom de l'artefact, en les séparant par les symboles >>.

Par exemple, pour spécifier un terme associé qui appartient à une catégorie principale de troisième niveau, votre champ Termes associés pourrait ressembler à ceci :

myCategory1 >> myCategory2 >> myCategory3 >> artifactName

Pour les artefacts qui se trouvent dans la catégorie [non classés], omettez le chemin d'accès à la catégorie. Vous pouvez éventuellement inclure le délimiteur avant le nom de l'artefact. Utilisez l'un des formats suivants pour ajouter une relation à une classe de données ou une classification prédéfinie dans la catégorie [non classé] :

>> artifactName
artifactName

Valeurs des propriétés des artefacts

Les valeurs des propriétés des artefacts de gouvernance que vous importez sont sensibles à la casse. Par exemple, les balises number et NUMBER sont traitées comme deux étiquettes distinctes, et non comme une seule.

Valeurs multiples pour une propriété

Vous ne pouvez saisir qu'une seule valeur dans chaque champ. Pour inclure plusieurs valeurs pour une propriété, telles que des balises, des stewards ou des termes associés, ajoutez plusieurs lignes pour le même artefact et laissez les autres colonnes vides. Par exemple :

Name,Artifact Type,Category,Tags,Related Terms
businessterm1,glossary_term,myCategory1,tag1,myCategory1 >> rel_term1
,,,tag2,myCategory1 >> rel-term2
businessterm2,glossary_term,myCategory1,tag3,myCategory2 >> rel-term3
,,,tag4,myCategory2 >> rel-term4

Ce fichier contient deux termes métier, chacun comportant deux balises et deux termes associés, qui incluent leurs chemins de catégorie complets.

Relations entre les artefacts

Lorsque vous définissez un type de relation entre deux artefacts, l'artefact associé doit exister, sinon la relation n'est pas créée. Le processus d'importation réussit et les artefacts définis sont créés, mais les relations avec les artefacts inexistants sont ignorées. Les relations ignorées entraînent des erreurs similaires à celle-ci :

GIM00015E: Artifact Average balance in column Related Terms is not found in the specified hierarchy.

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

Cependant, si les deux artefacts sont définis dans le même fichier d' CSV, la relation est alors ajoutée.

Si vous prévoyez d'importer plusieurs types d'artefacts qui ont des relations entre eux, importez d'abord tous les artefacts, publiez les artefacts importés, puis importez à nouveau les mêmes fichiers d' CSV, en utilisant la méthode de fusion Remplacer toutes les valeurs. Les deuxièmes processus d'importation ajoutent les relations aux artefacts existants.

Codage de caractères

Le type de contenu dans la requête http doit être multipart/form-data et le type de fichier doit être text/csv. Par défaut, le codage de caractères UTF-8 est utilisé pour les fichiers CSV. Si votre fichier CSV n'utilise pas UTF-8, vous devez importer le fichier à l'aide d'un appel API et inclure le type d'encodage dans la spécification du type de contenu. Voir Importation de fichiers CSV avec un encodage autre que UTF-8.

Règles de mise en forme des colonnes

Le tableau suivant indique les colonnes prises en charge pour chaque type d'artefact lorsque vous importez des artefacts de gouvernance. L'astérisque (*) indique les champs obligatoires. Utilisez les noms de colonnes répertoriés ou alternatifs dans la ligne d'en-tête, à l'exception des colonnes de propriétés personnalisées et de relations personnalisées.

Nom de colonne	Catégories	Termes métier	Classifications	Classes de données	Jeux de données de référence	Politiques	Règles de gouvernance
Name*	✓	✓	✓	✓	✓	✓	✓
Artifact Type*	✓	✓	✓	✓	✓	✓	✓
Category*	✓	✓	✓	✓	✓	✓	✓
Description	✓	✓	✓	✓	✓	✓	✓
Secondary Categories		✓	✓	✓	✓	✓	✓
Stewards	✓	✓	✓	✓	✓	✓	✓
Steward Groups	✓	✓	✓	✓	✓	✓	✓
Tags	✓	✓	✓	✓	✓	✓	✓
Classifications	✓	✓		✓	✓	✓	✓
Business Start		✓	✓	✓	✓	✓	✓
Business End		✓	✓	✓	✓	✓	✓
Related Terms		✓	✓	✓	✓	✓	✓
Custom property values	✓	✓	✓	✓		✓	✓
Custom relationships	✓	✓		✓		✓	✓
Part of Terms		✓
Type of Terms		✓
Synonyms		✓
Data Classes		✓
Abbreviations		✓
Parent Classification			✓
Parent Data Class				✓
Enabled				✓
Reporting Authorized	✓
Definition				✓
Data Set Type*					✓
Parent Reference Data Sets					✓
Custom Columns					✓
Parent Policy						✓
Parent Policies							✓
Rules						✓	✓
Reference Data Sets							✓

Name (Obligatoire)

Nom alternatif de la colonne: name
Types d'artefact: Catégories, termes commerciaux, classifications, classes de données, ensembles de données de référence, politiques, règles de gouvernance
Description: Le nom de l'artefact.

Le nom d'un artefact de gouvernance est associé à sa catégorie principale, que vous devez inclure dans le champ Catégorie. C'est pourquoi la liste des termes commerciaux, par exemple, peut contenir des termes portant le même nom, mais appartenant à des catégories principales différentes.

Format: Le nom de l'artefact doit être unique pour le type d'artefact dans sa catégorie principale. Les noms sont sensibles à la casse. Par exemple, les noms « Confidential » et « confidential » sont considérés comme des noms différents.

Le nom doit contenir entre 1 et 255 caractères. Un nom ne peut pas contenir de caractères de contrôle Unicode, commencer ou se terminer par un espace blanc, ni contenir le symbole « supérieur à » (>).

Valeur par défaut: Néant. Vous devez fournir une valeur pour le nom de l'artefact.
Exemple: Pour ajouter un terme commercial nommé Blue, spécifiez :

 Name,Artifact Type,Category
 Blue,glossary_term,Colors

Artifact Type (Obligatoire)

Nom alternatif de la colonne: artifact_type
Types d'artefact: Catégories, termes commerciaux, classifications, classes de données, ensembles de données de référence, politiques, règles de gouvernance
Description: Le nom d'un type d'artefact de gouvernance.
Format: Vous ne pouvez importer les données que pour un seul type d'artefact de gouvernance à la fois. Utilisez les valeurs suivantes pour spécifier le type d'artefact :

Tableau 1. Valeurs du type d'artefact
Type d'artefact	Valeur
Termes métier	glossary_term
Catégories	category
Classifications	classification
Classes de données	data_class
Règles de gouvernance	rule
Politiques	policy
Jeux de données de référence	reference_data

Valeur par défaut: Néant. Vous devez fournir un type d'artefact.
Exemple: Pour ajouter un artefact de terme commercial, spécifiez :

 Name,Artifact Type,Category
 Blue,glossary_term,Colors

Category (Obligatoire)

Nom alternatif de la colonne: category
Types d'artefact: Catégories, termes commerciaux, classifications, classes de données, ensembles de données de référence, politiques, règles de gouvernance
Description: La catégorie principale de l'artefact ou la catégorie à créer.
Format: Spécifiez le chemin hiérarchique complet, en commençant par une catégorie de niveau supérieur, par exemple : myCategory1 >> myCategory2 >> myCategory3. Voir Chemins d'accès aux catégories.

À moins que vous n'importiez des catégories, les catégories spécifiées doivent exister. Si vous importez des sous-catégories, les catégories de niveau supérieur doivent exister, sauf si vous les définissez dans le même fichier.

Valeur par défaut: Laissez ce champ vide dans les situations suivantes :

Pour importer les catégories de premier niveau.
Pour ajouter des artefacts importés à la catégorie [non classés].

Exemple: Pour ajouter un terme commercial à la catégorie de niveau supérieur Couleurs, spécifiez :

 Name,Artifact Type,Category
 Blue,glossary_term,Colors

Pour importer une nouvelle catégorie de niveau supérieur, nommée myCategory1, spécifiez :

Name,Artifact Type,Category
myCategory1,category,

Pour ajouter une catégorie, nommée myCategory2, en tant que sous-catégorie d'une catégorie existante, nommée myCategory1, spécifiez :

Name,Artifact Type,Category
myCategory2,category,myCategory1

Pour ajouter une catégorie, nommée myCategory3, dans une hiérarchie de catégories existante de myCategory1 >> myCategory2, spécifiez :

Name,Artifact Type,Category
myCategory3,category,myCategory1 >> myCategory2

Description

Nom alternatif de la colonne: description
Types d'artefact: Catégories, termes commerciaux, classifications, classes de données, ensembles de données de référence, politiques, règles de gouvernance
Description: Une description de l'artefact.
Format: Une description peut contenir jusqu'à 15 000 caractères.

Secondary Categories

Nom alternatif de la colonne: secondary_categories
Types d'artefact: Termes commerciaux, classifications, classes de données, ensembles de données de référence, politiques, règles de gouvernance
Description: Une catégorie secondaire pour un artefact.
Format: La catégorie doit exister. Vous ne pouvez pas spécifier la catégorie [non classée] comme catégorie secondaire. Indiquez le chemin hiérarchique complet, en commençant par une catégorie de niveau supérieur. Voir Chemins d'accès aux catégories.

Pour importer plusieurs catégories secondaires pour un artefact, ajoutez plusieurs lignes pour cet artefact, avec une valeur de catégorie secondaire différente dans chaque ligne.

Stewards

Nom alternatif de la colonne: stewards
Types d'artefact: Catégories, termes commerciaux, classifications, classes de données, ensembles de données de référence, politiques, règles de gouvernance

Pour les catégories, le steward n'est pas affiché dans l'interface utilisateur. Pour vérifier les valeurs, vous pouvez utiliser l'appel de l'API REST GET /v3/categories/{guid}. Pour plus d'informations, consultez la documentation API.

Description: Identifiant utilisateur de la personne responsable de l'artefact.
Format: Identifiant utilisateur composé de valeurs numériques. Si vous disposez de l'autorisation « Administrer la plateforme », vous pouvez consulter les identifiants des utilisateurs sur la page « Gestion des utilisateurs ».

Steward Groups

Types d'artefact: Catégories, termes commerciaux, classifications, classes de données, ensembles de données de référence, politiques, règles de gouvernance
Description: Le groupe d'utilisateurs steward responsable de l'artefact.

Classifications

Nom alternatif de la colonne: classifications
Types d'artefact: Catégories, termes commerciaux, classes de données, ensembles de données de référence, politiques, règles de gouvernance

Pour les catégories, la classification n'est pas affichée dans l'interface utilisateur. Pour vérifier les valeurs, vous pouvez utiliser l'appel de l'API REST GET /v3/categories/{guid}. Pour plus d'informations, consultez la documentation API.

Description: La classification attribuée à l'artefact.
Format: La classification doit exister. Spécifiez la classification avec son chemin hiérarchique complet. Voir Chemins d'accès aux catégories.

Pour importer plusieurs classifications pour un artefact, ajoutez plusieurs lignes pour cet artefact, en indiquant une valeur différente pour chaque classification dans chaque ligne. Notez que la colonne Classifications est prise en charge dans l'importation des catégories, mais qu'elle n'est pas exportée.

Exemple

Name,Artifact Type,Category,Classifications
Account,glossary_term,Insurance >> Business Area >> All Accounts,Insurance >> concept

Business Start

Nom alternatif de la colonne: business_start
Types d'artefact: Termes commerciaux, classifications, classes de données, ensembles de données de référence, politiques, règles de gouvernance
Description: Date à laquelle la version publiée de l'artefact devient effective.

Remarque : avec l'introduction du versionnage des artefacts, la date de début de l'activité fournie dans le fichier d' CSV s d'importation est ignorée.

La date effective de début est fixée comme suit :

Si les brouillons importés sont de nouveaux artefacts (ils ne sont attribués à aucune version publiée), la date de début est automatiquement définie comme date de publication.
Si les artefacts sont réimportés (ils sont liés à des versions publiées), la date de début effective est déjà définie dans la version active existante et reste inchangée après la publication du brouillon importé.

Business End

Nom alternatif de la colonne: business_end
Types d'artefact: Termes commerciaux, classifications, classes de données, ensembles de données de référence, politiques, règles de gouvernance
Description: Date à laquelle la version publiée de l'artefact devient inactive.

Remarque : avec l'introduction du versionnage des artefacts, la date de fin commerciale fournie dans le fichier d' CSV s d'importation est ignorée. Les dates de fin d'activité ne sont à aucun moment définies par l'utilisateur et ne s'appliquent pas aux versions actives. Une version obtient la date de fin effective au moment où elle devient inactive en étant remplacée par une nouvelle version.

Nom alternatif de la colonne: related_terms
Types d'artefact: Termes commerciaux, classifications, classes de données, ensembles de données de référence, politiques, règles de gouvernance
Description: Terme commercial lié à l'artefact.
Format: Le terme commercial doit exister. Spécifiez un terme associé avec son chemin hiérarchique complet. Voir Chemins d'accès aux catégories.

Pour importer plusieurs termes pour un artefact, ajoutez plusieurs lignes pour cet artefact, en indiquant une valeur différente pour chaque terme dans chaque ligne.

Exemple

Name,Artifact Type,Category,Classifications,Related Terms
Account claim tracking,glossary_term,Insurance >> Business Area >> Claim,Insurance >> property,Insurance >> Business Area >> Account >> Account

Valeurs des propriétés personnalisées

Nom de colonne: nom _propriété_personnalisée

Le nom de colonne pour une telle valeur est le nom de la propriété personnalisée précédé du préfixe custom_.

Types d'artefact: Catégories, termes commerciaux, classes de données, politiques, règles de gouvernance
Description: Une valeur pour tout type de propriété personnalisée, à l'exception des propriétés personnalisées de type Relation.
Format: La propriété personnalisée doit exister.
Pour la propriété personnalisée de type USER_GROUP, le format pris en charge est :

« user_id:user », par exemple « 1000330999:user »
« group_id:group », par exemple « 10000:group »

Les utilisateurs et les groupes d'utilisateurs peuvent être définis pour un CP de type USER_GROUP (s'il prend en charge plusieurs valeurs).

Relations personnalisées

Nom de colonne: nom _relation_dirigée_personnalisée

Le nom de colonne d'une relation est le nom de la relation personnalisée précédé du préfixe custom_directed_. Par exemple, custom_directed_Is Analyzed By.

Types d'artefact: Catégories, termes commerciaux, classes de données, classifications, politiques, règles de gouvernance
Description: Propriétés personnalisées de type Relation.
Format: La relation personnalisée et l'artefact cible doivent exister. Vous devez préciser la relation dirigée. La relation inversée est créée automatiquement. Spécifiez la relation personnalisée avec son chemin d'accès complet à la hiérarchie des catégories. Voir Chemins d'accès aux catégories.

Spécifiez les informations au format suivant : contextPath:Type

Part of Terms

Nom alternatif de la colonne: part_of_terms
Types d'artefact: Termes métier
Description: Ajoute une relation partielle entre deux termes commerciaux :

Fait partie de : Spécifie une relation dans laquelle un terme est un composant, une partie, un attribut ou un membre d'un autre terme.
Fait partie de : Spécifie une relation dans laquelle un autre terme est un composant, une partie, un attribut ou un membre du premier terme.

Format: Le terme commercial cible doit exister ou être défini dans le même fichier d' CSV. Dans la ligne correspondant au terme métier qui a une relation « fait partie de », indiquez le terme métier cible. La partie « a » de la relation est ajoutée automatiquement.

Spécifiez une relation entre les pièces à l'aide de leur chemin hiérarchique complet. Voir Chemins d'accès aux catégories. Une relation de partie doit toujours être définie comme une relation « fait partie de ».

Pour importer plusieurs relations pour un terme, ajoutez plusieurs lignes pour ce terme.

Exemple: Par exemple, « taux fixe », « taux mixte » et « taux variable » sont des attributs du terme « taux d'intérêt », qui est lui-même un attribut du terme « prêt immobilier ». Dans ce cas, les termes « Taux fixe », « Taux hybride » et « Taux variable » ont chacun une relation de type « est un type de » avec le terme « Taux d'intérêt ». Le terme « taux d'intérêt » est lié aux termes mentionnés ci-dessus par une relation de « a une relation avec », mais il est également lié au terme « prêt immobilier » par une relation de « est un type de ».

Les lignes correspondant à ces termes ressemblent à cet exemple :

Name,Artifact Type,Category,Description,Tags,Classifications,Stewards,Related Terms,Part of Terms,Abbreviations
Interest Rate,glossary_term,myCategory1,,,,,,myCategory1 >> Home Loan,,
Fixed Rate,glossary_term,myCategory1,,,,,myCategory1 >> Interest Rate,,
Hybrid Rate,glossary_term,myCategory1,,,,,myCategory1 >> Interest Rate,,
Variable Rate,glossary_term,myCategory1,,,,,myCategory1 >> Interest Rate,,

Type of Terms

Nom alternatif de la colonne: type_of_terms
Types d'artefact: Termes métier
Description: Affiche les relations de type :

Est un type de : Spécifie une relation dans laquelle un terme est une instance du concept exprimé par un autre terme généralement plus large.
A un type de : Spécifie une relation dans laquelle le concept exprimé par un terme a un ou plusieurs sous-types exprimés par d'autres termes. Par exemple, le terme « Prêt » peut être défini comme ayant une relation de type « a » avec les termes « Prêt immobilier », « Prêt automobile » et « Prêt étudiant ».

Format: Le terme commercial cible doit exister ou être défini dans le même fichier d' CSV. Dans la ligne correspondant au terme métier ayant une relation de type « Est un type de », indiquez le terme métier cible. Le type « moitié de la relation » est ajouté automatiquement.

Spécifiez une relation de type avec son chemin hiérarchique complet. Voir Chemins d'accès aux catégories. Une relation de type doit toujours être définie comme une relation de type « est un ».

Pour importer plusieurs relations pour un terme, ajoutez plusieurs lignes pour ce terme.

Exemple: Par exemple, le prêt immobilier, le prêt automobile et le prêt étudiant sont des types de prêt différents. Dans ce cas, chacun des termes « prêt immobilier », « prêt automobile » et « prêt étudiant » entretient une relation de type « est un » avec le terme « prêt ». Le terme « Prêt » est lié à ces termes par une relation de type « a ».

Les lignes correspondant à ces termes ressemblent à cet exemple :

Name,Artifact Type,Category,Description,Tags,Classifications,Stewards,Related Terms,Part of Terms,Type of Terms
Home Loan,glossary_term,myCategory1,,,,,,,myCategory1 >> Loan,
Car Loan,glossary_term,myCategory1,,,,,,,myCategory1 >> Loan,
Student Loan,glossary_term,myCategory1,,,,,,,myCategory1 >> Loan,

Synonyms

Nom alternatif de la colonne: synonyms
Types d'artefact: Termes métier
Description: Une relation avec un autre terme commercial ayant la même signification.
Format: Le terme commercial cible doit exister ou être défini dans le même fichier CSV. Spécifiez le synonyme avec son chemin d'accès complet à la hiérarchie des catégories. Voir Chemins d'accès aux catégories.

Pour importer plusieurs synonymes pour un terme, ajoutez plusieurs lignes pour ce terme, en indiquant un synonyme différent dans chaque ligne.

Data Classes

Nom alternatif de la colonne: data_classes
Types d'artefact: Termes métier
Description: Toutes les classes associées à un semestre.
Format: La classe de données doit exister. Spécifiez la classe de données avec son chemin hiérarchique complet. Voir Chemins d'accès aux catégories.

Pour importer plusieurs catégories de données pour un trimestre, ajoutez plusieurs lignes pour ce trimestre, en indiquant une catégorie de données différente dans chaque ligne.

Abbreviations

Nom alternatif de la colonne: abbreviations
Types d'artefact: Termes métier
Description: Forme abrégée du nom commercial de l'entreprise.
Format: Abréviation d'un terme.

Pour importer plusieurs abréviations pour un terme, ajoutez plusieurs lignes pour ce terme, avec une valeur différente pour chaque abréviation dans chaque ligne.

Parent Classification

Nom alternatif de la colonne: parent_classification
Types d'artefact: Classifications
Description: La catégorie principale à laquelle appartient cette classification.
Format: La classification parent doit exister ou être définie dans le même fichier d' CSV. Spécifiez la classification parent avec son chemin d'accès complet à la hiérarchie des catégories. Voir Chemins d'accès aux catégories.

Exemple :

Name,Artifact Type,Category,Parent Classification,Related Terms
financial,classification,Insurance >> Business Area >> Claim,Insurance >> property

Parent Data Class

Nom alternatif de la colonne: parent_data_class
Types d'artefact: Classes de données
Description: Définit la relation au sein d'une hiérarchie de classes de données.
Format: La classe de données parent doit exister ou être définie dans le même fichier d' CSV. Chaque classe de données ne peut avoir qu'une seule classe de données parente. Les classes de données parent et enfant doivent appartenir à la même catégorie. Spécifiez la classe de données parent avec son chemin hiérarchique complet. Voir Chemins d'accès aux catégories.

Exemple :

Name,Artifact Type,Category,Description,Classifications,Related Terms,Parent Data Class
Georgia State Driver's License,data_class,Driver's License >> US License,A string representing a driver license of US state Georgia.,,,Driver's License >> US License >> Southeastern Driver's License

Enabled

Nom alternatif de la colonne: enabled
Types d'artefact: Classes de données
Description: Indique si une classe de données est activée pour la mise en correspondance des données.
Format: Les valeurs admises sont true et false. Cette colonne est facultative, mais si vous l'ajoutez, elle doit contenir une valeur pour chaque classe de données dans le fichier CSV.

Reporting Authorized

Nom alternatif de la colonne: reporting

Definition

Nom alternatif de la colonne: definition
Types d'artefact: Classes de données
Description: La définition de la classe de données.
Format: Code XML entouré de guillemets doubles. Créez ce code XML en exportant une classe de données existante.

Cette colonne est facultative, mais si vous l'ajoutez, elle doit contenir une valeur pour chaque classe de données dans le fichier CSV.

Exemple :

<?xml version="1.0" encoding="UTF-8" standalone="yes"?><DataClasses xmlns="http://www.ibm.com/infosphere/ia/classification/DataclassesDefinition"><DataClass id="AddressLine1" name="Address Line 1" description="Address Line 1 of a multi-line address." priority="12" active="true" provider="IBM"><JavaClassifier scope="column" className="com.ibm.infosphere.classification.impl.AddressLineClassifier"/><DataTypeFilter><LogicalDataType>string</LogicalDataType></DataTypeFilter><DataLengthFilter minLength="4" maxLength="100"/><ColumnNameFilter><ColumnNameRegularExpression>addr.{0,15}(1|one)$</ColumnNameRegularExpression></ColumnNameFilter></DataClass></DataClasses>

Data Set Type (Obligatoire pour les ensembles de données de référence)

Nom alternatif de la colonne: type
Types d'artefact: Jeux de données de référence
Description: Le type de données de l'ensemble de données de référence. Cette propriété est obligatoire si vous importez un ensemble de données de référence.
Format: Les valeurs prises en charge sont : texte, date, nombre.

Parent Reference Data Sets

Nom alternatif de la colonne: parent_rds
Types d'artefact: Jeux de données de référence
Description: Définit la relation au sein d'une hiérarchie d'ensembles de données de référence.
Format: L'ensemble de données de référence parent doit exister ou être défini dans le même fichier d' CSV. Un ensemble de données de référence peut avoir un nombre illimité d'ensembles de données de référence parents. Spécifiez l'ensemble de données de référence parent avec son chemin d'accès complet à la hiérarchie des catégories. Voir Chemins d'accès aux catégories.

Pour importer plusieurs ensembles de données de référence parents, ajoutez une ligne distincte pour chacun d'entre eux.

Exemple :

Name,Artifact Type,Category,Description,Tags,Classifications,Stewards,Related Terms,Business Start,Business End,Data Set Type,Parent Reference Data Sets,Secondary Categories,Custom Columns
RDS1,reference_data,cat1,Test RDS,tag1,Confidential,1000330999,cat1 >> term1,6/15/2021 13:08,7/31/2021 21:59,TEXT,cat1 >> RDS2,Information Governance,TEXT||CUSTOM COLUMN1||test
,,,,,,,,,,,,Business Information,NUMBER||CUSTOM COLUMN2||test2
RDS2,reference_data,cat1,,,,,,6/15/2021 13:13,,TEXT,,,

Dans un tableur, la définition ressemblerait à ceci :

Cette image montre un exemple de la façon dont la définition apparaît dans un tableur.

Custom Columns

Nom alternatif de la colonne: custom_columns
Types d'artefact: Jeux de données de référence
Description: Mappez les colonnes d'un ensemble de données de référence aux colonnes personnalisées existantes. Lorsque vous importez de nouveaux ensembles de données de référence, vous pouvez définir de nouvelles colonnes personnalisées. Voir Colonnes personnalisées.
Format: Spécifiez les informations au format suivant :

type (TEXT/NUMBER/DATE)||name||description (optional)||composite-key/normal-column (optional, default: normal-column)||mandatory/optional (optional, default: optional)||max characters number (optional, default: 2000 for normal-column, 200 for CK column)||validator as path>>name (optional)

Si la colonne est définie comme clé composite, elle doit être obligatoire.
Seul un ensemble de données de référence publié de type TEXT peut être un validateur.
Seules les colonnes personnalisées de type TEXT peuvent avoir un validateur.
Le nombre maximal de colonnes de clé composite par ensemble est de 5.

Exemples :

NUMBER||Digit Count||Number of digits of the prime
TEXT||Additional information

Parent Policy

Nom alternatif de la colonne: parent_policy
Types d'artefact: Politiques
Description: Spécifie la stratégie parent d'une stratégie.
Format: La politique parentale doit exister. Spécifiez la stratégie parent avec son chemin d'accès complet à la hiérarchie des catégories. Voir Chemins d'accès aux catégories.

Une politique ne peut avoir qu'une seule politique parente.

Exemples :

Name,Artifact Type,Category,Description,Tags,Classifications,Stewards,Secondary Categories,Rules,Parent Policy
policy7,policy,PolicyDef,test policy7,Tag1,,,,,PolicyDef >> policy1

Parent Policies

Nom alternatif de la colonne: parent_policies
Types d'artefact: Règles de gouvernance
Description: Spécifie la politique parent d'une règle de gouvernance.
Format: La politique parentale doit exister. Spécifiez la stratégie parent avec son chemin d'accès complet à la hiérarchie des catégories. Voir Chemins d'accès aux catégories.

Exemples :

Name,Artifact Type,Category,Description,Tags,Classifications,Stewards,Related Terms,Business Start,Business End,Type,Secondary Categories,Rules,Reference Data Sets,Parent Policies,custom_Rule_text_0
rule2,rule,cat1,,,,,,6/15/2021 13:17,,Governance,,cat1 >> rule1,,cat1 >> pol1,
rule1,rule,cat1,test description,tag1,Confidential,1000330999,cat1 >> term1,6/15/2021 13:16,8/31/2021 21:59,Governance,Business Information,cat1 >> rule3,cat1 >> RDS2,cat1 >> pol2,example CA value
,,,,,,,,,,,,cat1 >> rule2,cat1 >> RDS1,cat1 >> pol1,
rule3,rule,cat1,,,,,,6/15/2021 13:20,,Governance,,cat1 >> rule1,,cat1 >> pol1,

Rules

Nom alternatif de la colonne: rules
Types d'artefact: Politiques, règles de gouvernance
Description: Pour une politique, une règle de gouvernance régie par cette politique.

En règle générale, les règles de gouvernance qui sont liées d'une manière ou d'une autre à cette règle. La relation est symétrique. Si vous indiquez que la règle A est liée à la règle B, la règle B est alors liée à la règle A.

Format: La règle de gouvernance doit exister. Spécifiez la règle de gouvernance avec son chemin d'accès complet à la hiérarchie des catégories. Voir Chemins d'accès aux catégories.

Pour importer des relations avec plusieurs règles, ajoutez une ligne distincte pour chacune d'elles.

Exemple :

Name,Artifact Type,Category,Description,Tags,Classifications,Stewards,Related Terms,Business Start,Business End,Secondary Categories,Rules,Parent Policy,custom_policy_text_0
pol3,policy,cat1,,,,,,6/15/2021 13:16,,,,,
pol2,policy,cat1,,,,,,6/15/2021 13:14,,,cat1 >> rule1,cat1 >> pol1,
pol1,policy,cat1,test descritpion,tag1,Confidential,1000330999,cat1 >> term1,6/15/2021 13:11,7/31/2021 21:59,Information Governance,cat1 >> rule3,cat1 >> pol3,example CA value
,,,,,,,,,,,cat1 >> rule1,,
,,,,,,,,,,,cat1 >> rule2,,

Reference Data Sets

Nom alternatif de la colonne: rds
Types d'artefact: Règles de gouvernance
Description: Ensemble de données de référence lié à la règle de gouvernance.
Format: L'ensemble de données de référence doit exister. Spécifiez l'ensemble de données de référence avec son chemin d'accès complet à la hiérarchie des catégories. Voir Chemins d'accès aux catégories.

CSV format de fichier pour l'importation d'artefacts de gouvernance

Règles générales de mise en forme

Restrictions

Ligne d'en-tête

Délimiteurs de colonnes

Chemins de catégorie

Format des champs Catégorie et Sous-catégorie

Format pour les artefacts associés

Valeurs des propriétés des artefacts

Valeurs multiples pour une propriété

Relations entre les artefacts

Codage de caractères

Règles de mise en forme des colonnes

Name (Obligatoire)

Artifact Type (Obligatoire)

Category (Obligatoire)

Description

Secondary Categories

Stewards

Steward Groups

Tags

Classifications

Business Start

Business End

Related Terms

Valeurs des propriétés personnalisées

Relations personnalisées

Part of Terms

Type of Terms

Synonyms

Data Classes

Abbreviations

Parent Classification

Parent Data Class

Enabled

Reporting Authorized

Definition

Data Set Type (Obligatoire pour les ensembles de données de référence)

Parent Reference Data Sets

Custom Columns

Parent Policy

Parent Policies

Rules

Reference Data Sets

En savoir plus