Centre d'aide Tabsters

Pas de résultats, essayez autre chose
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.

Les fonctions dans les formules

Découvrez dans cet article, les différents fonctions dans les formules, leur paramétrage et leur utilisation dans Tabsters.

Introduction

Les champs personnalisés de Tabsters vous offrent la possibilité de définir des formules de calcul afin d'obtenir l'information souhaitée.

Vous avez par exemple, la possibilité d'ajouter deux champs entre eux afin d'obtenir le résultat de leur addition dans votre champ personnalisé, de transformer des valeurs en pourcentage en divisant par 100 votre valeur, ou encore de transformer des données d'euro à millions d'euro en divisant par un million.

Cependant, tous ces calculs se basent uniquement sur des opérateurs simples, tels que l'addition, la soustraction, la division et la multiplication.

Afin de vous offrir la possibilité d'aller encore plus loin dans la création de vos formules, Tabsters vous mets à disposition de nombreuses fonctions pour vous permettre un plus vaste choix de paramétrage des formules de vos champs personnalisés.

Fonctions Min & Max

Fonctions MinOf / MaxOf

  • Types de champs pris en compte : Champs de type Nombre, Date
  • Paramètres d'entrée : N nombres ou dates
  • Nombre de paramètres attendus : 2 ou plus

Description :

  • La fonction MinOf permet de comparer les valeurs de N différents champs date ou nombre d'une ligne pour en retourner la valeur la plus faible.
  • La fonction MaxOf permet de comparer les valeurs de N différents champs date ou nombre d'une ligne pour en retourner la valeur la plus forte.

Paramétrage : Sélectionnez la formule MinOf() / MaxOf() dans la liste des fonctions disponibles. Positionnez vous ensuite à l'intérieur des parenthèses de la fonction, et sélectionnez le champ voulu dans la liste des champs disponibles.
Une fois le champ sélectionné, séparez le champ du suivant avec un point-virgule, puis rajoutez le champ suivant.
Répétez l'opération autant de fois que vous souhaitez comparer de champs dans votre fonction.

Point d'attention : En fonction du type de champ personnalisé créé (Nombre ou Date), pensez bien à ne renseigner dans votre fonction, que des champs du même type que le champ créé ou votre paramétrage ne fonctionnera pas.

Exemples de paramétrages :

  • MinOf([Date de début];[Date début [Référence]])
    Cette formule compare la date de début & date de début initiale de la ligne et renvoie la date la plus ancienne/petite
  • MinOf([Charge JH];[Charge JH [Référence]])
    Cette formule compare la Charge JH & Charge JH [Référence] de la ligne et renvoie la valeur la plus faible
  • MaxOf([Date de fin];[Date de fin [Référence]])
    Cette formule compare la date de fin & date de fin référence de la ligne et renvoie la date la plus récente/grande
  • MaxOf([Workload];[Initial_Workload])
    Cette formule compare la Charge JH & Charge JH [Référence] de la ligne et renvoie la valeur la plus forte

Fonctions de dates (Year, Quarter, Month, NbDays, NbOpenDays, DateAdd, Today)

Fonctions YearOf / QuarterOf / MonthOf

  • Types de champs pris en compte : Champ de type date
  • Paramètres d'entrée : 1 champ Date
  • Nombre de paramètres attendus : 1

Description :

  • La fonction YearOf permet de récupérer l'année correspondante d'une date d'un élément.
  • La fonction QuarterOf permet de récupérer le numéro du trimestre correspondant d'une date d'un élément
  • La fonction MonthOf permet de récupérer le numéro du mois correspondant d'une date d'un élément

Paramétrage : Sélectionnez la formule YearOf() / QuarterOf() / MonthOf() dans la liste des fonctions disponibles. Positionnez vous ensuite à l'intérieur des parenthèses de la fonction, et sélectionnez le champ date dont vous voulez récupérer l'année, dans la liste des champs disponibles.

Exemples de paramétrages :

  • YearOf([Date de fin])
    Cette formule renvoie l'année du champ date de fin de l'élément
  • QuarterOf([Date de fin])
    Cette formule renvoie le numéro du trimestre du champ date de fin de l'élément
  • MonthOf([Date de fin])
    Cette formule renvoie le numéro du mois du champ date de fin de l'élément

