Cet article a pour objectif d'expliquer comment importer des usages dans le catalogue DataGalaxy.
Pour comprendre plus précisément le concept de propriétés et d'objets, vous pouvez consulter cet article.
Pour rappel : les usages permettent d'expliquer aux utilisateurs la provenance des données et d'analyser l'impact d'une modification.
Cette fonctionnalité vise à :
- Faciliter l'import des objets usages.
- Accélérer la mise à jour d'objets grâce à l'import de données préalablement exportées.
La fonctionnalité d'import est disponible :
- Depuis le widget "Raccourcis" présent sur l'écran d'accueil d'un espace client ou d'un espace de travail
- Depuis le module Usages lorsque celui-ci est vide
- Depuis le menu contextuel du module Usages à droite des vues filtrées
Importer des objets
Les utilisateurs de DataGalaxy peuvent importer des propriétés à partir d'un fichier au format csv en suivant ces étapes :
1. Accédez au module Usages
2. Cliquez sur l'icône 3 petits points
3. Dans le menu déroulant, cliquez sur Importer 
4. Sélectionnez ou glisser/déposer votre fichier à importer dans la zone d'import de fichier CSV disponible en haut à gauche.
Quel que soit le point d'entrée choisi, la popup suivante générique d'import et de connectivité s'affiche
Si certaines options sont paramétrables par la suite, le fichier à importer devra toujours contenir les colonnes suivantes :
- Le path de l'objet
- Le type de l'objet
- + une colonne pour chaque attribut faisant partie de la fiche d'un objet que vous souhaitez importer
Exemple de structure de fichier CSV à importer :
"Path";"Type";"Status";"DataOwners";"Summary";"CDPEtiquetteUsages"
"\Finance\Primmo\Suivi de marché";"\Application\Application\Dashboard";"En validation";"dataowner@datagalaxy.com";"";"Finance"
"\Finance\SAP\Analyse des PNS clients";"\Application\Application\Screen";"Validé";"dataowner@datagalaxy.com;""Ecran SAP accessible via la transaction FAGL";""Finance","RGPD""
5. Sélectionner Usages au sein du module Glossaire et cliquer sur le bouton Suivant
La zone centrale permet d'ajuster les paramètres techniques du fichier (encodage, séparateur) et la tableau, vous propose un aperçu du contenu du fichier.
6. L'étape suivante permet d'effectuer le mapping des propriétés et de réaliser des contrôles fonctionnels avant import. Lorsque c'est possible, une correspondance automatique entre les champs sources et cibles est effectuée et la vérification de votre fichier est lancée.
- Si les champs obligatoires ne sont pas mappés, la vérification n'est pas lancée et l'import n'est pas possible.
- En cas de succès, l'import est possible (le bouton Importer est immédiatement actif).
- En cas d'échec, les contrôles en erreur sont présents dans l'onglet Contrôles.
En cliquant sur le statut en cas d'échec, l'onglet liste les contrôles pour lesquels une erreur a été détectée :
- Lorsque une erreur bloquante peut être résolue, la solution est renseignée dans la colonne "Action".
- Ces contrôles sont obligatoires, et doivent être relancés lorsqu'une modification (mapping, paramétrage) de l'import est effectuée.
7. L'onglet Mapping permet de définir la correspondance entre les champs du fichier et les attributs DataGalaxy à alimenter :
- Faire glisser les champs de la colonne de gauche sur les champs correspondants à droite pour définir une nouvelle correspondance.
- Seuls les champs type et path, identifiés en rouge, sont obligatoires.
- Pour les fichiers avec de nombreux champs: il est possible de faire des recherches de champs et de masquer les champs déjà utilisés
NB : Dans le cas de mise à jour de vos objets via cet import, si vous importez des valeurs vides des attributs dans votre fichier, qui sont déjà renseignées dans vos fiches objets, ces valeurs vides seront ignorées par défaut et vos valeurs existantes sont sauvegardées. Mais, en cochant cette option (figure ci-dessous), elles videront les valeurs existantes.
8. L'onglet Aperçu permet d'avoir un aperçu des valeurs pour chaque attribut à importer, pour lequel une correspondance a été définie.
9. Lorsque ces étapes sont complétées et que le contrôle est en succès, le bouton Importer devient actif. Cliquer dessus pour lancer l'import. 
Importer des objets liés (relations + utilisations)
Il est possible d'importer :
- des relations (liens logiques non visibles dans le lineage)
- des liens d'utilisations (liens physiques avec le glossaire et le dictionnaire visibles dans le lineage)
Pour cela il faut :
1. Accédez au module Usages
2. Cliquez sur l'icône 3 petits points
3. Dans le menu déroulant, cliquez sur Importer
4. Sélectionnez ou glisser/déposer votre fichier à importer dans la zone d'import de fichier CSV disponible en haut à gauche. 
Le fichier à importer devra toujours contenir les colonnes suivantes :
- Le path de l'objet source
- Le type de l'objet source
- Le type de la relation
- Le path de l'objet cible
- Le type de l'objet cible
Exemple de structure de fichier CSV à importer :
SourceEntityPath;SourceEntityType;EntityLinkType;LinkedEntityPath;LinkedEntityType
\Extraction prospect;\Usage;uses;\AdventureWorks Datawarehouse;\ProspectiveBuyer \Database\Table
\Autres\Dynamics\Analyse comparative;\Application\Application\Report;is usage source for;\Load asset;\Data Processing
5. Sélectionner Objets liés au sein du module Usages et cliquer sur le bouton Suivant 
6. L'étape suivante permet d'effectuer le mapping des propriétés et de réaliser des contrôles fonctionnels avant import. Le fonctionnement est identique à celui de l'import d'objets.
7. Vérifiez l'exactitude des champs à récupérer dans l'onglet Mapping
8. L'onglet Aperçu permet d'avoir un aperçu des valeurs sources par attribut mappé.
9. Lorsque ces étapes sont complétées et que le contrôle est en succès, le bouton Importer devient actif. Cliquer dessus pour effectuer l'import.
Releases
| Date | Plugin version | DataGalaxy release | Desktop connector version (minimum) | Description |
| 26/07/2024 | 5.0.1 | v3.62.0 | 5.0.3 | Migrated from java 11 to java 17 |