Tous les opérateurs et fonctions des formules Quire Permalink
Ce guide constitue une référence complète de tous les opérateurs et fonctions pris en charge par les formules Quire, avec des explications claires et des exemples concrets pour vous aider à construire des calculs puissants, des conditions et une logique de tâche.
Opérateurs numériques
Les opérateurs numériques permettent d’effectuer des calculs sur les valeurs stockées dans les champs numériques.
| Opérateurs | Ce qu’il fait | Exemple |
|---|---|---|
| + | Additionner des valeurs | timeSpent + 100 |
| - | Soustraire des valeurs | Cost - 100 |
| * | Multiplier des valeurs | Cost * 100 |
| / | Diviser des valeurs | Cost / 100 |
| % | Calculer le reste | Cost % 3 |
| ^ | Calculer la puissance | Cost ^ 3 |
Remarque : Vous devez créer un champ personnalisé numérique (par ex. Cost) avant de l’utiliser dans des formules.
Opérateurs de texte
Les opérateurs de texte permettent de fusionner ou de concaténer des chaînes de texte en un seul résultat.
| Opérateurs | Ce qu’il fait | Exemple |
|---|---|---|
| + | Concaténer du texte | 'This is' + 'a task' |
Opérateurs de comparaison
Les opérateurs de comparaison renvoient true ou false selon la relation entre deux valeurs.
| Opérateurs | Signification | Exemple |
|---|---|---|
| < | Inférieur à | 3 < 1 -> False |
| > | Supérieur à | 4 > 3 -> True |
| <= | Inférieur ou égal à | 4 <= 2 -> False |
| >= | Supérieur ou égal à | 5 >= 1 -> True |
| = | Égal à | 2 = 2 -> True |
| != | Différent de | 3 != 2 -> True |
Opérateurs logiques
not
Inverse un résultat vrai/faux.
Exemple :
Not (Cost > 50)
Si Cost est supérieur à 50, le résultat est false. Dans le cas contraire, il renvoie true.
Remarque : Vous devez créer un champ personnalisé numérique (par ex. Cost) avant de l’utiliser dans des formules.
in
Utilisez in pour vérifier si les valeurs de la première liste sont entièrement contenues dans la seconde liste.
Exemple :
assignees in subtasks.assignees
Renvoie true si toutes les attributions de la tâche sont également attribuées à ses sous-tâches.
&
Trouve et renvoie les valeurs communes entre deux listes.
Exemple :
assignees & subtasks.assignees
Renvoie les attributions partagées par la tâche et ses sous-tâches.
and
Évalue toutes les conditions et renvoie true uniquement si chaque condition est remplie.
Exemple :
(Cost > 50) and (due > <today>)
Remarque : Vous devez créer un champ personnalisé numérique (par ex. Cost) avant de l’utiliser dans des formules.
or
Vérifie chaque condition et renvoie true si l’une d’elles a une valeur.
Exemple :
Cost or Budget
Remarque : Vous devez créer un champ personnalisé numérique (par ex. Cost) avant de l’utiliser dans des formules.
Opérateurs de liste
[field, field]
Utilisez les crochets pour combiner plusieurs valeurs en une liste.
Exemple :
[me, #23.assignees, subtasks.assignees]
Renvoie une liste comprenant moi-même, les attributions assignées à la tâche portant l’ID#23 et toutes les attributions des sous-tâches.
Découvrez-en plus sur les formules de tableau de Quire qui vous permettent de lister ou d’effectuer des calculs sur un ensemble de données.
field[index]
Accédez aux éléments d’une liste par leur index (à partir de 0).
Exemple :
subtasks[3]
Renvoie la 4e sous-tâche.
order by
Trie les tâches selon un champ spécifié.
Exemple :
subtasks order by any.Cost
Renvoie une liste des sous-tâches classées selon les valeurs de leur champ Cost.
Remarque : Vous devez créer un champ personnalisé numérique (par ex. Cost) avant de l’utiliser dans des formules.
Conseil : Vous pouvez également préciser l’ordre de tri en ajoutant asc ou desc à la fin de l’expression. Par exemple : subtasks order by any.Cost asc.
map
Applique un calcul à chaque élément d’une liste.
Exemple :
subtasks map any.Cost * 2
Renvoie une liste des valeurs du champ Cost des sous-tâches, multipliées par 2.
Remarque : Vous devez créer un champ personnalisé numérique (par ex. Cost) avant de l’utiliser dans des formules.
Conseil : Vous pouvez utiliser l’identifiant any avec l’opérateur map pour désigner le champ sur lequel effectuer le calcul.
Opérateurs conditionnels
??
Vérifie si la tâche correspond à l’expression placée avant ?? et renvoie une valeur vrai/faux. Si la tâche ne correspond pas à l’expression, renvoie la valeur de l’expression placée après ??.
Exemple :
(Cost > 10) ?? 'Reconsider'
Si la valeur du champ Cost est supérieure à 10, le résultat sera true. Si elle est inférieure à 10, le résultat sera false. Lorsqu’aucune valeur n’est saisie dans Cost, le résultat affichera « Reconsider ».
Remarque : Vous devez créer un champ personnalisé numérique (par ex. Cost) avant de l’utiliser dans des formules.
?:
Vérifie si la tâche correspond à l’expression placée avant ? et renvoie l’expression après ?. Si la tâche ne correspond pas à l’expression avant ?, renvoie l’expression après :.
Exemple :
(Cost > 10) ? 'Too expensive': 'Reconsider'
Si la valeur du champ Cost est supérieure à 10, le résultat affichera « Too expensive ». Si elle est inférieure à 10 ou si aucune valeur n’est saisie, le résultat affichera « Reconsider ».
Remarque : Vous devez créer un champ personnalisé numérique (par ex. Cost) avant de l’utiliser dans des formules.
Filtrage et limitation des résultats
where
Filtre les tâches répondant à des critères spécifiques.
Exemple :
subtasks where any.Cost > 10
Les sous-tâches dont la valeur de coût est supérieure à 10 seront listées.
Remarque : Vous devez créer un champ personnalisé numérique (par ex. Cost) avant de l’utiliser dans des formules.
Conseil : Vous pouvez utiliser l’identifiant any avec l’opérateur where pour désigner le champ à filtrer.
limit
Limite le nombre de tâches renvoyées après le tri.
Exemple :
subtasks order by desc any.timeSpent - any.estimated limit 3
Cela listera les 3 meilleures sous-tâches dont le temps passé est supérieur au temps estimé.
Priorité des opérateurs
Dans certains cas, l’ordre des calculs peut affecter la valeur de retour de la formule, c’est pourquoi il est important de comprendre l’ordre des opérations dans Quire. Si vous combinez différents opérateurs dans une formule, Quire effectuera les opérations dans l’ordre indiqué dans le tableau ci-dessous. Si la formule contient des opérateurs de même priorité, Quire calculera de gauche à droite.
| Opérateur | Description |
|---|---|
( ).[ ]( ) |
Parenthèses Opérateur point Liste (tableau) Appel de fonction |
+ - not |
Opérateurs unaires |
^ |
Exponentiation |
* / % |
Multiplication et division |
+ - |
Addition et soustraction |
< > <= >= in & |
Opérateurs de comparaison |
= != |
Opérateurs d’égalité |
not |
Opérateur logique not |
and |
Opérateur logique and |
or |
Opérateur logique or |
?? |
Opérateur conditionnel |
where |
Opérateur de filtre |
?: |
Opérateur conditionnel |
Toutes les fonctions intégrées
| Fonction | Description | Exemple | Résultats attendus |
|---|---|---|---|
| SUM() | Renvoie le total des valeurs. | SUM(subtasks.estimated) |
Additionne toutes les valeurs du champ Estimation des sous-tâches de la tâche. |
| MAX() | Renvoie la valeur la plus grande d’un ensemble de valeurs. | MAX(subtasks.estimated) |
Affiche la valeur la plus élevée parmi les champs Estimation des sous-tâches de la tâche. |
| MIN() | Renvoie la valeur la plus petite d’un ensemble de valeurs. | MIN(subtasks.estimated) |
Affiche la valeur la plus basse parmi les champs Estimation des sous-tâches de la tâche. |
| AVG() | Renvoie la valeur moyenne des nombres. | AVG(subtasks.estimated) |
Calcule la moyenne des champs Estimation des sous-tâches de la tâche. |
| COUNT() | Renvoie le nombre d’éléments. | COUNT(subtasks) |
Affiche le nombre total de sous-tâches. |
| SORT() | Renvoie les arguments dans un ordre trié. | SORT(subtasks.estimated) |
Affiche toutes les valeurs des champs Estimation des sous-tâches de la tâche dans un ordre trié. |
| DISTINCT() | Supprime les valeurs dupliquées et ne renvoie que les valeurs distinctes. | DISTINCT(subtasks.estimated) |
Affiche toutes les valeurs distinctes des champs Estimation des sous-tâches de la tâche en éliminant les doublons. |
| ISEMPTY() | Vérifie si les arguments en entrée sont vides ou non et renvoie une valeur vrai/faux. | ISEMPTY(estimated) |
Si le champ Estimation de la tâche est vide, une case à cocher cochée s’affiche. |
| ISNOTEMPTY() | Vérifie si les arguments en entrée sont vides ou non et renvoie une valeur vrai/faux. | ISNOTEMPTY(estimated) |
Si le champ Estimation de la tâche n’est pas vide, une case à cocher cochée s’affiche. |
Questions fréquemment posées
Quels opérateurs arithmétiques puis-je utiliser dans les formules Quire ?
Quire prend en charge +, -, *, /, % (reste) et ^ (puissance). Vous devez créer un champ personnalisé numérique avant de le référencer dans une formule.
Quelles fonctions intégrées sont disponibles dans les formules Quire ?
Quire inclut SUM(), MAX(), MIN(), AVG(), COUNT(), SORT(), DISTINCT(), ISEMPTY() et ISNOTEMPTY(). Consultez la référence complète dans Toutes les fonctions intégrées.
Comment fonctionne la priorité des opérateurs dans les formules Quire ?
Quire évalue les opérateurs dans cet ordre : les parenthèses et opérateurs point/liste en premier, puis l’exponentiation, la multiplication/division, l’addition/soustraction, la comparaison, les opérateurs logiques, et enfin les opérateurs conditionnels. Utilisez des parenthèses pour modifier l’ordre par défaut.
Comment écrire une formule IF/conditionnelle dans Quire ?
Utilisez ?: pour un conditionnel à deux résultats — (Cost > 10) ? 'Too expensive' : 'Reconsider'. Utilisez ?? comme repli uniquement lorsque le champ est vide.
Comment filtrer les sous-tâches par valeur de champ dans une formule Quire ?
Utilisez l’opérateur where — subtasks where any.Cost > 10 renvoie les sous-tâches dont Cost dépasse 10. Combinez avec limit pour limiter le nombre de résultats.
Comment trier ou réorganiser une liste dans une formule Quire ?
Utilisez order by — subtasks order by any.Cost trie selon le champ Cost. Ajoutez asc ou desc pour contrôler le sens.
Comment appliquer un calcul à chaque élément d’une liste dans une formule Quire ?
Utilisez l’opérateur map — subtasks map any.Cost * 2 multiplie la valeur Cost de chaque sous-tâche par 2.