Formules DataChain
GenericsData & 
HandleData
Les formules permettent de d’effectuer des traitements plus ou moins complexe sur les jeux de données à différents niveaux stratégiques de la chaîne de valeur.
Les fonctions unitaires disponibles dans DataChain vous permettent de créer des formules plus ou moins complexes.
Gestionnaire de formules
Il est possible d’appliquer des formules sur les jeux de données des Entités Métier, des DataBlocks et des sources de données sélectionnées dans les différentes visualisations de HandleData (Graphiques, Tableaux, …).
Le gestionnaire de formules permet de construire et définir les formules à appliquer sur les jeux de données.
Il est possible de créer de nouvelles formules ou d’utiliser celles du catalogue de formules.
Formules existantes dans le contexte de travail (1)
Activer ou désactiver une formule (2)
Éditer la formule de la liste
Dupliquer la formule de la liste
Supprimer la formule de la liste
Libellé de la formule sélectionnée ou en cours de création (Obligatoire)
Description de la formule
Zone de saisie de formule
Copie la formule en cours d’édition
Colle la formule précédemment copiée
Ouvre le Catalogue de formule
Ajouter la formule en cours dans le Catalogue de formule
Affichage la formule sous forme d’arbre
Cliquer pour créer une formule
Supprime l’ensembles des formules appliquées à l’élément ou à l’étape du DataBlock
Ferme le gestionnaire de formules
(1) La notion de contexte renvoie à la page depuis laquelle le Gestionnaire est ouvert. Par exemple, si l’ajout d’une Formule est réalisée depuis une étape d’un DataBlock, les formules présentées dans la liste sont celles de l’étape en cours.
(2) Si une formule est inactive, alors la colonne est toujours présente dans le tableau des valeurs mais les valeurs sont valorisées à Null.
Construire une formule
Chaque fonction attend un ou plusieurs arguments.
Le type de l’argument attendu peut être limité selon la fonction.
| Prefix de la fonction | Type d’argument en entrée |
|---|---|
str. |
Chaîne de caractères |
num. |
Numérique |
date. |
Dates |
bool. |
Booléens |
url. |
Adresse URL |
geo. |
Géographiques |
list. |
Listes |
url. |
Numérique |
dc.,words., bin., file., http. |
Spécifiques à DataChain |
Pour construire une nouvelle formule, cliquer sur le bouton Nouvelle formule puis entrer un libellé et une description.
Sélectionner ensuite la zone de saisie de formule.
Plusieurs fonctions sont proposées depuis la liste.
Vous pouvez sélectionner et ajouter les formules à l’aide du clavier ou de la souris.
Les fonctions sont regroupées par type d’argument attendu en entrée, commencez à tapper le prefix de la formule pour affiner la liste.
Zone de saisie
Zone de recherche d’une fonction
Fonctions disponibles
Catalogue de formule
Cliquer pour valide la formule
Cliquer pour vider la zone de saisie de la formule
Annule les modifications sur la formule (édition seulement)
Définir les arguments d’une fonction
Chaque fonction possède un ou plusieurs arguments qui doivent être définis.
La valeur que peut prendre un argument peut être de différente nature
-
une saisie d’information directe
-
une colonne disponible dans la source
-
une formule
-
une fonction unitaire
-
une valeur choisie dans une liste fermée, proposée par DataChain
Certains arguments attendent un type de valeur spécifique.
Par exemple
num.sinus(argument)
argument est obligatoirement de type numérique (Integer, BigInteger, Décimal…).
Dans ce cas, les listes des fonctions, des formules, ou des valeurs disponibles ne proposerons que les éléments adaptés au type attendu.
Il est possible d’utiliser la souris ou le clavier pour se positionner au niveau du ou des arguments à définir.
Nom de la fonction
Dans l’exemple de la fonction str.split, 2 arguments sont exigés
Argument (1)
Dans l’exemple, la colonne COMMUNE.
Séparateur
Dans l’exemple le tiret du 6 -
Affiche la formule en vue arbre
Détail de la formule et des arguments attendus
(1) La liste des éléments dépend du type de l’attribut. Par exemple si l’attribut est de type Integer, alors des éléments de type Integer seront proposés et acceptés
Il est possible d’affecter une formule du catalogue comme argument d’une formule.
Au niveau de l’argument de la fonction , cliquer sur 
et sélectionner la formule à insérer.
Lorsque la formule est terminée, cliquer sur Valider .
Pour réinitialiser l’ensemble des éléments (libellé, fonction, description,…) de la formule, cliquer sur Vider.
Pour ajouter la formule au catalogue cliquer sur l’icône .
Interpréter la valeur en sortie d’une formule
La valeur renvoyée en sortie de la formule dépend entièrement de la ou des fonctions qu’elle contient.
La liste des formules détaille le type de valeur renvoyé en sortie.
| Si une incohérence de type est constatée dans les arguments la valeur de sortie sera toujours null. |
Catalogue de formules
Chaque formule peut-être ajoutée au catalogue afin d’être réutilisée.
L’utilisateur qui ajoute une formule au catalogue, en devient le propriétaire.
La formule peut être partagée ou non.
Formule partagée
La formule peut être utilisée, dupliquée et exportée par tous les utilisateurs depuis tous les projets, y compris si elles ont été créées depuis un Projet privé.
Seul le propriétaire peut la modifier et la supprimer.
Formule non partagée
Seul son propriétaire peut la voir, la modifier et l’utiliser, depuis n’importe quel Projet dont il est membre.
Afficher la liste des formules du catalogue
Pour afficher l’ensemble des formules du catalogue sélectionner .
Pour ajouter une nouvelle formule depuis le catalogue, cliquer Nouveau puis sur Nouvelle formule.
Créer votre formule et renseignez les métadonnées puis cliquer sur Valider.
Pour partager la formule avec d’autres utilisateurs, positionner le bouton de partage sur ON.
Ajouter une formule au Catalogue
Il est possible d’ajouter une formule au Catalogue depuis le Gestionnaire de formule ouvert depuis un élément (un DataBlock par exemple).
Cliquer sur puis renseignez les métadonnées de la formule et si elle doit être partagée et cliquer sur Enregistrer.
|
Lors de l’ajout d’une formule au catalogue, les références de colonne de l’élément en cours sont remplacées par un joker (/?/). Les valeurs des autres arguments ne faisant pas références à une colonne du bloc de données en cours sont conservées. |
Appliquer une formule du Catalogue
Ouvrir le Gestionnaire de formule depuis la page de l’élément puis cliquer sur Nouvelle formule > .
-
Sélectionner pour afficher uniquement les formules de l’utilisateur en cours
-
Sélectionner la formule
-
Zone détaillant la formule sélectionnée
-
Annule les modifications en cours et ferme le Catalogue
-
Importer ou exporter une formule
-
Supprimer la formule du catalogue
-
Activer le partage de la formule (si vous êtes le propriétaire)
Cliquer sur Affecter * pour fermer la popup et retourner sur la page de création de formule
Pour affecter une formule du catalogue dans un attribut d’une formule en cours, positionner le sélecteur au niveau de l’argument de la fonction et cliquer sur