Comment ajouter des formules à vos tableaux RowShare ?

Les formules RowShare sont basées sur la valeur des autres cellules de la même ligne. Ajoutez une colonne "Formule" et spécifiez la formule dans les paramètres de cette colonne. Oui, cela signifie que la formule sera toujours la même dans une colonne donnée.

Commencez par ajouter une nouvelle colonne à votre tableau, et cliquez sur "Formules" puis décidez si votre formule renverra du texte ou un nombre. Nommez votre colonne, cliquez sur Ajouter et faites défiler vers le bas pour entrer la formule:

Les formules référencent les autres colonnes entre apostrophes comme cet exemple : 'Colonne A' + 'Colonne B'

Une formule peut aussi référencer une colonne qui contient elle-même une formule. Cela permet de découper un calcul en plusieurs colonnes successives, comme dans un tableur.

Quand une formule devient difficile à relire, découpez-la : une colonne par étape de calcul, la dernière assemblant le résultat. Les colonnes intermédiaires peuvent être masquées.

En plus de référencer d'autres colonnes, les formules peuvent inclure des opérateurs et des fonctions.

Des opérateurs

Les 4 opérations mathématiques standard: +, -, *, /
L'opérateur "&" pour concaténer du texte
Les Opérateurs de comparaison:>, <,> =, <=, =, !=, <> (Les deux derniers sont équivalents et signifient "non égal")
Condition1 And Condition2 ou bien Condition1 && Condition 2 ou encore And(Condition1, Condition2) : renvoie vrai si les deux conditions sont vraies
Condition1 Or Condition2 ou bien Condition1 || Condition2 ou encore Or(Condition1, Condition2) : renvoie vrai si au moins une condition est vraie
Not Condition ou !Condition : inverse un booléen. vrai renvoie faux et faux renvoie vrai

Des fonctions

RowShare propose des fonctions supplémentaires pour manipuler les nombres, le texte, les dates et ajouter des capacités logiques.

Nombres

Max/Min(Nombre1, Nombre2, …) renvoie la plus grande/petite valeur
Sum(Nombre1, Nombre2, ...) renvoie la somme des valeurs
Average(ValeursOuTable[, Colonne]) renvoie la moyenne arithmétique
Abs(Nombre) renvoie la valeur absolue de Nombre
Round(Nombre, Décimales) arrondit Nombre au nombre de Décimales
RoundUp(Nombre, Décimales) arrondit Nombre à l’éloignement de zéro
RoundDown(Nombre, Décimales) arrondit Nombre en direction de zéro
Sqrt(Nombre) renvoie la racine carrée
RandBetween(BorneInférieure, BorneSupérieure) renvoie un entier aléatoire compris entre les bornes (incluses)
Text(Nombre, Format) formate Nombre suivant un des nombreux formats prédéfinis. Consulter la liste des formats.
Temps
Today() renvoie la date du jour (sans heure)
Now() renvoie la date et l’heure actuelles
Date(Année, Mois, Jour) construit une date à partir de ses composantes
DateAdd(DateHeure, NombreUnités, Unité) décale DateHeure du nombre d’Unités
DateDiff(DateHeureDébut, DateHeureFin, Unité) renvoie l’écart entre deux instants en Unité
DateValue(Texte[, CodeLangue]) convertit du Texte en valeur de date
Year(DateHeure) renvoie l’année
Month(DateHeure) renvoie le mois (1–12)
Day(DateHeure) renvoie le jour du mois (1–31)
Weekday(DateHeure[, PremierJourDeLaSemaine]) renvoie le numéro du jour de la semaine (1–7)
Text(Date, Format) formate Date suivant un des nombreux formats prédéfinis. Consulter la liste des formats.

Les unités de temps sont les suivantes : TimeUnit.Seconds, TimeUnit.Minutes, TimeUnit.Hours, TimeUnit.Days, TimeUnit.Months, TimeUnit.Quarters, TimeUnit.Years. Par défaut, ce sera TimeUnit.Days.

Il n'existe pas de fonction de fin de mois. Pour obtenir le dernier jour du mois d'une date, partez du premier jour de ce mois, ajoutez un mois, puis retirez un jour :
DateAdd(DateAdd(Date(Year('Ma date'), Month('Ma date'), 1), 1, TimeUnit.Months), -1, TimeUnit.Days)

