Referências de Campos da Fórmula no Quire Permalink

Q: A quais campos de Tarefa posso fazer referência em uma Fórmula do Quire?

Você pode fazer referência a campos de Tarefa integrados, incluindo name, id, status, priority, start, due, duration, assignees, tags, timeSpent, estimated, createdBy, completedAt, entre outros. Use a notação de ponto para acessar subpropriedades — por exemplo, `priority.name` retorna o rótulo de texto, enquanto `priority.value` retorna o valor numérico.

Q: Como faço referência a Subtarefas em comparação a todos os descendentes em uma Fórmula do Quire?

Use `subtasks` para fazer referência apenas às Subtarefas de primeiro nível, ou `descendants` para incluir Subtarefas de todos os níveis. Para subconjuntos ativos ou concluídos, use `activeSubtasks`, `completedSubtasks`, `activeDescendants` ou `completedDescendants` — por exemplo, `SUM(activeDescendants.{Cost})` soma o campo Cost em todas as Subtarefas aninhadas ativas.

Q: Como faço referência a campos de projeto em uma Fórmula do Quire?

Use `project.fieldname` — por exemplo, `project.name` retorna o nome do projeto, `project.due` retorna a Data limite e `project.tasks` retorna a lista de todas as Tarefas do projeto. Você também pode acessar `project.activeTasks` ou `project.completedTasks` para obter listas filtradas.

Q: Como faço referência a informações de Membro, como o nome ou e-mail do Responsável, em uma Fórmula do Quire?

Use a notação de ponto nos campos de Responsável — `assignees.name` retorna o nome de exibição do Responsável, `assignees.email` retorna o e-mail e `assignees.id` retorna o ID de usuário. O mesmo se aplica a `assignors`, `createdBy`, `completedBy` e a outros campos do tipo Membro.

Q: Como faço referência a dados de registro de tempo em uma Fórmula do Quire?

Use `timelogs.fieldname` — por exemplo, `timelogs.duration` retorna a duração das entradas de tempo, `timelogs.user` retorna o Membro que registrou o tempo e `timelogs.billable` retorna um valor verdadeiro/falso indicando se as entradas são Faturáveis. Use `billingTimelogs` para obter apenas as entradas Faturáveis.

Q: Como faço referência à Data limite ou ao nome de uma Sublista em uma Fórmula do Quire?

Use `sublists['SublistName'].fieldname` — por exemplo, `sublists['Design'].due` recupera a Data limite da Sublista chamada "Design". O nome ou o ID da Sublista deve estar entre colchetes.

Q: Como obtenho o valor numérico ou a cor de uma Prioridade ou Estado em uma Fórmula do Quire?

Use a notação de ponto — `priority.value` retorna o valor numérico, `priority.name` retorna o rótulo de texto e `priority.color` retorna o código da cor. O mesmo padrão se aplica a `status.value`, `status.name` e `status.color`.

Este guia explica todas as referências de campos da Fórmula no Quire, incluindo campos de Tarefa, campos de projeto, Membros, registros de tempo e extensões de campos personalizados. Use esta página como referência ao escrever fórmulas no Quire.

Referências de Campos de Tarefa

