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

✦
Traduzido por IA
· Ver em inglês

Este guia explica todas as referências de campos da Fórmula no Quire, incluindo campos de tarefas, campos de projetos, membros, registos de tempo e extensões de campos personalizados. Use esta página como referência sempre que escrever fórmulas no Quire.

Referências de Campos de Tarefa

Nome do campo Tipo do campo Descrição Exemplo Notas
me Membro O utilizador 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 de prioridade colorida 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 e hora de início da tarefa subtasks.start  
due Data e hora A data e hora do prazo de conclusão da tarefa parent.due  
duration Duração A duração total resultante da subtração entre o prazo de conclusão e a data de início subtasks.duration  
peekaboo Caixa de verificaçã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 voltará a ser apresentada parent.reshowAt  
assignees Membro O colaborador da tarefa COUNT(subtasks.assignees) As equipas 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 Equipa externa A equipa externa atribuída à tarefa externalTeam.name Se a Equipa externa estiver atribuída a uma classe mãe, a Equipa externa surgirá no mesmo campo nas sub-tarefas.
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 registos de tempo O número de entradas de tempo adicionadas à tarefa timelogs.duration Veja mais informações sobre registos de tempo.
timeSpent Hora O tempo total dedicado à tarefa subtasks.timeSpent  
billingTimelogs Número de registos de tempo O número de entradas de tempo cobráveis adicionadas à tarefa billingTimelogs.duration Veja mais informações sobre registos de tempo.
billingTimeSpent Hora O tempo total cobrável dedicado à tarefa subtasks.billingTimeSpent  
estimated Hora O tempo estimado da tarefa SUM(subtasks.estimated)  
favorites Membro O membro que adicionou a tarefa aos favoritos 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 sub-tarefas de primeiro nível da tarefa subtasks[0].{Cost}  
activeSubtasks Lista de tarefas Lista de todas as sub-tarefas ativas de primeiro nível da tarefa SUM(activeSubtasks.{Cost})  
completedSubtasks Lista de tarefas Lista de todas as sub-tarefas concluídas de primeiro nível da tarefa SUM(completedSubtasks.{Cost})  
descendants Lista de tarefas Lista de todas as sub-tarefas de qualquer nível da tarefa SUM(descendants.{Cost})  
activeDescendants Lista de tarefas Lista de todas as sub-tarefas ativas de qualquer nível da tarefa SUM(activeDescendants.{Cost})  
completedDescendants Lista de tarefas Lista de todas as sub-tarefas 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 seja uma secção section.name  
ancestors Lista de tarefas Lista de todas as classes mãe da tarefa ancestors.due  
project Projeto O projeto a que a tarefa pertence project.name Veja mais informações sobre projeto.
organization Organização A organização a que a tarefa pertence organization.name Veja mais informações sobre organizações.

Extensões de Campo com o Operador Ponto

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

Exemplo:

  • priority → devolve o ícone da prioridade
  • priority.value → devolve o valor numérico da prioridade
  • priority.name → devolve o rótulo de texto


Esta abordagem aplica-se 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 O prazo de conclusão 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 a que 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 Sub-lista

Nome do campo Tipo do campo Descrição Exemplo
id Texto O id da sub-lista sublists.id
name Texto O nome da sub-lista sublists.name
start Data A data de início da sub-lista sublists.start
due Data O prazo de conclusão da sub-lista sublists.due
color Código de cor A cor da sub-lista sublists.color

Nota: Tem de indicar o nome ou o ID da sub-lista dentro de parênteses retos [ ]. Por exemplo, sublists['Design'].due obtém o prazo de conclusão da sub-lista chamada “Design”.

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

Nome do campo Tipo do campo Descrição Exemplo
id Texto O id de utilizador do membro assignees.id
name Texto O nome do membro assignees.name
email Texto O email 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 O 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 Equipa externa e Tag

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

Referências de Campos de Registo 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 registos de tempo foram adicionados timelogs.start
end Data A data de fim em que os registos de tempo foram adicionados timelogs.end
duration Duração A duração dos registos de tempo adicionados à tarefa timelogs.duration
billable Caixa de verificação Valor verdadeiro/falso a indicar se os registos de tempo são cobráveis timelogs.billable
note Texto As notas dos registos 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

Nota: Tem de criar um campo personalizado numérico (por exemplo, Cost) antes de o utilizar 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

Nota: Tem de criar um campo personalizado numérico (por exemplo, Cost) antes de o utilizar em fórmulas.

Perguntas Frequentes

A que campos de tarefas posso fazer referência numa Fórmula no Quire?

Os campos de tarefas 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 numa Fórmula no Quire?

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

Como faço referência a sub-tarefas em comparação com todos os descendentes numa Fórmula no Quire?

Use subtasks apenas para sub-tarefas 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 numa Fórmula no Quire?

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

Como faço referência a informações de membros, como o nome ou o email do colaborador, numa Fórmula no Quire?

Use a notação por ponto nos campos de membro — assignees.name devolve o nome de apresentação, assignees.email devolve o email e assignees.id devolve o ID de utilizador.

Como faço referência a dados de registo de horas numa Fórmula no Quire?

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

Como faço referência ao prazo de conclusão ou ao nome de uma sub-lista numa Fórmula no Quire?

Use sublists['SublistName'].fieldname — por exemplo, sublists['Design'].due obtém o prazo de conclusão da sub-lista chamada “Design”.

Última Atualização:

Por favor, contacte-nos caso necessite de mais assistência.