Maîtriser les formules Planisware

Le puissant concept de “Formule” introduit par Planisware est au cœur du paramétrage de l’application. Ce concept est en effet utilisé dans la majorité des fonctionnalités de la solution logicielle d’entreprise pour la gestion de portefeuille projets et produits de Planisware.

On retrouve ainsi l’utilisation des formules dans :

• Les tables pour réaliser des filtres,
• Les formules nommées pour enregistrer une formule,
• Les paramètres de l’application pour utiliser une valeur calculée et dynamique,
• Les rapports pour réaliser des filtres ou afficher des données,
• Les actions multiples, les tables et champs coûts, etc…

Ce système est donc un concept indispensable à maîtriser lorsque l’on réalise des tâches de paramétrage de l’application ou d’administration avancées.

Dans cet article, nous vous proposons de vous présenter la syntaxe des formules Planisware et leur utilisation.

Une formule Planisware est symbolisée par une grammaire évaluée par le moteur Planisware afin d’en retourner un résultat calculé. Ainsi une formule évaluée peut retourner n’importe quel type primitif Planisware et avoir un résultat différent selon le contexte utilisateur ou temporel.

Par exemple, dans le cas d’un filtre, la formule devra retourner une valeur booléenne afin de savoir si l’information doit ou non être affichée selon des critères dynamiques.

Les types primitifs

Les opérateurs de comparaison

Les opérateurs arithmétiques

Les opérateurs logiques

La priorisation de l’évaluation des critères du filtre se fait à l’aide des parenthèses () et crochets [].

1+2 * 3 = 7
(1+2) * 3 = 9

Parenthèses ou crochets ? Dans le cas du paramétrage d’un tableau, les crochets permettent de réaliser des filtres invisibles à l’utilisateur. Ainsi la colonne sur laquelle un filtre est positionné, ne s’affichera pas en bleu. L’utilisateur ne se doutera donc pas de la présence d’un filtre.

Les chaînes de caractères

Afin d’être interprétées comme telles, les chaînes de caractères au sein des formules Planisware doivent être entourées par des guillemets “”.
Les opérations d’égalité ou d’inégalité ne font pas de distinction entre un mot en majuscule et un autre en minuscule. Ainsi, le résultat de la formule ci-dessous sera toujours VRAI :

"PLANISWARE" = "planisware"

Le point d’interrogation ‘?’ permet de remplacer un caractère. L’étoile ‘*’ permet de remplacer n’importe quel nombre de caractères. Ainsi, le résultat de la formule ci-dessous retourne toujours VRAI :

"PLANI*RE" = "planisware"

Les nombres

Les nombres peuvent s’utilisent comme dans les équations mathématiques simples.

Les booleens

Les valeurs usuelles des booléens dans Planisware sont les suivantes :

• Lorsque la condition est remplie: TRUE, VRAI, YES
• Sinon : FALSE, FAUX, NO
  Si l’on adjoint l’opérateur « NOT » (ou NON) devant une valeur booléenne, le résultat en sera le contraire.
  Exemple:

  (NOT TRUE) = FALSE

Les dates

Les dates s’utilisent entre guillemets simples ‘ ‘. Le format des dates est celui qui est spécifié dans les paramètres utilisateurs (Menu « Dates/unités / Autres formats »).
Par exemple, si le format de date est JJ/MM/AAAA, vous pourrez utiliser la date du 24 décembre 2010 de cette façon :

‘24/12/2010’

Les Durées

Les durées s’expriment comme les dates entre guillemets simples ‘ ‘. Le format d’une durée dépend du format de durée par défaut. Par exemple, si le format de durée par défaut est ‘DDjdHhMMm’, alors il est possible d’écrire une durée de cette forme : ‘30j7h30m‘
Pour une durée de 3 jours, on écrira la formule « ’3j’ ».
Pour ajouter ou soustraire une durée à une date, on peut utiliser les opérateurs mathématiques.

‘24/12/2010’ - ‘3j’ = ‘21/12/2010’

Définir plusieurs critères

Il est possible de combiner plusieurs critères à l’aide des opérateurs AND et OR.
Dans l’exemple suivant, nous recherchons l’ensemble des projets actifs commencant par la lettre “A”.

STATUS = "Active" AND NAME = "a*"

Les formules conditionnelles

IF [CRITERE] THEN [ACTION1] ELSE [ACTION2] FI

Permet de réaliser une action en fonction d’un ou plusieurs critères.
Exemple :

IF $current_date = DEBUT_MOIS($current_date) THEN “DEBUT” ELSE “EN COURS” FI

Si la date du jour est le 1er jour du mois, alors renvoyer « DEBUT » sinon renvoyer « En cours ».

NAME IN (“PROJET”, “PROJECT”)

L’opérateur IN est utilisé pour rechercher une valeur dans une liste.

Les fonctions

Une fonction Planisware permet d’exécuter un traitement ou de calculer une valeur. Cette valeur peut être conditionnée par les arguments passés à la fonction.

DEBUT_MOIS(‘21/12/2010’)

L’exemple ci-dessus, montre l’utilisation de la fonction “DEBUT_MOIS” retournant la date du début du mois en fonction de la date passée en argument.

Les variables globales

Les variables globales sont des mots clés introduits par le noyau Planisware. Ces variables commencent toutes par le signe $current_user = “USER01”
L’exemple ci-dessus permet donc de vérifier que l’utilisateur affichant la page est bien l’utilisateur N°1 (login: USER01).
La liste ci-dessous présente les variables globales Planisware les plus courantes :

• \]">CURRENT_DATE : (Date) Permet de récupérer la valeur de la date courante (Time Now)
• CURRENT_USER : (String) Retourne le nom de l’utilisateur actuel
• LANGUAGE : (String) Retrouve la langue définie pour l’utilisateur courant
• OPX2PRO_MODE : (Booléen) Vrai si le traitement est exécuté depuis le client Planisware
  Pro

Pour conclure

Pour aller plus loin dans le concept des formules Planisware, n’hésitez pas à parcourir l’éditeur de formule Planisware qui présente l’ensemble des champs, variables ou fonctions disponibles dans le contexte où vous écrivez votre formule.

Vous retrouverez tous ces concepts et bien plus encore dans notre formation “Configurer et administrer Planisware”. Nos programmes de formation peuvent être dispensés sur votre lieu de travail ou dans nos centres de formation partenaires.