Nome do campo	Tipo do campo	Descrição	Exemplo	Observações
me	Membro	O usuário atual	`me in assignees`
low	Seta de Prioridade	A seta de Prioridade baixa	`subtasks.priority > low`
medium	Seta de Prioridade	A seta de Prioridade média	`subtasks.priority > medium`
high	Seta de Prioridade	A seta de Prioridade alta	`subtasks.priority > high`
urgent	Seta de Prioridade	A seta de Prioridade urgente	`subtasks.priority > urgent`
priority	Seta de Prioridade	A seta colorida de Prioridade da Tarefa	`subtasks.priority`	Veja mais informações sobre priority.
id	Número	O número de id único da Tarefa	`subtasks.id`
name	Texto	O nome da Tarefa	`subtasks.name`
description	Texto	A descrição da Tarefa	`subtask.description`
status	Ícone de Estado	O ícone do Estado da Tarefa	`subtasks.status`	Veja mais informações sobre status.
previousStatus	Ícone de Estado	O ícone do Estado anterior da Tarefa	`subtasks.previousStatus`	Veja mais informações sobre previousStatus.
start	Data e Hora	A Data de início e a Hora da Tarefa	`subtasks.start`
due	Data e Hora	A Data limite e a Hora da Tarefa	`parent.due`
duration	Duração	A duração total resultante da Data limite menos a Data de início	`subtasks.duration`
peekaboo	Caixa de seleção	Se a Tarefa está em Peekaboo ou não	`subtasks.peekaboo`
archivedAt	Data e hora	A data e hora em que a Tarefa entrou em Peekaboo	`parent.archivedAt`
archivedBy	Membro	O Membro que colocou a Tarefa em Peekaboo	`parent.archivedBy`
reshowAt	Data e hora	A data e hora em que a Tarefa será exibida novamente	`parent.reshowAt`
assignees	Membro	O Responsável da Tarefa	`COUNT(subtasks.assignees)`	As Equipes externas atribuídas à Tarefa não serão incluídas.
assignors	Membro	O Membro que atribuiu a Tarefa	`subtasks.assignors`	Veja mais informações sobre assignors.
externalTeam	Equipe externa	A Equipe externa atribuída à Tarefa	`externalTeam.name`	Se a Equipe externa estiver atribuída a uma Classe Mãe, a Equipe externa aparecerá no mesmo campo das Subtarefas.
tags	Tags	As Tags adicionadas à Tarefa	`subtasks.tags`	Veja mais informações sobre tags.
level	Número	O número do nível da Tarefa	`MAX(descendants. level)`
editedAt	Data e hora	A data e hora em que a Tarefa foi editada	`parent.editedAt`
toggledAt	Data e hora	A data e hora em que o Estado da Tarefa foi alterado	`parent.toggledAt`
toggledBy	Membro	O Membro que alterou o Estado da Tarefa	`toggledBy.name`
createdAt	Data e hora	A data e hora em que a Tarefa foi criada	`parent.createdAt`
createdBy	Membro	O Membro que adicionou a Tarefa	`createdBy.name`
completedAt	Data e hora	A data e hora em que a Tarefa foi concluída	`parent.completedAt`
completedBy	Membro	O Membro que concluiu a Tarefa	`parent.completedBy`
timelogs	Número de registros de tempo	O número de entradas de tempo adicionadas à Tarefa	`timelogs.duration`	Veja mais informações sobre registros de tempo.
timeSpent	Hora	O tempo total gasto na Tarefa	`subtasks.timeSpent`
billingTimelogs	Número de registros de tempo	O número de entradas de tempo Faturáveis adicionadas à Tarefa	`billingTimelogs.duration`	Veja mais informações sobre registros de tempo.
billingTimeSpent	Hora	O tempo total Faturável gasto na Tarefa	`subtasks.billingTimeSpent`
estimated	Hora	O tempo estimado da Tarefa	`SUM(subtasks.estimated)`
favorites	Membro	O Membro que marcou a Tarefa como Favorito	`favorites.name`
attachments	Número de Anexos	O número de Anexos adicionados à Tarefa	`attachments.name`	Veja mais informações sobre anexos.
comments	Número de comentários	O número de comentários adicionados à Tarefa	`comments.attachments`	Veja mais informações sobre comentários.
subtasks	Lista de Tarefas	Lista de todas as Subtarefas de primeiro nível da Tarefa	`subtasks[0].{Cost}`
activeSubtasks	Lista de Tarefas	Lista de todas as Subtarefas ativas de primeiro nível da Tarefa	`SUM(activeSubtasks.{Cost})`
completedSubtasks	Lista de Tarefas	Lista de todas as Subtarefas concluídas de primeiro nível da Tarefa	`SUM(completedSubtasks.{Cost})`
descendants	Lista de Tarefas	Lista de todas as Subtarefas de qualquer nível da Tarefa	`SUM(descendants.{Cost})`
activeDescendants	Lista de Tarefas	Lista de todas as Subtarefas ativas de qualquer nível da Tarefa	`SUM(activeDescendants.{Cost})`
completedDescendants	Lista de Tarefas	Lista de todas as Subtarefas concluídas de qualquer nível da Tarefa	`SUM(completedDescendants.{Cost})`
parent	Tarefa	A Classe Mãe diretamente relacionada	`parent.due`
section	Tarefa	A Tarefa antecessora mais próxima que é uma Seção	`section.name`
ancestors	Lista de Tarefas	Lista de todas as Classes Mãe da Tarefa	`ancestors.due`
project	Projeto	O projeto ao qual a Tarefa pertence	`project.name`	Veja mais informações sobre projeto.
organization	Organização	A organização à qual a Tarefa pertence	`organization.name`	Veja mais informações sobre organizações.

