Question 1

Comment utiliser les formules dans Quire ?

Accepted Answer

Pour utiliser les formules dans Quire, commencez par créer un champ personnalisé de type Formule dans votre projet. Une fois créé, saisissez une formule qui référence des Champs intégrés ou des Champs personnalisés existants et retourne un résultat calculé. Par exemple, la formule `timeSpent/2` divise l'Heure passée sur une Tâche par 2. Quire calcule automatiquement la valeur pour chaque Tâche et affiche le résultat dans le champ personnalisé que vous avez créé. Vous pouvez également utiliser des opérateurs arithmétiques, des fonctions, des valeurs littérales et des identifiants pour des Tâches, des Membres et des Étiquettes afin de construire des Formules plus avancées. Avec la Souscription Free, vous pouvez ajouter un champ de Formule par projet. Passer à une Souscription supérieure vous permet d'ajouter davantage de champs de Formule. Ce guide couvre la syntaxe complète, notamment les opérateurs, les fonctions et les options de mise en forme, pour vous permettre de construire des calculs aussi simples ou complexes que nécessaire.

Question 2

Quels calculs puis-je effectuer dans les formules Quire ?

Accepted Answer

Les Formules Quire prennent en charge quatre opérateurs arithmétiques de base : l'addition (+), la soustraction (-), la multiplication (*) et la division (/). Vous pouvez les combiner pour calculer des valeurs telles que la durée d'une Tâche ; par exemple, `due - start` soustrait la Date de début d'une Tâche de sa Date d'échéance. Utilisez des parenthèses pour contrôler l'ordre des calculs. Dans la formule `(due - start) * 2`, la soustraction s'effectue en premier, puis la multiplication par 2. Pour des calculs plus avancés, Quire prend également en charge des fonctions intégrées, comme `SUM(timeSpent, estimated)`, qui additionne l'Heure passée et l'Heure d'Estimation d'une Tâche. Vous pouvez aussi utiliser des opérateurs de comparaison pour obtenir des résultats logiques plutôt que des Nombres. Par exemple, la formule `priority >= high` vérifie si la Priorité d'une Tâche est définie sur Haute ou au-dessus et retourne vrai ou faux en conséquence. Ces opérateurs et fonctions peuvent être combinés au sein d'un même champ de Formule pour construire des calculs plus avancés.

Question 3

Comment référencer un champ personnalisé dont le nom contient des espaces dans une formule Quire ?

Accepted Answer

Pour référencer un champ personnalisé dont le nom contient des espaces, mettez le nom du champ entre des accolades. Par exemple, `{Schedule Variance} * 2` multiplie la valeur du champ Schedule Variance par 2. Les noms de champs sans espaces peuvent être référencés directement, sans accolades, comme `Cost * 2`. Les noms de champs contenant d'autres caractères spéciaux, notamment `@`, `#` et `&`, doivent également être mis entre des accolades pour être lus correctement. Les noms de champs dans les Formules Quire ne sont pas sensibles à la casse, donc écrire `cost` ou `Cost` fait référence au même champ. Lors de la dénomination d'un champ personnalisé, évitez d'utiliser des guillemets, des barres obliques inverses et des accolades dans le nom du champ lui-même, car ces caractères sont réservés à la syntaxe des Formules. Cela s'applique que vous construisiez un calcul simple ou que vous référenciez plusieurs Champs personnalisés ensemble dans une seule Formule.

Question 4

Comment inclure du Texte dans le résultat d'une formule Quire ?

Accepted Answer

Pour inclure du Texte dans un résultat de Formule, encadrez la chaîne de Texte de guillemets. Par exemple, la Formule `id + ":" + name` combine les champs ID et Nom d'une Tâche avec un deux-points entre les deux, les affichant comme une seule chaîne combinée. Vous pouvez utiliser des guillemets simples ou doubles autour du Texte, et plusieurs chaînes de Texte placées les unes à côté des autres sont automatiquement concaténées. Par exemple, `'first' "second"` produit le même résultat que `'first second'`, joignant les deux chaînes avec un espace. Cela permet de combiner du Texte littéral avec des valeurs de champs dans n'importe quel ordre, par exemple en ajoutant des libellés, des séparateurs ou des unités autour d'un Nombre calculé. La mise en forme du Texte suit les mêmes règles de valeur littérale utilisées dans toutes les Formules Quire : les guillemets indiquent toujours que le Contenu encadré doit être traité comme du Texte brut plutôt que comme une référence de champ ou un opérateur.

Question 5

