Question 1

Como incorporo uma fórmula numa descrição, comentário ou documento do Quire?

Accepted Answer

Clique no editor de descrição, comentário ou documento e digite o caractere de barra para abrir o menu de comandos. Selecione Fórmula na lista e cole ou digite sua fórmula na caixa de diálogo que aparece. Após enviar, a fórmula fica incorporada diretamente no texto e recalcula automaticamente sempre que os dados subjacentes da tarefa mudam, mantendo o valor exibido sempre atualizado sem necessidade de atualizações manuais. Digitar palavras-chave após a barra filtra a lista de comandos para encontrar a Fórmula mais rapidamente, e você pode usar as teclas de seta para navegar no menu. Essa funcionalidade de incorporação funciona na maioria das áreas de texto enriquecido do Quire, incluindo descrições de organização, projeto, tarefa e pasta, além de comentários e documentos. A incorporação de fórmulas é um recurso restrito por plano, portanto requer um plano Professional, Premium ou Enterprise. Contas em planos de nível inferior não verão a opção Fórmula no menu de comandos de barra.

Question 2

Onde posso incorporar fórmulas no Quire?

Accepted Answer

As fórmulas podem ser incorporadas em descrições de organização, descrições de projeto, descrições de tarefa, descrições de pasta e Pasta Inteligente, descrições de perfil de usuário, comentários de tarefa e documentos. Na prática, isso abrange quase todas as áreas de texto enriquecido do Quire, permitindo transformar texto estático em qualquer um desses locais em um relatório dinâmico, atualizado automaticamente com base em dados reais das tarefas. Por exemplo, uma descrição de projeto pode mostrar um total acumulado de custos de todas as tarefas, enquanto uma descrição de organização ou de pasta pode referenciar outros projetos ou membros diretamente. Como a fórmula recalcula automaticamente à medida que os dados subjacentes mudam, não é necessário atualizar ou reinserir o valor manualmente após as tarefas serem atualizadas, concluídas ou adicionadas. Tenha em mente que a incorporação de fórmulas, independentemente do local onde forem colocadas, requer um plano Professional, Premium ou Enterprise. Os planos de nível inferior não têm acesso à opção Fórmula no menu de comandos de barra do editor.

Question 3

Como exibo o custo total de todas as tarefas numa descrição de projeto do Quire?

Accepted Answer

Incorpore a fórmula `SUM(tasks.Cost)` na descrição do projeto para exibir um total acumulado de custos de todas as tarefas do projeto. Antes de usar essa fórmula, é necessário que já exista no projeto um campo personalizado numérico ou monetário com o nome Cost, pois a fórmula soma esse campo específico em todas as tarefas. Uma vez incorporado, o total é atualizado automaticamente sempre que os custos das tarefas são adicionados, alterados ou removidos, de modo que a descrição sempre reflete o valor atual sem nenhum recálculo manual. Esta é uma das fórmulas de exemplo integradas para projetos, junto com outras como um indicador de saúde do projeto e uma pontuação média de esforço por tag. Você pode combinar essa fórmula com texto descritivo, por exemplo escrevendo "Custo total atual do projeto:" imediatamente antes do valor incorporado, para que o número fique claro no contexto. A referência completa de fórmulas do Quire lista todas as funções suportadas, caso você queira criar cálculos de custos mais avançados.

Question 4

Como crio um indicador de saúde do projeto com uma fórmula incorporada no Quire?

Accepted Answer

Use uma fórmula condicional que combina uma contagem de tarefas de alta prioridade em atraso com uma verificação de limite, exibida diretamente na descrição do projeto. A fórmula de exemplo conta as tarefas cuja prioridade é alta ou superior e cuja data limite é anterior a hoje, e verifica se essa contagem ultrapassa 20. Se ultrapassar, a descrição exibe um rótulo vermelho "Dangerous"; caso contrário, exibe um rótulo verde "Safe". Como a fórmula reavalia automaticamente à medida que os dados das tarefas mudam, o indicador é atualizado em tempo real sempre que as prioridades, datas limite ou contagens de tarefas se alteram, sem que ninguém precise editar a descrição manualmente. Isso transforma uma simples descrição de projeto em uma verificação visual rápida de saúde que qualquer pessoa que visualize o projeto pode ler de relance. O limite, o nível de prioridade e os rótulos do exemplo podem ser ajustados para corresponder à forma como sua equipe define um backlog não saudável de trabalho em atraso.

Question 5

Como referencio uma tarefa específica de outro projeto numa fórmula Quire incorporada?

Accepted Answer

Use o formato `#{project_id/task_id}` — por exemplo, `#{charity_run/23}` — para obter uma tarefa específica de um projeto diferente. A primeira parte é o identificador do projeto de destino e a segunda parte, após a barra, é o número da tarefa dentro desse projeto. Como exemplo concreto, referenciar o projeto charity_run com o número de tarefa 23 retorna essa tarefa específica, exibida como tarefa #23, diretamente onde quer que a fórmula esteja incorporada. Esse formato de referência é destinado ao uso em descrições de organização, descrições de pasta ou documentos, permitindo trazer à tona uma tarefa que existe fora do projeto atual sem trocar de contexto. Há uma restrição importante: a tarefa referenciada deve pertencer à mesma organização ou à mesma pasta onde a fórmula está incorporada. Se essa condição não for atendida, a fórmula retorna um valor nulo em vez das informações da tarefa, de modo que a referência simplesmente aparecerá vazia em vez de exibir uma mensagem de erro.

Question 6

Posso referenciar um membro ou projeto específico numa fórmula Quire incorporada?

Accepted Answer

Sim. Use `@username` seguido de um nome de usuário para referenciar um membro específico, e o identificador de projeto entre chaves, `#{project_id}`, para referenciar um projeto específico. Por exemplo, `SUM(#{project_id}.tasks.timeSpent)` soma o campo timeSpent de todas as tarefas de um projeto referenciado, permitindo totalizar o tempo gasto nesse projeto diretamente a partir de outra descrição. Você também pode referenciar diretamente um campo de perfil de um membro, como exibir seu endereço de e-mail, usando o mesmo formato com arroba. Uma limitação importante se aplica às referências de projeto: o formato de identificador de projeto entre chaves só funciona em descrições de organização ou de Pasta, não em descrições de tarefa ou de projeto. Além disso, se um nome de usuário contiver um ponto, hífen ou sublinhado, ele precisará ser colocado entre chaves para que a referência seja resolvida corretamente.

Incorporar Fórmulas no Quire Permalink

Áreas Suportadas

Incorporar uma Fórmula

Exemplos de Fórmulas Incorporadas para Projetos

Custo Total

Indicador de Saúde do Projeto

Esforço Médio por Tag

Dicas para Fórmulas Incorporadas

Referenciar uma Tarefa Específica

Listar Projetos

Referenciar um Membro ou Projeto

Perguntas Frequentes