Fonctions NbDays / NbOpenDays

  • Types de champs pris en compte : Champ de type date
  • Paramètres d'entrée : 2 champs Date
  • Nombre de paramètres attendus : 2

Description :

  • La fonction NbDays permet de récupérer le nombre de jours entre deux dates d'un élément.
  • La fonction NbOpenDays permet de récupérer le nombre de jours ouvrés entre deux dates d'un élément

Paramétrage : Sélectionnez la formule NbDays() / NbOpenDays() dans la liste des fonctions disponibles. Positionnez vous ensuite à l'intérieur des parenthèses de la fonction, et sélectionnez le champ date voulu dans la liste des champs disponibles.
Une fois le champ sélectionné, séparez le champ du suivant avec un point-virgule, puis rajoutez votre deuxième champ date.

Exemples de paramétrages :

  • NbDays([Date de début];[Date de fin])
    Cette formule renvoie le nombre de jours entre la date de début et la date de fin de l'élément
  • NbOpenDays([Date de début];[Date de fin])
    Cette formule renvoie le nombre de jours ouvrés entre la date de début et la date de fin de l'élément.

Fonction DateAdd

  • Types de champs pris en compte : Champ de type date
  • Paramètres d'entrée : 3 (Champ date, Elément à incrémenter (Année, Mois, Jour), Valeur d'incrémentation)
  • Nombre de paramètres attendus : 3

Description : La fonction DateAdd permet d'ajouter un nombre donné de jour/mois/année au jour/mois/année d'un champ date d'un élément.

Paramétrage : Sélectionnez la formule DateAdd dans la liste des fonctions disponibles. Positionnez vous ensuite à l'intérieur des parenthèses de la fonction, et sélectionnez le champ date que vous souhaitez incrémenter.
Une fois le champ sélectionné, séparez le champ du suivant avec un point-virgule, puis renseignez l'élément de la date que vous souhaitez incrémenter entre des guillemets & en anglais (Ex. "Year" / "Month" / "Day").
Une fois la période renseignée, séparer la du champ suivant avec un point-virgule, puis renseignez enfin la valeur avec laquelle vous souhaitez incrémenter la période précédemment renseignée.

Exemple de paramétrage :

  • DATEADD([Date de fin];"Day";3)
    Cette formule renvoie la date de fin de l'élément avancée de 3 jours

Fonction Today

  • Types de champs pris en compte : - NA -
  • Paramètres d'entrée : 0
  • Nombre de paramètres attendus : 0

Description : La fonction Today permet de renvoyer la date actuelle.
Cette fonction en elle-même n'a pas d'usage particulier à part renvoyer la date actuelle, mais peut être intégrée dans les autres fonctions pour des conditions ou autres vérifications.

Paramétrage : - NA -

Exemple de paramétrage :

  • NbOpenDays(TODAY();[Date de fin])
    Cette formule renvoie le nombre de jours ouvrés restants entre la date de fin de l'élément et la date actuelle
  • AND([Date de fin]<TODAY();[Statut]="En cours")
    Cette formule vérifie si l'élément présente une date de fin inférieure à la date actuelle, et si son statut est "En cours"

Fonctions Child

Fonctions ChildMin / ChildMax

  • Types de champs pris en compte : Champ de type nombre
  • Paramètres d'entrée : 4
  • Nombre de paramètres attendus : De 2 à 4 (2 obligatoires et 2 facultatifs)

Description :

  • La fonction ChildMin permet de récupérer au niveau N+1, la valeur minimale du champ défini des niveaux N.
  • La fonction ChildMax permet de récupérer au niveau N+1, la valeur maximale du champ défini des niveaux N.

