Références des champs de formule Quire Permalink
Ce guide explique toutes les références de champs de formule Quire, notamment les champs de tâche, les champs de projet, les membres, les journaux d’heures et les extensions de champs personnalisés. Utilisez cette page comme référence lors de la rédaction de formules dans Quire.
Références des champs de tâche
| Nom du champ | Type de champ | Description | Exemple | Notes |
|---|---|---|---|---|
| me | Membre | L’utilisateur actuel | me in assignees |
|
| low | Flèche de Priorité | La flèche de priorité basse | subtasks.priority > low |
|
| medium | Flèche de Priorité | La flèche de priorité moyenne | subtasks.priority > medium |
|
| high | Flèche de Priorité | La flèche de priorité haute | subtasks.priority > high |
|
| urgent | Flèche de Priorité | La flèche de priorité urgente | subtasks.priority > urgent |
|
| priority | Flèche de Priorité | La flèche de priorité colorée de la tâche | subtasks.priority |
Plus d’informations pour priority. |
| id | Nombre | Le numéro d’identifiant unique de la tâche | subtasks.id |
|
| name | Texte | Le nom de la tâche | subtasks.name |
|
| description | Texte | La description de la tâche | subtask.description |
|
| status | Icône de Statut | L’icône du statut de la tâche | subtasks.status |
Plus d’informations pour status. |
| previousStatus | Icône de Statut | L’icône du statut précédent de la tâche | subtasks.previousStatus |
Plus d’informations pour previousStatus. |
| start | Date et heure | La date de début et l’heure de la tâche | subtasks.start |
|
| due | Date et heure | La date d’échéance et l’heure de la tâche | parent.due |
|
| duration | Durée | La durée totale entre la date d’échéance et la date de début | subtasks.duration |
|
| peekaboo | Case à cocher | Indique si la tâche est en mode Peekaboo ou non | subtasks.peekaboo |
|
| archivedAt | Date et heure | La date et l’heure auxquelles la tâche a été mise en Peekaboo | parent.archivedAt |
|
| archivedBy | Membre | Le membre qui a mis la tâche en Peekaboo | parent.archivedBy |
|
| reshowAt | Date et heure | La date et l’heure auxquelles la tâche sera de nouveau affichée | parent.reshowAt |
|
| assignees | Membre | L’attribution de la tâche | COUNT(subtasks.assignees) |
Les équipes externes attribuées à la tâche ne sont pas incluses. |
| assignors | Membre | Le membre qui a attribué la tâche | subtasks.assignors |
Plus d’informations pour assignors. |
| externalTeam | Équipe externe | L’équipe externe attribuée à la tâche | externalTeam.name |
Si l’Équipe externe est attribuée à une tâche parente, elle apparaît dans le même champ pour les sous-tâches. |
| tags | Étiquettes | Les étiquettes ajoutées à la tâche | subtasks.tags |
Plus d’informations pour tags. |
| level | Nombre | Le numéro du niveau de la tâche | MAX(descendants.level) |
|
| editedAt | Date et heure | La date et l’heure auxquelles la tâche a été modifiée | parent.editedAt |
|
| toggledAt | Date et heure | La date et l’heure auxquelles le statut de la tâche a été modifié | parent.toggledAt |
|
| toggledBy | Membre | Le membre qui a modifié le statut de la tâche | toggledBy.name |
|
| createdAt | Date et heure | La date et l’heure auxquelles la tâche a été créée | parent.createdAt |
|
| createdBy | Membre | Le membre qui a ajouté la tâche | createdBy.name |
|
| completedAt | Date et heure | La date et l’heure auxquelles la tâche a été terminée | parent.completedAt |
|
| completedBy | Membre | Le membre qui a terminé la tâche | parent.completedBy |
|
| timelogs | Nombre de journaux d’heures | Le nombre d’entrées d’heures ajoutées à la tâche | timelogs.duration |
Plus d’informations pour time logs. |
| timeSpent | Heure | Le temps total passé sur la tâche | subtasks.timeSpent |
|
| billingTimelogs | Nombre de journaux d’heures | Le nombre d’entrées d’heures facturables ajoutées à la tâche | billingTimelogs.duration |
Plus d’informations pour time logs. |
| billingTimeSpent | Heure | Le temps facturable total passé sur la tâche | subtasks.billingTimeSpent |
|
| estimated | Heure | Le temps estimé pour la tâche | SUM(subtasks.estimated) |
|
| favorites | Membre | Le membre qui a mis la tâche en Favoris | favorites.name |
|
| attachments | Nombre de pièces jointes | Le nombre de pièces jointes ajoutées à la tâche | attachments.name |
Plus d’informations pour attachments. |
| comments | Nombre de commentaires | Le nombre de commentaires ajoutés à la tâche | comments.attachments |
Plus d’informations pour comments. |
| subtasks | Liste de tâches | Liste de toutes les sous-tâches de premier niveau de la tâche | subtasks[0].{Cost} |
|
| activeSubtasks | Liste de tâches | Liste de toutes les sous-tâches actives de premier niveau de la tâche | SUM(activeSubtasks.{Cost}) |
|
| completedSubtasks | Liste de tâches | Liste de toutes les sous-tâches terminées de premier niveau de la tâche | SUM(completedSubtasks.{Cost}) |
|
| descendants | Liste de tâches | Liste de toutes les sous-tâches à chaque niveau de la tâche | SUM(descendants.{Cost}) |
|
| activeDescendants | Liste de tâches | Liste de toutes les sous-tâches actives à chaque niveau de la tâche | SUM(activeDescendants.{Cost}) |
|
| completedDescendants | Liste de tâches | Liste de toutes les sous-tâches terminées à chaque niveau de la tâche | SUM(completedDescendants.{Cost}) |
|
| parent | Tâche | La tâche parente directement liée | parent.due |
|
| section | Tâche | La tâche ancêtre la plus proche qui est une section | section.name |
|
| ancestors | Liste de tâches | Liste de toutes les tâches parentes de la tâche | ancestors.due |
|
| project | Projet | Le projet auquel appartient la tâche | project.name |
Plus d’informations pour project. |
| organization | Organisation | L’organisation à laquelle appartient la tâche | organization.name |
Plus d’informations pour organizations. |
Extensions de champs avec l’opérateur point
Vous pouvez utiliser l’opérateur point (.) pour récupérer une propriété spécifique d’un champ.
Exemple :
priority→ retourne l’icône de prioritépriority.value→ retourne la valeur numérique de la prioritépriority.name→ retourne le libellé textuel
Cette approche s’applique aux champs tels que priority, status, members, projects, tags et les champs personnalisés.
Références des champs de projet
| Nom du champ | Type de champ | Description | Exemple |
|---|---|---|---|
| id | Texte | L’identifiant du projet | project.id |
| name | Texte | Le nom du projet | project.name |
| start | Date | La date de début du projet | project.start |
| due | Date | La date d’échéance du projet | project.due |
| color | Code couleur | La couleur du projet | project.color |
| roots | Liste de tâches | Liste de toutes les tâches de premier niveau (tâches racines) du projet | project.roots |
| activeRoots | Liste de tâches | Liste de toutes les tâches actives de premier niveau (tâches racines) du projet | project.activeRoots |
| completedRoots | Liste de tâches | Liste de toutes les tâches terminées de premier niveau (tâches racines) du projet | project.completedRoots |
| tasks | Liste de tâches | Liste de toutes les tâches du projet | project.tasks |
| activeTasks | Liste de tâches | Liste de toutes les tâches actives du projet | project.activeTasks |
| completedTasks | Liste de tâches | Liste de toutes les tâches terminées du projet | project.completedTasks |
| organization | Organisation | L’organisation à laquelle appartient le projet | project.organization |
Références des champs d’organisation
| Nom du champ | Type de champ | Description | Exemple |
|---|---|---|---|
| id | Texte | L’identifiant de l’organisation | organization.id |
| name | Texte | Le nom de l’organisation | organization.name |
| color | Code couleur | La couleur de l’organisation | organization.color |
Références des champs de sous-liste
| Nom du champ | Type de champ | Description | Exemple |
|---|---|---|---|
| id | Texte | L’identifiant de la sous-liste | sublists.id |
| name | Texte | Le nom de la sous-liste | sublists.name |
| start | Date | La date de début de la sous-liste | sublists.start |
| due | Date | La date d’échéance de la sous-liste | sublists.due |
| color | Code couleur | La couleur de la sous-liste | sublists.color |
Remarque : Vous devez indiquer le nom ou l’identifiant de la sous-liste entre crochets [ ]. Par exemple, sublists['Design'].due récupère la date d’échéance de la sous-liste nommée « Design ».
Références des champs de membre (assignees, assignors)
| Nom du champ | Type de champ | Description | Exemple |
|---|---|---|---|
| id | Texte | L’identifiant d’utilisateur du membre | assignees.id |
| name | Texte | Le nom du membre | assignees.name |
| Texte | L’adresse e-mail du membre | assignees.email |
|
| color | Code couleur | La couleur du membre | assignees.color |
Références des champs de pièce jointe
| Nom du champ | Type de champ | Description | Exemple |
|---|---|---|---|
| name | Texte | Le nom des pièces jointes | attachments.name |
| url | Texte | L’URL des pièces jointes | attachments.url |
| size | Nombre | La taille des pièces jointes | attachments.size |
| createdAt | Date et heure | La date et l’heure d’ajout des pièces jointes | attachments.createdAt |
| createdBy | Membre | Le membre qui a ajouté les pièces jointes | attachments.createdBy |
Références des champs de commentaire
| Nom du champ | Type de champ | Description | Exemple |
|---|---|---|---|
| description | Texte | Tous les commentaires ajoutés à la tâche | comments.description |
| attachments | Nombre de pièces jointes | Le nombre de pièces jointes ajoutées aux commentaires | comments.attachments |
| createdAt | Date et heure | La date et l’heure d’ajout des commentaires | comments.createdAt |
| createdBy | Membre | Le membre qui a ajouté les commentaires | comments.createdBy |
Références des champs d’équipe externe et d’étiquette
| Nom du champ | Type de champ | Description | Exemple |
|---|---|---|---|
| name | Texte | Le nom de l’équipe externe ou des étiquettes | externalTeam.name ou tags.name |
| color | Code couleur | La couleur de l’équipe externe | externalTeam.color ou tags.color |
Références des champs de journal d’heures
| Nom du champ | Type de champ | Description | Exemple |
|---|---|---|---|
| user | Membre | Le membre qui a ajouté des entrées d’heures à la tâche | timelogs.user |
| start | Date | La date de début des journaux d’heures | timelogs.start |
| end | Date | La date de fin des journaux d’heures | timelogs.end |
| duration | Durée | La durée des journaux d’heures ajoutés à la tâche | timelogs.duration |
| billable | Case à cocher | Valeur true/false indiquant si les journaux d’heures sont facturables | timelogs.billable |
| note | Texte | Les notes des journaux d’heures de la tâche | timelogs.note |
Références des champs de priorité et de statut
| Nom du champ | Type de champ | Description | Exemple |
|---|---|---|---|
| name | Texte | Le nom de la priorité ou du statut | priority.name ou status.name |
| value | Nombre | La valeur de la priorité ou du statut | priority.value ou status.value |
| color | Code couleur | La couleur de la priorité ou du statut | priority.color ou status.color |
Références des champs de devise
| Nom du champ | Type de champ | Description | Exemple |
|---|---|---|---|
| currency | Texte | Le symbole monétaire du champ de devise | Cost.currency |
| value | Nombre | La valeur numérique du champ de devise | Cost.value |
Remarque : Vous devez créer un champ personnalisé numérique (par exemple Cost) avant de l’utiliser dans des formules.
Références des champs de sélection
| Nom du champ | Type de champ | Description | Exemple |
|---|---|---|---|
| name | Texte | Le nom des options sélectionnées | Categories.name |
| color | Code couleur | La couleur des options sélectionnées | Categories.color |
Remarque : Vous devez créer un champ personnalisé numérique (par exemple Cost) avant de l’utiliser dans des formules.
Foire aux questions
Quels champs de tâche puis-je référencer dans une formule Quire ?
Les champs de tâche intégrés comprennent name, id, status, priority, start, due, duration, assignees, tags, timeSpent, estimated, createdBy, completedAt, et bien d’autres. Consultez la liste complète dans Références des champs de tâche.
Comment obtenir la valeur numérique ou la couleur d’une priorité ou d’un statut dans une formule Quire ?
Utilisez la notation pointée — priority.value retourne la valeur numérique, priority.name retourne le libellé textuel, et priority.color retourne le code couleur. Le même principe s’applique à status.
Comment référencer les sous-tâches ou tous les descendants dans une formule Quire ?
Utilisez subtasks pour les sous-tâches de premier niveau uniquement, ou descendants pour tous les niveaux. Pour des sous-ensembles filtrés, utilisez activeSubtasks, completedSubtasks, activeDescendants ou completedDescendants.
Comment référencer les champs d’un projet dans une formule Quire ?
Utilisez project.fieldname — par exemple, project.name retourne le nom du projet et project.tasks retourne toutes les tâches. Utilisez project.activeTasks ou project.completedTasks pour des listes filtrées.
Comment référencer les informations d’un membre comme le nom ou l’e-mail d’une attribution dans une formule Quire ?
Utilisez la notation pointée sur les champs de membre — assignees.name retourne le nom d’affichage, assignees.email retourne l’adresse e-mail, et assignees.id retourne l’identifiant d’utilisateur.
Comment référencer les données des journaux d’heures dans une formule Quire ?
Utilisez timelogs.fieldname — par exemple, timelogs.duration retourne la durée des entrées d’heures et timelogs.billable retourne un indicateur facturable true/false. Utilisez billingTimelogs pour les entrées facturables uniquement.
Comment référencer la date d’échéance ou le nom d’une sous-liste dans une formule Quire ?
Utilisez sublists['SublistName'].fieldname — par exemple, sublists['Design'].due récupère la date d’échéance de la sous-liste nommée « Design ».