Extensões de Campo com o Operador Ponto

Você pode usar o operador ponto (.) para obter uma propriedade específica de um campo.

Exemplo:

priority → retorna o ícone da Prioridade
priority.value → retorna o valor numérico da Prioridade
priority.name → retorna o rótulo de texto

Essa abordagem se aplica a campos como priority, status, members, projects,tags e custom fields.

Referências de Campos de Projeto

Nome do campo	Tipo do campo	Descrição	Exemplo
id	Texto	O id do projeto	`project.id`
name	Texto	O nome do projeto	`project.name`
start	Data	A Data de início do projeto	`project.start`
due	Data	A Data limite do projeto	`project.due`
color	Código de cor	A cor do projeto	`project.color`
roots	Lista de Tarefas	Lista de todas as Tarefas de primeiro nível (Tarefas raiz) do projeto	`project.roots`
activeRoots	Lista de Tarefas	Lista de todas as Tarefas ativas de primeiro nível (Tarefas raiz) do projeto	`project.activeRoots`
completedRoots	Lista de Tarefas	Lista de todas as Tarefas concluídas de primeiro nível (Tarefas raiz) do projeto	`project.completedRoots`
tasks	Lista de Tarefas	Lista de todas as Tarefas do projeto	`project.tasks`
activeTasks	Lista de Tarefas	Lista de todas as Tarefas ativas do projeto	`project.activeTasks`
completedTasks	Lista de Tarefas	Lista de todas as Tarefas concluídas do projeto	`project.completedTasks`
organization	Organização	A organização à qual o projeto pertence	`project.organization`

Referências de Campos de Organização

Nome do campo	Tipo do campo	Descrição	Exemplo
id	Texto	O id da organização	`organization.id`
name	Texto	O nome da organização	`organization.name`
color	Código de cor	A cor da organização	`organization.color`

Referências de Campos de Sublista

Nome do campo	Tipo do campo	Descrição	Exemplo
id	Texto	O id da Sublista	`sublists.id`
name	Texto	O nome da Sublista	`sublists.name`
start	Data	A Data de início da Sublista	`sublists.start`
due	Data	A Data limite da Sublista	`sublists.due`
color	Código de cor	A cor da Sublista	`sublists.color`

Observação: Você deve indicar o nome ou o ID da Sublista entre colchetes [ ]. Por exemplo, sublists['Design'].due recupera a Data limite da Sublista chamada “Design”.

Referências de Campos de Membro (assignees, assignors)

Nome do campo	Tipo do campo	Descrição	Exemplo
id	Texto	O id de usuário do Membro	`assignees.id`
name	Texto	O nome do Membro	`assignees.name`
email	Texto	O e-mail do Membro	`assignees.email`
color	Código de cor	A cor do Membro	`assignees.color`

Referências de Campos de Anexo

Nome do campo	Tipo do campo	Descrição	Exemplo
name	Texto	O nome dos Anexos	`attachments.name`
url	Texto	A URL dos Anexos	`attachments.url`
size	Número	O tamanho dos Anexos	`attachments.size`
createdAt	Data e hora	A data e hora em que os Anexos foram adicionados	`attachments.createdAt`
createdBy	Membro	O Membro que adicionou os Anexos	`attachments.createdBy`

Referências de Campos de Comentário

Nome do campo	Tipo do campo	Descrição	Exemplo
description	Texto	Todos os comentários adicionados à Tarefa	`comments.description`
attachments	Número de Anexos	O número de Anexos adicionados aos comentários	`comments.attachments`
createdAt	Data e hora	A data e hora em que os comentários foram adicionados	`comments.createdAt`
createdBy	Membro	O Membro que adicionou os comentários	`comments.createdBy`

