Comment gérer les champs personnalisés calculés ?

Les champs personnalisés sont accessibles depuis le Mes Paramètres > Fonctions avancées > Personnalisation des champs | tables.

Vous pouvez créer des champs personnalisés sur différentes tables.

Depuis la fiche champ personnalisé de type numérique (entier et décimal) mais aussi mémo, texte, date et booléen, il est possible de définir une formule de calcul.

Attention
À partir du moment où une formule est définie, le champ personnalisé deviendra non saisissable (grisé).

Définition d’un champ personnalisé calculé

Depuis la fenêtre des champs personnalisés, ajouter un champ de type numérique. Dans les propriétés de droite, la zone “Formule” est disponible.

Cette zone est vide par défaut.

Pour accéder à l’éditeur de formule, cliquer sur le bouton [...] de la propriété.

L’écran de saisie des formules se divise en 2 zones principales :

• À gauche, l’éditeur de formule. Il propose une saisie semi-automatique. La combinaison de touches Ctrl + espace permet d’afficher la liste des mots clés disponibles. Cette liste sera restreinte automatiquement au cours de la frappe. Elle apparaît également automatiquement au cours de la frappe. La frappe d’un caractère non alphanumérique valide le mot clé sélectionné.
• À droite, une liste hiérarchique des mots clés. Elle présente la totalité du vocabulaire disponible. Un double clic sur une ligne insère le terme à l’endroit du curseur dans le champ de saisie. La zone de texte en dessous affiche un texte succinct décrivant le terme sélectionné.

Information
Il est possible de créer une formule de calcul en n’utilisant que cette liste.

Seules les valeurs littérales doivent être saisies au clavier.

Exemple
Formule : Article.PV_HT * Ligne.Quantite_reelle.

Pour enregistrer la formule de calcul, vous devez cliquer sur Valider.

Vous avez la possibilité d'annuler ou refaire les dernières saisies.

Si vous souhaitez supprimer la fiche formule, vous devez cliquer sur le bouton "croix rouge".

Si la formule est incorrecte, sa validation sera refusée et un conseil sera donné pour les erreurs simples.

Exemple
Si l’utilisateur tente de valider la formule suivante : (Article.PV_HT*Ligne.Quantite_reelle
Un message d’information s'affiche :
Informations
Erreur de syntaxe à la ligne 1 : ’r;()’
Il manque une parenthèse fermante.

Une formule de calcul peut évaluer plusieurs expressions et stocker des résultats intermédiaires dans des variables. Par contre, elle doit se terminer par une expression qui permet d’évaluer une valeur à attribuer au champ personnalisé calculé.

Une formule de calcul peut contenir des commentaires.

Une fois la formule de calcul réalisée, vous avez la possibilité de contrôler la formule par le bouton "Tester". Si des valeurs sont à renseigner, une fenêtre intermédiaire permettra de saisir ces valeurs. Suite à cette saisie, le résultat de la formule est affiché dans un message.

Condition de recalcul du champ perso calculé

Les champs personnalisés calculés sont automatiquement recalculés si la valeur d’un des champs de leur formule de calcul est modifiée, à condition que la donnée modifiée soit ”locale” (présent sur la fiche contenant le champ perso calculé).

Exemple
Un champ personnalisé calculé sur une ligne de document dont la formule serait :
(Ligne.Quantite*Article.PV_HT)/Document.Montant_HT*100
Cette formule calcule le % que représente le montant d’une ligne par rapport au montant total du document.
La valeur sera automatiquement recalculée si les valeurs de Ligne.Quantite ou Document.Montant_HT changent. Par contre, si Article.PV_HT, ses données n’étant pas tenues à jour "localement", le calcul automatique ne pourra pas être déclenché ; en d’autres termes, le document n’est pas au courant des modifications de la fiche élément.

Les champs personnalisés calculés ne sont pas rétroactifs.

Ils seront calculés sur les fiches existantes si ces fiches sont sélectionnées lors d’un clic sur le bouton “Actualiser les champs personnalisés calculés”.

Information
Si la table ne contient pas de champ personnalisé calculé, le bouton n’est pas affiché.

Les champs personnalisés sont également disponibles pour les formules de calculs.
Les éventuelles références circulaires sont aussi détectées dès la validation de la formule.

Exemple
2 champs perso nommés perso 1 et perso 2
xx_perso_1 = Ligne.Quantite_reelle + Ligne.xx_perso_2
xx_perso_2 = Ligne.Quantite_reelle + Ligne.xx_perso_1
La validation de la deuxième formule sera refusée, car elle déclencherait une boucle infinie.