Comment référencer une Tâche, un Membre ou une Étiquette spécifique dans une formule Quire ?

Accepted Answer

Les Formules Quire vous permettent de référencer des Tâches, des Membres et des Étiquettes spécifiques à l'aide d'identifiants. Utilisez `#task_id` pour référencer une Tâche ; par exemple, `#23.due` retourne la Date d'échéance de la Tâche d'ID 23. Utilisez `@member_username` pour référencer un Membre, et `#tag_name` pour référencer une Étiquette. Aucun espace n'est autorisé entre le symbole `#` et l'identifiant lui-même. Si le Nom d'une Étiquette contient des espaces ou des caractères spéciaux tels que des points, des dièses ou des Nombres, mettez le Nom de l'Étiquette entre guillemets ; par exemple, `#"depending on"` pour une Étiquette nommée depending on. De même, si le nom d'utilisateur d'un Membre contient un point, un tiret ou un trait de soulignement, mettez-le entre accolades pour que Quire le lise correctement. Vous pouvez également référencer un projet entier avec `#{project_id}`, mais cet identifiant ne fonctionne que dans le champ de description de la Vue d'ensemble de l'organisation et ne peut pas être utilisé dans la description d'une Tâche ou d'un projet.

Question 6

Quelles valeurs littérales puis-je utiliser dans les formules Quire ?

Accepted Answer

Les Formules Quire prennent en charge plusieurs types de valeurs littérales. Les Nombres peuvent s'écrire `123` ou `-1.23`. Le Texte est encadré de guillemets, comme `"text"` ou `'text'`, et les chaînes de Texte adjacentes sont automatiquement concaténées : `'first' "second"` produit le même résultat que `'first second'`. Les booléens s'écrivent `true` ou `false`, et les listes utilisent des crochets, comme `[1,2,3]`. Les durées peuvent s'écrire `2h 30m`, `30m`, ou au format `hh:mm:ss` ou `mm:ss`, où les heures doivent être comprises entre 0 et 23. Les dates et heures utilisent des chevrons, comme `<2022/12/25>`, `` ou `<15:15>`. Les littéraux basés sur le jour comme ``, `` ou `<+5>` sont également pris en charge, et `<+5>` est équivalent à ``. Les littéraux de jour sont sensibles à la langue, donc une Formule écrite en allemand peut utiliser un mot comme `` à la place de ``. Ces types de littéraux peuvent être combinés avec des Champs, des opérateurs et des fonctions dans un seul champ de Formule.

Question 7

Comment mettre en forme ou colorier les résultats d'une formule dans Quire ?

Accepted Answer

Pour mettre en forme les résultats d'une Formule, ouvrez le champ personnalisé de Formule et cliquez sur l'onglet Format, qui vous permet de choisir comment le résultat calculé est affiché. Pour ajouter des couleurs conditionnelles qui mettent en évidence des valeurs importantes, cliquez sur Ajouter une nouvelle condition, définissez la règle de la condition et choisissez une couleur avant de cliquer sur Enregistrer. Vous pouvez créer plusieurs conditions sur le même champ de Formule, et Quire les applique de haut en bas, donc une condition antérieure peut remplacer une condition ultérieure si les deux correspondent à la même valeur. Pour modifier l'ordre d'évaluation des conditions, faites glisser l'icône à six points à côté d'une condition pour la déplacer vers le haut ou vers le bas de la liste. Cette combinaison de l'onglet Format et des couleurs conditionnelles vous permet à la fois de contrôler l'affichage des Nombres ou du Texte et de signaler visuellement les résultats qui répondent à des critères spécifiques.

Formule expliquée Permalink

Écrire une Formule

Effectuer des calculs avec des Formules

Opérateurs arithmétiques

Fonctions

Bonnes pratiques pour l’écriture de Formules

Opérateur point

Noms de champs avec espaces

Texte dans les résultats

Identifiants pour les Membres, les Tâches et les Étiquettes

Valeurs littérales dans les Formules Quire

Mise en forme des résultats de Formule

Onglet Format

Couleurs conditionnelles

Foire aux questions

Comment utiliser les formules dans Quire ?

Quels calculs puis-je effectuer dans les formules Quire ?

Quelles valeurs littérales puis-je utiliser dans les formules Quire ?

Comment référencer un champ personnalisé dont le nom contient des espaces dans une formule Quire ?

Comment inclure du Texte dans le résultat d’une formule Quire ?

Comment référencer une Tâche, un Membre ou une Étiquette spécifique dans une formule Quire ?

Comment mettre en forme ou colorier les résultats d’une formule dans Quire ?