Texte
Len(Texte) renvoie le nombre de caractères
Left(Texte, NombreDeCaractères) renvoie les premiers caractères
Right(Texte, NombreDeCaractères) renvoie les derniers caractères
Mid(Texte, PositionDépart[, NombreDeCaractères]) renvoie une sous-chaîne à partir d’une position
Lower(Texte) met en minuscules
Upper(Texte) met en majuscules
Trim(Texte) supprime les espaces superflus (début/fin + multiples internes)
Substitute(Texte, Ancien, Nouveau[, Occurrence]) remplace Ancien par Nouveau (option : seulement la Occurrence nᵒ)
Find(TexteCherché, DansTexte[, PositionDépart]) renvoie la position de TexteCherché (sensible à la casse)
StartsWith(Texte, Préfixe) teste si Texte commence par Préfixe
Split(Texte, Séparateur) divise en table à une colonne selon le Séparateur
Concatenate(Texte1, Texte2, …) ou Texte1 & Texte2 concatène des chaînes
IsMatch(Texte, Modèle[, Options]) teste si Texte correspond au Modèle (type regex-like)
Coalesce(Texte1, Texte2, …) renvoie le premier texte non vide

Logique

If(Condition1, Résultat1[, Condition2, Résultat2, …[, RésultatParDéfaut]]) renvoie le Résultat de la première condition vraie
Switch(Expression, Correspondance1, Résultat1[, …[, ParDéfaut]]) compare Expression à des Correspondances (égalité) et renvoie le Résultat associé
With(Variables, Formule) définit une ou plusieurs valeurs nommées et les utilise dans Formule
And(Condition1, Condition2, …) renvoie vrai si toutes les conditions sont vraies
Or(Condition1, Condition2, …) renvoie vrai si au moins une condition est vraie
Not(Booléen) ou !(Booléen) renvoie la négation logique
Coalesce(Valeur1, Valeur2, …) renvoie la première valeur non-blank

With évite de répéter la même expression à plusieurs endroits d'une formule. Par exemple :
With({total: 'Quantité' * 'Prix unitaire'}, If(total > 1000, total * 0.9, total))
Le total n'est calculé qu'une fois, et une modification ne se reporte qu'à un seul endroit.

Tests sur les valeurs

IsBlank(Valeur) renvoie vrai si la valeur est Blank()
Blank() produit une valeur vide (utile pour effacer un champ)
IfError(Valeur, Secours[, Valeur2, Secours2, …]) renvoie Secours si l’évaluation échoue
IsMatch(Texte, Modèle[, Options]) renvoie vrai si Texte correspond au Modèle

Une cellule vide vaut Blank(). Blank() ne se comporte pas de la même façon selon le contexte : dans un calcul, 0 + Blank() vaut 0, mais dans une comparaison, Blank() = 0 est faux. Pour détecter une cellule vide, utilisez IsBlank plutôt qu'une comparaison.

IsBlank ne renvoie jamais vrai sur une colonne Formule : une formule numérique sans résultat renvoie 0, et non Blank(). Réservez IsBlank aux colonnes saisies, et testez la valeur elle-même, par exemple = 0, sur les colonnes calculées.

Exemples :
- pour afficher 1 dans une cellule si une autre est positive et -1 quand elle est nulle ou négative, écrivez If('COL1' > 0, 1, -1). Vous aurriez aussi putiliser Abs('COL1') pour obtenir le même résultat.

Il est possible d'ajouter des commentaires, ce qui peut être très utile dans les formules complexes. Dans une formule, commencez une ligne par // pour qu'elle soit ignorée. Vous pouvez alors y écrire un commentaire.
Exemple :

// si la colonne TVA est cochée, multiplier le prix par 1,2
'Price' * If('VAT', 1.2, 1)

Ce qui n'existe pas

Une formule ne voit que les colonnes de sa propre ligne. Les fonctions qui parcourent une table ou une liste de valeurs ne sont pas disponibles : ni ForAll, ni Filter, ni LookUp, ni Concat.

Sum, Max, Min et Average portent sur les valeurs passées en arguments, dans la même ligne. Sum('Montant') renvoie le montant de la ligne courante, et non la somme de la colonne Montant.

Une formule ne peut pas additionner plusieurs lignes, ni les lignes des tableaux enfants. Pour un total sur plusieurs lignes, l'analyse par colonne l'affiche à l'écran, RowMerge et Zapier permettent de le réutiliser ailleurs.

Notes importantes

Les valeurs calculées ne fonctionnent pas si les noms de colonne référencés incluent l'un des caractères suivants:
- . (point)
- \ (antislash)
- [ (crochet ouvrant)
- ] (crochet fermant)
Si un nom de colonne contient une apostrophe, doublez-la dans la formule. La colonne Quel est l'horizon de placement ? s'écrit donc 'Quel est l''horizon de placement ?'.
Vous pouvez afficher une formule comme un pourcentage, un texte coloré ou toute autre capacité de mise en forme de RowShare. Créez une colonne avec les options d'affichage de votre choix, puis dans ses paramètres, activez l'option "Formule".