Criando agregados de conjunto

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 5 min. de leitura
  • Você pode coletar a média, a contagem, o máximo, o mínimo e a soma dos dados em qualquer campo de um conjunto usando um conjunto agregado.

    Os agregados de conjunto coletam os dados de cada campo no conjunto e geram o resultado. As opções incluem média, contagem, máximo, mínimo e soma. Por exemplo, um agregado de soma em um campo numérico chamado Quantidade armazenará a soma de todos os valores do campo de quantidade no conjunto. Esses agregados funcionam como um campo fora do conjunto, podem ser usados em regras globais e podem ser exibidos em qualquer lugar no layout.

    Para criar um agregado, abra um conjunto, role até o subcampo que você deseja agregar e clique em Criar novo agregado . Em seguida, você pode escolher o tipo de agregado e dar um nome ao novo agregado.

    Você pode adicionar o agregado ao layout como qualquer outro campo e implantá-lo.

    Definir layout

    Abaixo está o novo agregado de soma durante o tempo de execução:

    Tela Criar conjunto

    Nota:
    O agregado Soma do sanduíche representa a soma do campo Quantidade. Isso não deve ser confundido com o tamanho do sanduíche de 3, que é o número de linhas no conjunto.

    Embora os cinco tipos agregados pareçam simples, há detalhes importantes sobre como eles funcionam com campos boolianos, campos de lista de seleção e campos com valores em branco. As seções a seguir esclarecem esses detalhes.

    O agregado Contagem

    Esse agregado pode causar mais confusão. A contagem pode ser definida como "contar o número de vezes que o campo definiu valores no conjunto". Ele conta instâncias dos seguintes tipos de valores:

    • Não está em branco
    • Diferente de zero
    • Não falso

    Para listas de seleção de seleção única e múltipla, o agregado de contagem é baseado em quantos índices têm um valor selecionado. O agregado Contagem para o campo de amostra a seguir seria 2, porque os índices 1 e 2 têm valores. Os índices 3, 4 e 5 contamnʼt porque estão em branco.

    O agregado Contagem

    Nota:
    Para listas de seleção de seleção múltipla, não importa quantos valores sejam selecionados, ele conta como um.

    Campo numérico

    Campo numérico

    O agregado de contagem neste campo seria 3 (do índice 1, 2 e 3).

    Campo booliano

    Campo booliano

    O agregado de contagem neste seria 2.

    Os agregados Média, Mínimo, Máximo e Soma

    Um agregado médio é executado em todas as iterações do campo Número no conjunto, incluindo valores zero. Isso está em contraste com os agregados de contagem, que ignoram valores de número zero.

    Os agregados Média, Mínimo, Máximo e Soma

    Neste campo de número, os índices 1, 2, 3 e 4 somam uma quantidade de 8. Como o índice 3 com o valor 0 está incluído, 4 é o divisor e a média é de 8/4: 2.

    Este comportamento "incluindo zero" também é verdadeiro para agregados de soma, agregados mínimos e agregados máximos. No exemplo acima, o valor agregado mínimo é 0, pois esse é o menor valor.

    Um agregado médio em um campo booliano geralmente estará na forma decimal. Isso permite que o usuário saiba qual porcentagem dos índices está selecionada como verdadeira. No campo booliano a seguir, três dos valores da opção Selecionar dos seis índices são verdadeiros e o agregado resultante é 0,5.

    Os agregados Média, Mínimo, Máximo e Soma

    Um agregado de soma mostrará o número de campos boolianos marcados como verdadeiro. No exemplo fornecido, o agregado é 3.

    Um agregado máximo será 0, a menos que um dos campos boolianos seja selecionado, caso em que será 1.

    Um agregado mínimo será 0, a menos que todos os campos boolianos sejam selecionados, caso em que será 1.

    Agregados em subcampos da lista de seleção

    Quatro dos cinco agregados (média, mínimo, máximo e soma) funcionam somente em valores numéricos, não em texto. Portanto, se você adicionar um desses agregados em um campo definido que é uma lista de seleção, receberá um erro depois de implantar e selecionar uma opção de campo de texto.

    Por exemplo, suponha que dois campos foram criados. Ambos os campos tinham as mesmas opções de campo, mas um é uma lista de seleção de seleção única e um é uma lista de seleção de seleção múltipla. Estas são as opções de campo:

    Agregados em subcampos da lista de seleção

    A quarta opção de campo usa a palavra "quatro" em vez do número 4. Como observado acima, quando implantado e "quatro" é selecionado, ocorre uma mensagem de erro:

    Agregados em subcampos da lista de seleção

    Mas se selecionarmos as opções baseadas em números, os agregados funcionarão.

    Agregados em subcampos da lista de seleção

    No campo de lista de seleção única a seguir, há quatro índices. A lista de seleção "Tempo de notificação" tem o rótulo de opção exibido como texto, mas, nos bastidores, o valor da opção é numérico.

    Agregados em subcampos da lista de seleção

    Os quatro valores selecionados são "um minuto" (1), "dois minutos" (2), em branco e "cinco minutos" (5). Ao aplicar cada um dos agregados ao campo de seleção de seleção única, o resultado é:

    • Soma: 8: 1, 2, 0 e 5
    • Máximo: 5 (o maior valor de opção de campo selecionado)
    • Mínimo: 1 (o índice em branco não se aplica ao mínimo)
    • Média: 2,66 (1 e 2 e 5) / 3 (o índice em branco não conta para o total e o divisor)
    • Contagem: 3 (o valor em branco não se aplica a um agregado de contagem)

    Lembre-se de que os valores da lista de seleção em branco contam para os agregados mínimo, máximo, soma e média.

    No campo de lista de seleção a seguir, o tempo de notificação foi convertido em uma lista de seleção de seleção múltipla. Os quatro índices têm os seguintes valores de opção: [1, 5], [2], [ ] e [2, 5].

    Agregados ao campo

    Ao aplicar cada um dos agregados ao campo, os resultados são:

    • Soma: 15 (1 e 5) 2 e 0 (2 e 5)
    • Máximo: 5 (ainda é o maior valor selecionado na lista de seleção. Não é o valor combinado no índice. Para fazer isso, crie um campo e uma regra no conjunto para adicionar os valores da lista de seleção de seleção múltipla juntos)
    • Mínimo: 0 (a linha em branco se aplica ao mínimo)
    • Média: 3,75: [(1 e 5) 2 e 0 (2 e 5)] / 4 (A linha em branco conta para o total e o divisor. O divisor é o número de índices, não o número de opções de campo da lista de seleção selecionadas)
    • Contagem: 3 (o valor em branco não se aplica a um agregado de contagem)

    Lembre-se: Os agregados Média, Mínimo, Máximo e Soma só funcionam para campos da lista de seleção se os valores da opção de campo forem do tipo Número. Se os valores da opção de campo forem do tipo texto, os usuários enfrentarão um erro no tempo de execução.

    O campo a seguir é o campo configurado para os exemplos neste tópico. Observe que o Tipo de comparação é Número e os valores são números.

    Agregados ao campo