Incorporar Fórmulas no Quire Permalink
As fórmulas incorporadas transformam descrições e comentários estáticos em relatórios dinâmicos, atualizados automaticamente com base nos dados das suas tarefas. Você pode incorporá-las em visões gerais de organização, descrições de projeto, comentários de tarefa, documentos e muito mais.
A incorporação de fórmulas está disponível apenas nos planos Professional, Premium e Enterprise. Mais informações podem ser encontradas em nossa página de preços.
Áreas Suportadas
Você pode incorporar fórmulas em praticamente todas as áreas de texto formatado no Quire, incluindo:
- Descrições de organização
- Descrições de projeto
- Descrições de tarefa
- Descrições de pasta e Pasta Inteligente
- Descrições de perfil do usuário
- Comentários de tarefa
- Documentos
A incorporação de fórmulas permite transformar texto estático em relatórios dinâmicos, atualizados automaticamente com os dados das tarefas.
Incorporar uma Fórmula
- Clique em um editor de descrição, comentário ou documento.
- Digite o comando de barra
/para abrir o menu de comandos. - Selecione Fórmula na lista.
- Cole ou digite sua fórmula na caixa de diálogo da fórmula.
Dica: Digitar palavras-chave após / filtra a lista de comandos. Use as teclas de seta para navegar rapidamente.
Exemplos de Fórmulas Incorporadas para Projetos
Custo Total
Use uma fórmula incorporada na descrição do projeto para exibir o custo total em tempo real:
Custo total atual do projeto: [incorpore a fórmula aqui]
Cole a seguinte fórmula na caixa de diálogo da fórmula:
SUM(tasks.Cost)
Essa fórmula soma automaticamente o campo Cost de todas as tarefas do projeto.
Observação: Um campo personalizado numérico ou de moeda chamado Cost deve existir no projeto.
Conheça todas as funções que você pode usar nas fórmulas do Quire.
Indicador de Saúde do Projeto
Você pode exibir um status visual de saúde usando uma fórmula condicional (?:):
Indicador de Saúde do Projeto: [incorpore a fórmula aqui]
Exemplo de fórmula:
count(tasks where any.priority >= high and any.due < <today>) > 20 ? "🔴 Dangerous" : "🟢 Safe"
Essa fórmula:
- Conta as tarefas de alta prioridade em atraso
- Exibe um aviso (🔴 Dangerous) se o total ultrapassar 20
- Se atualiza automaticamente conforme os dados das tarefas mudam
Esforço Médio por Tag
Você pode incorporar uma fórmula na Visualização em Tabela ou em descrições para acompanhar as pontuações de esforço:
AVG((subtasks where 'S1' in any.Sprint).Effort)
Essa fórmula:
- Filtra as subtarefas com o valor de Sprint “S1”
- Calcula a média do campo Esforço delas
Antes de usar esta fórmula:
Effortdeve ser um campo personalizado do tipo numéricoSprintdeve ser um campo personalizado do tipo seleção
Conheça todas as funções que você pode usar nas fórmulas do Quire.
Dicas para Fórmulas Incorporadas
Referenciar uma Tarefa Específica
Ao trabalhar em descrições de organização, descrições de pasta ou documentos, use o formato de identificador de tarefa:
#{project_id/23}
Isso retorna a tarefa com ID 23 do projeto especificado.
Observação: A tarefa referenciada deve pertencer à mesma organização ou pasta. Caso contrário, a fórmula retornará um valor nulo.
Listar Projetos
Para exibir todos os projetos dentro de uma organização, pasta ou usuário, incorpore:
projects
A fórmula se atualiza automaticamente quando projetos são adicionados ou removidos.
Referenciar um Membro ou Projeto
Você pode referenciar membros e projetos diretamente usando identificadores:
- Membro:
@username - Projeto:
#{project_id}
Exemplo: exibir o endereço de e-mail de um membro:
@john.email
Exemplo: calcular a hora total gasta em um projeto:
SUM(#{project_id}.tasks.timeSpent)
Observação:
#{project_id}só pode ser usado em descrições de organização ou pasta. Não pode ser usado na descrição de uma tarefa ou de um projeto.- O ID do projeto deve estar entre chaves (por exemplo:
#{project_id}) para que o identificador de projeto funcione corretamente. - Se o nome de usuário contiver
.,-ou_, você precisará colocá-lo entre chaves para que o identificador funcione corretamente.
Perguntas Frequentes
Onde posso incorporar fórmulas no Quire?
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 do usuário, comentários de tarefa e documentos.
Como incorporo uma fórmula em uma descrição, comentário ou documento do Quire?
Clique no editor, digite / para abrir o menu de comandos, selecione Fórmula e insira sua fórmula. Requer um plano Professional, Premium ou Enterprise.
Como exibo o custo total de todas as tarefas na descrição de um projeto no Quire?
Incorpore SUM(tasks.Cost) na descrição do projeto. Um campo personalizado numérico ou de moeda chamado “Cost” deve existir no projeto previamente.
Como crio um indicador de saúde do projeto usando uma fórmula incorporada no Quire?
Use uma fórmula condicional como count(tasks where any.priority >= high and any.due < <today>) > 20 ? "🔴 Dangerous" : "🟢 Safe" na descrição do projeto. Ela se atualiza em tempo real conforme os dados mudam.
Como referencio uma tarefa específica de outro projeto em uma fórmula incorporada no Quire?
Use #{project_id/task_id} — por exemplo, #{charity_run/23} retorna a tarefa #23 daquele projeto. A tarefa deve pertencer à mesma organização ou pasta.
Posso referenciar um membro ou projeto específico em uma fórmula incorporada no Quire?
Sim. Use @username para um membro e #{project_id} para um projeto. Observe que #{project_id} só funciona em descrições de organização ou pasta, não em descrições de tarefa ou de projeto.