Referências de Campos de Equipe externa e Tag

Nome do campo	Tipo do campo	Descrição	Exemplo
name	Texto	O nome da Equipe externa ou das Tags	`externalTeam.name` ou `tags.name`
color	Código de cor	A cor da Equipe externa	`externalTeam.color` ou `tags.color`

Referências de Campos de Registro de Tempo

Nome do campo	Tipo do campo	Descrição	Exemplo
user	Membro	O Membro que adicionou entradas de tempo à Tarefa	`timelogs.user`
start	Data	A data de início em que os registros de tempo foram adicionados	`timelogs.start`
end	Data	A data de término em que os registros de tempo foram adicionados	`timelogs.end`
duration	Duração	A duração dos registros de tempo adicionados à Tarefa	`timelogs.duration`
billable	Caixa de seleção	Valor verdadeiro/falso indicando se os registros de tempo são Faturáveis	`timelogs.billable`
note	Texto	As notas dos registros de tempo da Tarefa	`timelogs.note`

Referências de Campos de Prioridade e Estado

Nome do campo	Tipo do campo	Descrição	Exemplo
name	Texto	O nome da Prioridade ou do Estado	`priority.name` ou `status.name`
value	Número	O valor da Prioridade ou do Estado	`priority.value` ou `status.value`
color	Código de cor	A cor da Prioridade ou do Estado	`priority.color` ou `status.color`

Referências de Campos de Moeda

Nome do campo	Tipo do campo	Descrição	Exemplo
currency	Texto	O símbolo da moeda do campo de moeda	`Cost.currency`
value	Número	O valor monetário do campo de moeda	`Cost.value`

Observação: Você deve criar um campo personalizado numérico (por exemplo, Cost) antes de utilizá-lo em fórmulas.

Referências de Campos de Seleção

Nome do campo	Tipo do campo	Descrição	Exemplo
name	Texto	O nome das opções selecionadas	`Categories.name`
color	Código de cor	A cor das opções selecionadas	`Categories.color`

Observação: Você deve criar um campo personalizado numérico (por exemplo, Cost) antes de utilizá-lo em fórmulas.

Perguntas Frequentes

A quais campos de Tarefa posso fazer referência em uma Fórmula do Quire?

Os campos de Tarefa integrados incluem name, id, status, priority, start, due, duration, assignees, tags, timeSpent, estimated, createdBy, completedAt, entre outros. Veja a lista completa em Referências de Campos de Tarefa.

Como obtenho o valor numérico ou a cor de uma Prioridade ou Estado em uma Fórmula do Quire?

Use a notação de ponto — priority.value retorna o valor numérico, priority.name retorna o rótulo de texto e priority.color retorna o código da cor. O mesmo se aplica a status.

Como faço referência a Subtarefas em comparação a todos os descendentes em uma Fórmula do Quire?

Use subtasks apenas para Subtarefas de primeiro nível, ou descendants para todos os níveis. Para subconjuntos filtrados, use activeSubtasks, completedSubtasks, activeDescendants ou completedDescendants.

Como faço referência a campos de projeto em uma Fórmula do Quire?

Use project.fieldname — por exemplo, project.name retorna o nome do projeto e project.tasks retorna todas as Tarefas. Use project.activeTasks ou project.completedTasks para obter listas filtradas.

Como faço referência a informações de Membro, como o nome ou e-mail do Responsável, em uma Fórmula do Quire?

Use a notação de ponto nos campos de Membro — assignees.name retorna o nome de exibição, assignees.email retorna o e-mail e assignees.id retorna o ID de usuário.

Como faço referência a dados de registro de tempo em uma Fórmula do Quire?

Use timelogs.fieldname — por exemplo, timelogs.duration retorna a duração da entrada de tempo e timelogs.billable retorna um indicador verdadeiro/falso de Faturável. Use billingTimelogs para obter apenas as entradas Faturáveis.

Como faço referência à Data limite ou ao nome de uma Sublista em uma Fórmula do Quire?

Use sublists['SublistName'].fieldname — por exemplo, sublists['Design'].due recupera a Data limite da Sublista chamada “Design”.

Por favor, entre em contato conosco se precisar de mais assistência.