Paramétrage : Sélectionnez la formule ChildMin() / ChildMax() dans la liste des fonctions disponibles. Positionnez vous ensuite à l'intérieur des parenthèses de la fonction, et renseignez entre guillemets, le type d'objet des éléments à comparer (Le type d'objet est à renseigner en anglais Ex. "Task").
Une fois le type d'objet renseigné, séparez le du champ suivant avec un point-virgule, puis sélectionnez le champ à considérer dans la liste des champs disponibles.
Une fois le champ sélectionné, vous pouvez choisir de valider votre formule, ou d'ajouter des paramètres facultatifs si vous le souhaitez.

Pour rajouter des paramètres facultatifs :

  • En troisième position, vous pouvez positionner le paramètre facultatif True (Permet d'afficher le résultat du champ sur tous les niveaux sélectionnés pour votre champ) ou False (Permet d'afficher le résultat du champ uniquement au niveau parent du type d'objet défini dans votre fonction)
  • En quatrième position, vous pouvez positionner une condition de filtrage pour n'appliquer le calcul que sur les lignes répondant à ce critère (Ex. [Statut]="En cours" pour n'appliquer la fonction qu'aux lignes présentant le statut "En cours")

Point d'attention : Vous ne pouvez positionner le paramètre n°4 que si une valeur est également renseignée pour le paramètre n°3

Exemples de paramétrages :

  • ChildMin("Task";[Consommé JH];True)
    Cette formule renvoie, sur toutes les lignes de niveau supérieur au niveau tâche, la valeur de consommé JH la plus faible des tâches enfants de l'élément
  • ChildMax("Action";[Charge JH];False;[Statut]="En cours")
    Cette formule renvoie, uniquement au niveau parent de l'action (Lot ou Projet en fonction de votre hiérarchie) présentant le statut "En cours", la valeur la plus haute de charge JH des actions enfants

Fonctions ChildSum / ChildAverage

  • Types de champs pris en compte : Champ de type nombre
  • Paramètres d'entrée : 4
  • Nombre de paramètres attendus : De 2 à 4 (2 obligatoires et 2 facultatifs)

Description :

  • La fonction ChildSum permet de sommer au niveau N+1, les valeurs du champ défini des niveaux N.
  • La fonction ChildAverage permet de récupérer la moyenne au niveau N+1, des valeurs du champ défini des niveaux N.

Paramétrage : Sélectionnez la formule ChildSum() / ChildAverage() dans la liste des fonctions disponibles. Positionnez vous ensuite à l'intérieur des parenthèses de la fonction, et renseignez entre guillemets, le type d'objet des éléments à comparer (Le type d'objet est à renseigner en anglais Ex. "Task").
Une fois le type d'objet renseigné, séparez le du champ suivant avec un point-virgule, puis sélectionnez le champ à considérer dans la liste des champs disponibles.
Une fois le champ sélectionné, vous pouvez choisir de valider votre formule, ou d'ajouter des paramètres facultatifs si vous le souhaitez.

Pour rajouter des paramètres facultatifs :

  • En troisième position, vous pouvez positionner le paramètre facultatif True (Permet d'afficher le résultat du champ sur tous les niveaux sélectionnés pour votre champ) ou False (Permet d'afficher le résultat du champ uniquement au niveau parent du type d'objet défini dans votre fonction)
  • En quatrième position, vous pouvez positionner une condition de filtrage pour n'appliquer le calcul que sur les lignes répondant à ce critère (Ex. [Statut]="En cours" pour n'appliquer la fonction qu'aux lignes présentant le statut "En cours")

Point d'attention : Vous ne pouvez positionner le paramètre n°4 que si une valeur est également renseignée pour le paramètre n°3

Exemples de paramétrages :

  • ChildSum("Task";[Complexité];False)
    Cette formule renvoie, uniquement au niveau action, la somme des complexités des tâches enfants
  • ChildAverage("Task";[Complexité];True;[Statut]="A faire")
    Cette formule renvoie, sur toutes les lignes de niveau supérieur des tâches présentant le statut "A faire", la moyenne des complexités des tâches enfants

Fonctions ChildCount / ChildDistinctCount

  • Types de champs pris en compte : Champ de type nombre
  • Paramètres d'entrée : 4
  • Nombre de paramètres attendus : De 2 à 4 (2 obligatoires et 2 facultatifs)

Description :

  • La fonction ChildCount permet de compter au niveau N+1, le nombre d'élément enfant N du type d'objet choisi, présentant des valeurs pour le champ défini.
  • La fonction ChildDistinctCount permet de compter au niveau N+1, le nombre d'élément enfant N du type d'objet choisi, présentant des valeurs distinctes pour le champ défini.

Paramétrage : Sélectionnez la formule ChildCount() / ChildDistinctCount() dans la liste des fonctions disponibles. Positionnez vous ensuite à l'intérieur des parenthèses de la fonction, et renseignez entre guillemets, le type d'objet des éléments à comparer (Le type d'objet est à renseigner en anglais Ex. "Task").
Une fois le type d'objet renseigné, séparez le du champ suivant avec un point-virgule, puis sélectionnez le champ à considérer dans la liste des champs disponibles.
Une fois le champ sélectionné, vous pouvez choisir de valider votre formule, ou d'ajouter des paramètres facultatifs si vous le souhaitez.

Pour rajouter des paramètres facultatifs :

  • En troisième position, vous pouvez positionner le paramètre facultatif True (Permet d'afficher le résultat du champ sur tous les niveaux sélectionnés pour votre champ) ou False (Permet d'afficher le résultat du champ uniquement au niveau parent du type d'objet défini dans votre fonction)
  • En quatrième position, vous pouvez positionner une condition de filtrage pour n'appliquer le calcul que sur les lignes répondant à ce critère (Ex. [Statut]="En cours" pour n'appliquer la fonction qu'aux lignes présentant le statut "En cours")

Point d'attention : Vous ne pouvez positionner le paramètre n°4 que si une valeur est également renseignée pour le paramètre n°3

Exemples de paramétrages :

  • ChildCount("Risk";[Clé de l'objet];True;[Statut]="Ouvert")
    Cette formule renvoie, aux niveaux Projet & Portefeuille, le nombre de risques enfant présentant le statut "Ouvert"
  • ChildCountDistinct("Task";[Ressource];True)
    Cette formule renvoie, sur toutes les lignes de niveau supérieur des tâches, le nombre de tâches présentant des ressources distinctes

Fonctions Opérateurs (AND, OR, NOT, IIF)

Fonctions AND / OR

  • Types de champs pris en compte : Tous types de champs
  • Paramètres d'entrée : 2
  • Nombre de paramètres attendus : 2 et plus

Description :

  • La fonction AND permet de vérifier 2 ou plus conditions, et positionne le booléen à vrai si toutes les conditions renseignées sont rencontrées.
  • La fonction OR permet de 2 ou plus conditions, et positionne le booléen à vrai si une ou plusieurs conditions renseignées sont rencontrées.

Point d'attention : Les fonctions AND & OR peuvent soit être utilisées seules, soit être utilisées pour préciser des conditions au sein d'autres formules

Paramétrage : Sélectionnez la formule AND() / OR() dans la liste des fonctions disponibles. Positionnez vous ensuite à l'intérieur des parenthèses de la fonction, et sélectionnez le champ sur lequel vous souhaitez appliquer une condition, dans la liste des champs disponibles.
Une fois le champ sélectionné, positionnez votre condition de vérification avec l'opérateurs de votre choix tel que égal à, supérieur/inférieur à, supérieur/inférieur ou égale à, différent de (Opérateurs : "=", ">", "<", ">=", "<=", "!=").
Une fois votre première condition renseignée, séparez la du champ suivant avec un point-virgule, puis sélectionnez le champ suivant pour la condition suivante sur le même principe que la première.
Une fois votre deuxième condition renseignée, vous pouvez choisir de valider votre formule, ou de rajouter d'autres conditions dans votre fonction.

Exemples de paramétrages :

  • AND([Date de fin]<TODAY();[Progression]<100)
    Cette formule vérifie si l'élément présente une date de fin inférieure à la date actuelle, et si sa progression est strictement inférieure à 100%
  • OR([Date de début]!=[Date début [Référence]];[Date de fin]!=[Date de fin [Référence]])
    Cette formule vérifie si la date de début de l'élément diffère de sa date de début référence, ou si sa date de fin diffère de sa date de fin référence.

Fonction NOT

  • Types de champs pris en compte : Tous types de champs
  • Paramètres d'entrée : 1
  • Nombre de paramètres attendus : 1

Description :

La fonction NOT permet de vérifier une condition, et positionne le booléen à vrai si toutes la condition renseignée n'est pas rencontrée.

Point d'attention : La fonctions NOT peut soit être utilisée seule, soit être utilisée pour préciser des conditions au sein d'autres formules

Paramétrage : Sélectionnez la formule NOT() dans la liste des fonctions disponibles. Positionnez vous ensuite à l'intérieur des parenthèses de la fonction, et sélectionnez le champ sur lequel vous souhaitez appliquer une condition, dans la liste des champs disponibles.
Une fois le champ sélectionné, positionnez votre condition de vérification avec l'opérateur de votre choix, tel que égal à, supérieur/inférieur à, supérieur/inférieur ou égale à, différent de (Opérateurs : "=", ">", "<", ">=", "<=", "!=").

Exemples de paramétrages :

  • NOT([Date de fin]=[Date de fin [Référence]])
    Cette formule vérifie si la date de fin de l'élément diffère de sa date de fin référence

Fonction IIF

  • Types de champs pris en compte : Tous types de champs
  • Paramètres d'entrée : 3
  • Nombre de paramètres attendus : 3

Description :

La fonction IIF permet de vérifier une condition, et de renvoyer une valeur souhaitée si la condition est vrai, et une autre valeur si la condition est fausse.

Point d'attention : La fonctions IIF peut soit être utilisée seule, soit être utilisée pour préciser des conditions au sein d'autres formules

Paramétrage : Sélectionnez la formule IIF() dans la liste des fonctions disponibles. Positionnez vous ensuite à l'intérieur des parenthèses de la fonction, et sélectionnez le champ sur lequel vous souhaitez appliquer une condition, dans la liste des champs disponibles.
Une fois le champ sélectionné, positionnez votre condition de vérification avec l'opérateur de votre choix, tel que égal à, supérieur/inférieur à, supérieur/inférieur ou égale à, différent de (Opérateurs : "=", ">", "<", ">=", "<=", "!=").
Une fois votre condition renseignée, renseignez un point-virgule pour la séparez de la valeur suivante, puis renseignez la valeur à renvoyer si la condition précédente est vraie (soit sous forme de valeur fixe, renseignez entre guillemets, soit sous forme de valeur variable, sous forme de champ sélectionné via les champs disponibles).
Une fois la valeur renseignée pour le cas où la condition est vraie, renseignez un point-virgule pour la séparez de la valeur suivante, puis renseignez la valeur à renvoyer si la condition précédente est fausse (soit sous forme de valeur fixe, renseignez entre guillemets, soit sous forme de valeur variable, sous forme de champ sélectionné via les champs disponibles).

Point d'attention : Si vous souhaitez ne rien renvoyer dans l'un des deux cas (vrai ou faux), vous pouvez tout simplement renseignez une valeur vide en positionnant deux guillemets "".

Exemples de paramétrages :

  • IIf(AND([Statut]!="Terminé";[Date de fin]<TODAY());"Elément en retard à compléter";"")
    Cette formule vérifie si le statut de l'élément est différent du statut "Terminé" et si sa date de fin est inférieure à la date actuelle, et affiche le message "Elément en retard à compléter" si c'est le cas

Fonctions de vérification & récupération de données (Decode, GetJoinedValue, Concat, Right, Left)

Fonction Decode

  • Types de champs pris en compte : Tous types de champs
  • Paramètres d'entrée : N ( 1 champ, X valeur(s) pour le champ & X valeur(s) à faire correspondre pour la valeur du champ)
  • Nombre de paramètres attendus : 3 ou plus

Description :

  • La fonction Decode permet de lier des valeurs texte ou numérique à des valeurs d'un autre champ.

Paramétrage : Sélectionnez la formule Decode() dans la liste des fonctions disponibles. Positionnez vous ensuite à l'intérieur des parenthèses de la fonction, et sélectionnez le champ voulu dans la liste des champs disponibles.
Une fois le champ sélectionné, séparez le de la valeur suivante avec un point-virgule, puis rajoutez entre guillemets, la valeur du champ voulue, qui servira de comparaison.
Une fois cela fait, renseignez un point-virgule, puis renseignez entre guillemets, la valeur à afficher dans le champ si le champ de comparaison, présente la valeur indiquée.
Répétez l'opération autant de fois que vous souhaitez comparer de valeur du champ dans votre fonction.

Exemples de paramétrages :

  • Decode([Priorité];"Faible";1;"Modéré";2;"Elevé";3)
    Cette formule permet de transformer les différentes priorités en valeurs numériques

Fonction GetJoinedValue

  • Types de champs pris en compte : Tous types de champs
  • Paramètres d'entrée : 2 (Clé de l'objet de de l'élément à récupérer, Champ dont on souhaite récupérer l'information)
  • Nombre de paramètres attendus : 2

Description :

  • La fonction GetJoinedValue permet de récupérer la valeur d'un champ donné pour un élément fixe en renseignant sa clé de l'objet.

Paramétrage : Sélectionnez la formule GetJoinedValue() dans la liste des fonctions disponibles. Positionnez vous ensuite à l'intérieur des parenthèses de la fonction, et renseignez entre guillemets, la clé de l'objet de l'élément dont vous souhaitez récupérer la donnée.
Une fois la clé renseignée, séparez la de la valeur suivante avec un point-virgule, puis sélectionnez dans la liste des champs disponibles, le champ dont vous souhaitez récupérer la donnée.

Exemples de paramétrages :

  • GetJoinedValue("PXXXX";[Budget €])
    Cette formule permet de récupérer le budget € du projet possédant la clé d'objet PXXX et appartenant à un portefeuille différent

Fonction Concat

  • Types de champs pris en compte : Tous types de champs
  • Paramètres d'entrée : N champs & N séparateurs
  • Nombre de paramètres attendus : 3

Description :

  • La fonction Concat permet de concaténer en un seul champ, plusieurs valeurs de champs différents avec un séparateur donné.

Paramétrage : Sélectionnez la formule Concat() dans la liste des fonctions disponibles. Positionnez vous ensuite à l'intérieur des parenthèses de la fonction, et sélectionnez le champ dont vous souhaitez récupérer la valeur, dans la liste des champs disponibles.
Une fois le champ sélectionné, séparez le champ du suivant avec un point-virgule, puis renseignez entre guillemets, le séparateurs que vous souhaitez appliquer entre vos deux champs.
Une fois le séparateur ajouté, renseignez un point-virgule, et sélectionnez votre deuxième champs dans la liste des champs disponibles.
Répétez l'opération autant de fois que vous souhaitez concaténer de champs dans votre fonction.

Exemples de paramétrages :

  • Concat([Statut];"-";[Sous-statut])
    Cette formule permet de récupérer le statut de l'élément et de le concaténer avec son sous-statut en le séparant à l'aide d'un tiret.

Fonctions Left / Right

  • Types de champs pris en compte : Tous types de champs
  • Paramètres d'entrée : 2 (Champ à prendre en compte, Nombre de caractères à partir duquel renvoyer la valeur du champ)
  • Nombre de paramètres attendus : 2

Description :

  • La fonction Left permet de récupérer une chaîne de caractère d'un champ à partir du N-ième caractère en partant de la gauche.
  • La fonction Right permet de récupérer une chaîne de caractère d'un champ à partir du N-ième caractère en partant de la droite.

Paramétrage : Sélectionnez la formule Left() / Right () dans la liste des fonctions disponibles. Positionnez vous ensuite à l'intérieur des parenthèses de la fonction, et sélectionnez le champ sur lequel vous souhaitez appliquer une condition, dans la liste des champs disponibles.
Une fois le champ sélectionné, séparez le champ du suivant avec un point-virgule, puis renseignez le nombre de caractère à partir duquel vous souhaitez prendre en compte le contenu du champ sélectionné

Exemples de paramétrages :

  • Left([Nom];5)
    Cette formule permet de récupérer le nom de l'élément à partir du 5ème caractère, en partant de la gauche.
  • Right([Nom];5)
    Cette formule permet de récupérer le nom de l'élément à partir du 5ème caractère, en partant de la droite.

Avez-vous trouvé votre réponse ?
Merci, votre avis compte !
Oops! Something went wrong while submitting the form.
IntroductionFonctions Min & MaxFonctions de dates (Year, Quarter, Month, NbDays, NbOpenDays, DateAdd, Today)Fonctions ChildFonctions Opérateurs (AND, OR, NOT, IIF)Fonctions de vérification & récupération de données (Decode, GetJoinedValue, Concat, Right, Left)

Vous ne trouvez pas ce que vous cherchez ?

Pas de soucis, vous pouvez nous contacter à support@tabsters.fr en nous précisant la nature de votre demande. Nos agents vous répondrons dans les meilleurs délais.
Nous contacter