Fórmulas de Array no Quire Permalink

Uma fórmula de array no Quire permite trabalhar com uma coleção de valores—como tarefas, subtarefas, responsáveis, números ou durações—de uma só vez. Em vez de calcular os valores um por um, as fórmulas de array permitem realizar cálculos em massa e retornar múltiplos resultados ou um único resultado agregado.

Entendendo as Fórmulas de Array

Um array é uma lista de valores, geralmente separados por vírgulas. Nas fórmulas do Quire, os arrays são comumente retornados quando você referencia múltiplos itens, como subtarefas ou campos de tarefas.

Por exemplo, em vez de calcular a variação do cronograma para uma única tarefa:

timeSpent - estimated

Você pode calcular a variação do cronograma para todas as subtarefas de uma só vez usando uma fórmula de array:

subtasks.timeSpent - subtasks.estimated

Como subtasks retorna uma lista, o Quire executa o cálculo para cada subtarefa individualmente e retorna uma lista de resultados.

Usando Fórmulas de Array para Cálculos Básicos

Operadores Aritméticos

As fórmulas de array suportam todos os operadores numéricos básicos:

• Adição (+)
• Subtração (-)
• Multiplicação (*)
• Divisão (/)

Exemplo de cenário:

• Hora gasta nas subtarefas: 3h, 2h, 1h
• Tempo estimado das subtarefas: 1h, 2h, 3h

Ao escrever:

subtasks.timeSpent

O Quire interpreta como:

[3h, 2h, 1h]

Usando uma fórmula de array:

subtasks.timeSpent - subtasks.estimated

É avaliado como:

 [3h, 2h, 1h] - [1h, 2h, 3h] 

Resultando em:

 [2h, 0h, -2h]

Cada valor no array representa o resultado do cálculo para uma subtarefa.

Usando Fórmulas de Array com Operadores e Funções

Combinação com Funções

As fórmulas de array podem ser usadas em conjunto com os operadores e funções integrados do Quire para análises mais avançadas.

Usando o mesmo exemplo de hora gasta, você pode ordenar os valores e realizar cálculos:

SORT(subtasks.timeSpent) * 2 

Isso é interpretado como:

SORT([3h, 2h, 1h]) * 2

E retorna:

[2h, 4h, 6h]

Isso facilita a transformação e análise de coleções de dados de tarefas.

Filtrando Dados com Fórmulas de Array

Filtrando com where

Você pode filtrar arrays usando o operador where para retornar apenas os itens que atendem a condições específicas.

Exemplo: filtrar subtarefas em que a hora gasta é maior ou igual a 2 horas:

subtasks where any.timeSpent >= 2h 

Isso é avaliado como:

[3h, 2h]

E retorna as tarefas correspondentes:

subtask 1, subtask 2

Esta fórmula pesquisa todas as subtarefas, aplica a condição e retorna apenas os itens correspondentes.

Nota: Use o identificador any com where para especificar a qual campo a condição se aplica.

Leia mais no nosso blog sobre as fórmulas de array do Quire.

Perguntas Frequentes

O que é uma fórmula de array no Quire?

Uma fórmula de array opera sobre uma coleção de valores de uma só vez. Por exemplo, subtasks.timeSpent - subtasks.estimated calcula a variação do cronograma para cada subtarefa e retorna uma lista de resultados.

Como calcular um valor em todas as subtarefas no Quire?

Referencie o campo no objeto subtasks — por exemplo, subtasks.timeSpent - subtasks.estimated calcula a diferença para cada subtarefa e retorna um array de resultados.

Como ordenar um array de valores de subtarefas numa fórmula do Quire?

Envolva o array em SORT() — por exemplo, SORT(subtasks.timeSpent) retorna os valores de hora das subtarefas do menor para o maior. Você pode encadear operações como SORT(subtasks.timeSpent) * 2.

Como filtrar subtarefas por uma condição numa fórmula de array do Quire?

Use o operador where com any — por exemplo, subtasks where any.timeSpent >= 2h retorna apenas as subtarefas em que a hora gasta é de 2 horas ou mais.