Champs formule

Un champ formula ne stocke rien que quelqu'un saisit. Sa valeur est calculée à partir d'une expression référençant d'autres champs du même enregistrement, et elle est recalculée dès que l'une de ces entrées change.

- { id: 1, name: total_price, type: formula, formula: 'price * quantity', resultType: number }

Comme tous les types de champs, formula accepte aussi les propriétés de base des champs.

Un montant calculé par une formule

Une formule portant sur des champs monétaires reste de la monnaie, mais elle n'hérite pas de la devise des champs qu'elle référence. Une expression peut en toucher plusieurs, ou aucune : il n'y aurait donc rien à hériter sans deviner. Déclarez le code :

- id: 12
  name: unit_price
  type: currency
  currency: EUR
  precision: 2
- id: 27
  name: stock_value
  type: formula
  formula: unit_price * stock_on_hand
  resultType: number
  format: currency
  currency: EUR

Sans currency, le montant s'affiche avec la valeur par défaut USD — c'est ainsi qu'une colonne stock_value a fini par afficher $224,430.90 à côté du €28.63 dont elle était calculée.

Les cinq propriétés d'affichage — currency, precision, symbolPosition, negativeFormat, thousandsSeparator — sont exactement celles qu'accepte un champ currency, avec un comportement identique.

Ce qui est vérifié, et ce qui ne l'est pas

resultType et format sont des chaînes libres, pas des vocabulaires fermés. Les valeurs d'usage sont string, number, boolean et date pour la première, currency, percentage, decimal et date pour la seconde — mais le schéma accepte n'importe quelle chaîne et n'en valide aucune. Une faute de frappe passe donc sovrium validate et se révèle plus tard comme une surprise de rendu plutôt que comme une erreur.

Les cinq propriétés d'affichage monétaire font exception : elles sont validées, et une valeur invalide est refusée au décodage de la configuration.

formula elle-même est vérifiée sur les références de champs qu'elle fait : une expression nommant une colonne absente de la table échoue au décodage.

Composer une référence lisible

autonumber n'accepte délibérément ni préfixe ni remplissage. Une formule est l'endroit où cette présentation se déclare :

- { id: 3, name: invoice_number, type: autonumber }
- id: 4
  name: invoice_reference
  type: formula
  formula: "'INV-' || LPAD(invoice_number::text, 5, '0')"
  resultType: string

Garder la séquence et sa présentation séparées permet de changer le format de la référence sans toucher aux numéros déjà attribués.

Une colonne calculée n'est pas modifiable

formula est dérivée, comme count, rollup et lookup. Elle se recalcule à partir de ses entrées et n'est pas accessible en écriture, ni par l'API des enregistrements ni par un formulaire : une écriture qui la nomme est refusée plutôt que silencieusement ignorée, parce qu'une valeur qui semble enregistrée sans l'être est la pire des deux défaillances.

Pages connexes

• Champs comptage et numérotation — count et autonumber, les deux autres colonnes que le moteur remplit.
• Champs bouton — le champ interactif qui déclenche une URL ou une automatisation.
• Champs relationnels — relationship, lookup et rollup.
• Présentation des types de champs — tous les types par catégorie.