Guide des Formules Quire Permalink

Les formules dans Quire vous permettent d’utiliser des données existantes de tâches ou de projets pour calculer automatiquement de nouvelles valeurs. Vous pouvez référencer des champs intégrés ou des champs personnalisés, appliquer des opérateurs ou des fonctions, et afficher des résultats numériques ou textuels dans un champ personnalisé.

Rédiger une formule

Dans le plan Gratuit, vous pouvez ajouter une formule au champ personnalisé pour chaque projet. Passez à un plan de souscription supérieur pour en ajouter davantage. Pour en savoir plus, consultez notre page de tarification.

Pour rédiger une formule, vous devez d’abord créer un champ personnalisé de type Formule. Une fois créé, vous pouvez saisir une formule qui référence des valeurs existantes et renvoie un résultat calculé.

Par exemple, pour diviser le temps passé sur votre tâche par 2 :

timeSpent/2 

Quire calcule automatiquement la valeur pour chaque tâche et affiche le résultat dans le champ personnalisé.

Découvrez comment créer un champ personnalisé pour y ajouter vos formules.

Effectuer des calculs avec les formules

Opérateurs arithmétiques

Vous pouvez effectuer des calculs arithmétiques courants à l’aide des opérateurs suivants :

• Addition : +
• Soustraction : -
• Multiplication : *
• Division : /

Par exemple, pour calculer la durée d’une tâche en soustrayant la date de début de la date d’échéance :

due - start

Conseil : Utilisez des parenthèses ( ) pour contrôler l’ordre des calculs. Par exemple, en tapant (due - start) *2, la soustraction entre la date d’échéance et la date de début sera effectuée avant la multiplication par 2.

Fonctions

Les fonctions offrent un moyen plus rapide d’effectuer des calculs avancés.

Par exemple, pour calculer le total du temps passé et du temps estimé :

SUM(timeSpent, estimated)

Vous pouvez également utiliser des opérateurs de comparaison pour obtenir des résultats logiques.

priority >= high

Cela vérifie si la priorité d’une tâche est supérieure ou égale à Élevée.

Découvrez tous les opérateurs et fonctions disponibles dans les formules Quire.

Bonnes pratiques de rédaction de formules

Opérateur point

L’opérateur point . permet de récupérer des valeurs spécifiques à partir d’objets liés.

Par exemple, pour lister tous les noms des sous-tâches :

subtasks.name

Autre exemple, pour obtenir la priorité d’une tâche parente :

parent.priority

Conseil : Nous avons répertorié tous les différents champs que vous pouvez spécifier.

Noms de champs contenant des espaces

Lors de la dénomination de vos champs personnalisés, évitez d’utiliser les caractères suivants : guillemets ("), barre oblique inversée (\) et accolade fermante (}).

Lors du référencement de champs personnalisés dans des formules :

• Les noms de champs sans espaces peuvent être utilisés directement
• Les noms de champs contenant des espaces ou des caractères spéciaux (dont @, #, &, etc.) doivent être encadrés par des accolades { }

Par exemple, si vous avez ajouté un nouveau champ nommé Cost :

Cost *2

{Cost} *2

Si le nom de votre champ inclut des espaces, vous devez l’encadrer avec les accolades { } :

{Schedule Variance} *2

Remarque : La casse n’est pas prise en compte : cost et Cost sont équivalents.

Texte dans les résultats

Pour inclure du texte dans les résultats d’une formule, encadrez toujours les chaînes de texte avec des guillemets.

Par exemple, si vous avez ajouté deux champs personnalisés, l’un pour l’identifiant de l’élément et l’autre pour son nom :

id + ":" + name

Cela affiche l’identifiant et le nom séparés par deux-points.

Identifiants pour les membres, les tâches et les étiquettes

Vous pouvez référencer des entités spécifiques à l’aide d’identifiants :

• Membre : @member_username
• Tâche : #task_id
• Étiquette : #tag_name
• Projet : #{project_id}

Par exemple, pour afficher la date d’échéance de la tâche portant l’identifiant 23 :

#23.due

Remarque : Aucun espace n’est autorisé entre # et l’identifiant.

Voici un autre exemple : pour connaître le temps total passé sur l’ensemble du projet, vous pouvez saisir quelque chose comme ceci dans la description de la Vue d’ensemble de l’Organisation :

SUM(#{project_id}.tasks.timeSpent)

Valeurs littérales dans les formules Quire

Les valeurs littérales sont des valeurs fixes qui ne changent pas lors du calcul. Quire prend en charge plusieurs formats littéraux :

• Nombre : 123, -1.23
• Texte : "text", 'text'
• Liste : [1,2,3]
• Booléen : true, false
• Durée : 12:01, 123:12:23, 2h 30m, 2d 5s, 30m
• Date et heure : <2022/12/25>, <12/23>, <23>, <2022/01/23 13:10:00>, <2023/12/25 16:00>, <15:15>, <now>
• Jours : <today>, <today-1>, <tomorrow+3 13:10:05>, <+5>

Mise en forme des résultats de formule

Onglet Format

Vous pouvez définir l’affichage des résultats de formule via l’onglet Format lors de la création ou de la modification d’un champ de formule.

1. Ouvrez le champ personnalisé de formule.
2. Cliquez sur l’onglet Format.
3. Choisissez le format d’affichage.

Couleurs conditionnelles

La mise en forme conditionnelle permet de mettre visuellement en évidence les valeurs importantes.

1. Cliquez sur Ajouter une nouvelle condition.
2. Définissez la condition et choisissez une couleur.
3. Cliquez sur Enregistrer.

Remarque : Les conditions sont appliquées de haut en bas. Faites glisser l’icône à six points pour les réorganiser.

Questions fréquemment posées

Comment utiliser les formules dans Quire ?

Créez un champ personnalisé de type Formule, puis saisissez une formule qui référence des champs de tâche et renvoie un résultat calculé. Le plan Gratuit autorise un champ de formule par projet.

Quels calculs puis-je effectuer dans les formules Quire ?

Quire prend en charge +, -, *, et /. Utilisez des parenthèses pour contrôler l’ordre des calculs — par exemple, (due - start) * 2. Pour des calculs avancés, utilisez des fonctions intégrées comme SUM(timeSpent, estimated).

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

Les littéraux pris en charge incluent les nombres (123, -1.23), le texte ("text"), les booléens (true/false), les listes ([1,2,3]), les durées (2h 30m) et les dates (<2022/12/25>, <today>, <today+5>).

Comment référencer un champ personnalisé contenant des espaces dans une formule Quire ?

Encadrez le nom du champ avec des accolades — par exemple, {Schedule Variance} * 2. Les noms de champs sans espaces peuvent être utilisés directement. Les noms de champs ne sont pas sensibles à la casse.

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

Encadrez les chaînes de texte avec des guillemets — par exemple, id + ":" + name affiche un identifiant et un nom séparés par deux-points.

Comment référencer une tâche, un membre ou une étiquette spécifique dans une formule Quire ?

Utilisez #task_id (ex. #23.due), @member_username et #tag_name. Pour les noms d’étiquettes contenant des espaces ou des caractères spéciaux, utilisez #"depending on".

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

Ouvrez le champ de formule et cliquez sur l’onglet Format pour choisir un format d’affichage. Pour les couleurs conditionnelles, cliquez sur Ajouter une nouvelle condition, définissez la règle et enregistrez.