Transformer les données
- Ajouter une transformation de données
- Configurer une transformation de données
- Modifier l'ordre d'application des transformations de données
- Supprimer / Éditer une transformation de données
Il est possible de transformer les colonnes d'un modèle de données. Cela permet :
- de transformer les données en entrée : remplacer une valeur par une autre, compléter des valeurs manquantes, rajouter des majuscules, etc
- d'ajouter de nouvelles colonnes de données basées sur les colonnes existantes : libellé court, code correspondant à la valeur de la colonne, etc
- de concaténer des colonnes....
Ajouter une transformation de données
Pour ajouter une transformation de données, vous pouvez:
- ouvrir l'onglet Transformation des données et cliquez sur le bouton +Ajouter
— ou —
cliquer sur l'en-tête de la colonne que vous souhaitez transformer (ici Date) puis, dans le menu contextuel qui s'affiche, cliquer sur Transformation des données.
➡ L'interface Création de la transformation s'affiche avec une transformation indiquée En création...
Configurer une transformation de données
Une fois la transformation de données ajoutée, vous pouvez la configurer :
- Sélectionnez la colonne à laquelle vous souhaitez l'appliquer dans la liste déroulante Colonne cible.
Si vous êtes passés par le menu contextuel de l'en-tête de colonne, elle est déjà sélectionnée.
Si vous souhaitez afficher le résultat de la transformation de données dans une autre colonne, vous pouvez ajouter une colonne vide en cliquant sur Ajouter une colonne.
- Vous pouvez alors définir une fonction de transformation:
- Si vous connaissez la fonction Javascript que vous souhaitez appliquer, vous pouvez l'entrer directement.
- Dans le cas contraire, vous pouvez effectuer une recherche dans le champ Fonction appliquée. Cette recherche s'effectue sur les fonctions partagées existantes et les fonctions disponibles dans DigDash Metadata Service.
- Enfin, si aucun résultat ne correspond à votre recherche, vous avez la possibilité de générer une fonction avec l'intelligence artificielle.
💡 Pour agrandir l'interface de création/édition de la transformation de données, cliquez sur le bouton 
en haut à droite.
Entrer une fonction Javascript
Lorsque les traitements à réaliser sont particuliers, la création d’un script est nécessaire.
💡 Pour ouvrir une fenêtre dédiée à l'éditeur Javascript , cliquez sur le bouton 
en haut à droite de la zone d'édition.
- Entrez la fonction Javascript de transformation de la colonne directement dans l'éditeur.
Vous pouvez utiliser les variables suivantes :Variable Description value Renvoie la valeur courante dans la colonne pour chacune des lignes. values Renvoie les valeurs dans la colonne (position de la colonne).
Par exemple, values[2] renvoie le contenu de la troisième colonne (la première colonne correspond à la position 0).col Renvoie l'index de la colonne en cours de transformation. row Renvoie l'index de la ligne en cours de transformation. rawValue Renvoie la valeur "brute" courante dans la colonne pour chacune des lignes (sans interprétation par DigDash); rawValues Renvoie les valeurs dans la colonne (position de la colonne) dans leur format "brut". namedValues Renvoie les valeurs dans la colonne (nom de la colonne).
Par exemple, namedValues["Age"] renvoie le contenu de la colonne "Age".nameRawValues Renvoie les valeurs dans la colonne (nom de la colonne) dans leur format "brut". - Cliquez sur Appliquer.
➡ La fonction prend le nom Script personnalisé.
Vous pouvez visualiser le résultat de la fonction de transformation directement dans la Prévisualisation. - Pour terminer, cliquez sur le bouton Fermer
en haut à droite.
➡ La fonction est ajoutée à la liste de fonctions de transformations des données appliquées.
Par exemple, nous souhaitons remplacer dans les données en entrée, la valeur “Finance” par la valeur “Comptabilité” pour la dimension “Département”.
Exemples de cas d'usage
| Besoin | Solution |
|---|---|
| Récupérer la cellule courante d’une autre colonne | return values[INDEX_OF_COLUMN] |
| Récupérer le contenu de la cellule courante | return value; |
| Selon la valeur d’une cellule, je retourne X, sinon je retourne Y. | if(value == “Fixe”){ return “X”; }else if(value == “Mobile”){ return “Y”; } Si la valeur se situe dans une autre colonne mais sur la même ligne if(values[INDEX_OF_COLUMN] == “Fixe”){ return “X”; }else if(values[INDEX_OF_COLUMN] == “Mobile”){ return “Y”; } |
| Effectuer un traitement sur des lignes particulières Exemple : Sur les 10 premières lignes, je retourne “X”. A partir de la 11ème, je retourne “Y” | if(row <=10){ return “X”; }else{ return “Y”; } |
| Compter le nombre de lignes retournées par la source de données. | return 1; (or return row, then DCOUNT it) |
| Calculer la différence en jour entre deux dates var difference = values["END_DATE_INDEX"].getTime() - values["START_DATE_INDEX"].getTime(); var diffInDays = Math.floor(difference/1000/60/60/24); difference = diffInDays*1000*60*60*24; return difference; | |
Supprimer la fonction
Pour supprimer la fonction courante, cliquez sur le bouton 
.
Modifier la fonction
Une fois la fonction appliquée, vous pouvez néanmoins la modifier.
Vous pourrez revenir à l'état de la dernière fonction appliquée en cliquant sur Annuler.
Rechercher une fonction existante
Vous pouvez rechercher une fonction parmi les différentes fonctions disponibles :
- Fonctions partagées :
- fonctions personnalisées créées précédemment et partagées avec le rôle ou tous les rôles.
- fonctions utiles fournies nativement par Digdash
- Fonctions disponibles dans DigDash Metadata Service : la fonction sélectionnée sera alors chargée de manière transparente comme une fonction partagée.
Pour cela :
- Entrez le nom ou une brève description de la fonction recherchée.
- Cliquez sur l'icône de recherche
.
➡ Une liste de fonctions correspondant à votre recherche s'affiche.
- Si une fonction vous convient, cliquez sur le lien correspondant.
➡ L'intitulé de la fonction s'affiche.
- Cliquez sur Appliquer pour appliquer la fonction à la colonne cible sélectionnée et visualiser le résultat dans la Prévisualisation.
- Pour terminer, cliquez sur le bouton Fermer
en haut à droite.➡ La fonction est ajoutée à la liste de fonctions de transformations des données appliquées.
Modifier la traduction/description
Pour modifier les valeurs affichées et la description de la fonction dans les différentes langues, cliquez sur le bouton d'édition multi-langue 
.
Consultez la page Traduire le nom d'un objet pour plus de détails.
Supprimer la fonction
Pour supprimer la fonction courante :
- Cliquez sur le bouton Annuler ou .
Afficher et modifier le script
Pour afficher le script de la fonction, cliquez sur le bouton 
.
Vous pouvez alors modifier le script dans l'éditeur.
Si vous modifiez le script, lorsque vous cliquez sur Appliquer, plusieurs choix vous sont proposés:
- Mettre à jour la fonction existante [Nom] dans le gestionnaire : la fonction est mise à jour avec les modifications de manière globale.
❗Cela impactera tous les éléments faisant appel à cette fonction.
- Sauvegarder comme une nouvelle fonction partagée : une nouvelle fonction est créée avec les modifications apportées à la fonction originale.
Dans ce cas, il vous sera demandé d'entrer un Identifiant et de sélectionner un Rôle auquel l'accès à la fonction est restreint ou Aucun pour la partager à tous les rôles.
➡ La fonction sera alors disponible dans la liste des fonctions partagées pour une utilisation ultérieure.
❗La nouvelle fonction aura un identifiant différent mais conservera la même valeur affichée que la fonction originale. Pensez donc à modifier la valeur affichée dans l'info-bulle ou en cliquant sur bouton d'édition multi-langue . - Appliquer le script sur la colonne : la fonction devient alors un script personnalisé avec les options correspondantes. Elle ne pourra être réutilisée.
Générer une fonction à l'aide de l'intelligence artificielle
💡 Pour plus d'informations, vous pouvez également consulter notre tutoriel vidéo Transformation des données via IA.
- Effectuez une recherche comme décrit ci-dessus.
- Si aucune fonction n'est compatible avec votre recherche, cliquez sur En générer une avec l'IA.
À noter que votre instruction doit être la plus précise possible pour obtenir le résultat souhaité.
➡ Une fonction Javascript est alors générée et affichée.
- Vous pouvez modifier le script. Par exemple, ici, on pourra changer la position des colonnes à concaténer sachant que la première colonne a la position 0.
- Cliquez sur Appliquer.
➡ La fonction prend le nom Script personnalisé.
Vous pouvez visualiser le résultat de la fonction de transformation directement dans la Prévisualisation. - Pour terminer, cliquez sur le bouton Fermer en haut à droite.
➡ La fonction est ajoutée à la liste de fonctions de transformations des données appliquées.
Supprimer la fonction
Pour supprimer la fonction courante :
- Cliquez sur le bouton Annuler ou .
Partager une fonction
Dans le cas d'un script personnalisé, qu'il ait été créé manuellement ou généré par l'intelligence artificielle, il est possible de la sauvegarder en tant que fonction partagée pour une réutilisation ultérieure.
Pour cela :
- Une fois la fonction définie dans la section de Création de la transformation, cliquez sur Partager.
➡ La boite de dialogue Sauvegarder en tant que fonction prédéfinie s'affiche. - Entrez l'identifiant de la fonction.
- Sélectionnez le Rôle auquel l'accès à la fonction est restreint ou Aucun pour la partager à tous les rôles.
- Cliquez sur OK.
➡ La fonction prend le nom de l'identifiant entré et est alors disponible dans le Gestionnaire de fonctions partagées. - Vous pouvez modifier la valeur affichée et la description de la fonction dans les différentes langues en cliquant sur le bouton d'édition multi-langue . Consultez la page Traduire le nom d'un objet pour plus de détails.
Rendre une fonction paramétrable
Il est possible de rendre une fonction qui utilise des variables paramétrable afin de la réutiliser ultérieurement avec des colonnes sélectionnables.
- Vous disposez d'une fonction utilisant des variables, par exemple, une fonction permettant de concaténer 3 colonnes:
- Cliquez sur Rendre paramétrable.
➡ Une interface permettant de sélectionner les colonnes à concaténer est alors disponible.
- Cliquez sur Partager comme décrit ci-dessus afin de pouvoir la réutiliser ultérieurement.
Modifier l'ordre d'application des transformations de données
Par défaut, les fonctions de transformation sont listées par ordre de création et s'appliquent dans cet ordre.
Pour modifier l'ordre d'application des fonctions :
- Sélectionnez la fonction à déplacer et cliquez sur le bouton
ou 
pour faire monter ou descendre la fonction dans la liste.
Supprimer / Éditer une transformation de données
Pour modifier une fonction de transformaton de données :
- Sélectionnez la fonction dans la liste et cliquez sur Éditer.
➡ L'interface Edition de la transformation s'affiche et vous permet de modifier la fonction de manière similaire que lors de la création.
Pour supprimer une fonction :
- Sélectionnez la fonction dans la liste et cliquez sur Éditer.