Definir colunas cumulativas que agregam valores

As colunas cumulativas ajudam os usuários a obter insights sobre dados ao monitorar as principais métricas de negócios. Uma coluna cumulativa contém um valor agregado calculado sobre as linhas relacionadas a uma linha específica. Inclui tabelas regulares e tabelas de atividade, como emails e compromissos.

Em cenários mais complexos, você pode agregar dados na hierarquia de linhas. Como administrador ou personalizador, você pode definir colunas cumulativas por meio das ferramentas de personalização do Power Apps, sem precisar escrever código.

Benefícios e recursos de colunas cumulativas

Os benefícios e os recursos de colunas cumulativas incluem:

• A edição visual é fácil. É possível criar colunas cumulativas usando o Editor de Coluna, assim como você faz ao criar uma coluna comum.
• Ampla seleção de funções agregadas. Você pode agregar dados usando as seguintes funções: SUM, COUNT, MIN, MAX e AVG.
• Suporte completo de filtro para agregação. Você pode definir vários filtros para a tabela de origem ou tabela relacionada ao definir várias condições.
• Integração perfeita com a interface do usuário. Você pode incluir as colunas cumulativas em formulários, visualizações, gráficos e relatórios.
• As colunas cumulativas são componentes de solução. É possível transportar facilmente as colunas cumulativas como componentes entre ambientes e distribuí-las em soluções.
• As colunas cumulativas e as colunas calculadas são suplementares entre si. Você pode usar uma coluna cumulativa como parte da coluna calculada e vice-versa.
• É possível configurar colunas cumulativas para que usem controles personalizados.

Alguns exemplos de colunas cumulativas incluem:

• Receita total estimada das oportunidades abertas de uma conta
• Receita total estimada das oportunidades abertas em todas as contas dentro de uma hierarquia
• Receita total estimada de uma oportunidade incluindo oportunidades secundárias
• Valor total estimado de clientes potenciais qualificados gerados por uma campanha
• Número de ocorrências abertas de alta prioridade em todas as contas em uma hierarquia
• Horário de criação mais antigo de todos os casos abertos de alta prioridade para uma conta

Cada coluna cumulativa cria duas colunas acessórias com o sufixo padrão <columnname>_date e <columnname>_state. A coluna _date contém dados de DateTime e a coluna _state contém dados de Integer. A coluna _state tem os seguintes valores:

Valor	Estadual	Description
0	Não Calculado	O valor da coluna ainda deve ser calculado.
1	Calculado	O valor da coluna foi calculado pela última hora de atualização na coluna _date.
2	OverflowError	O cálculo de valores de coluna resultou em erro de estouro.
3	OutroErro	O cálculo do valor de coluna falhou devido a um erro interno. A próxima execução do trabalho de cálculo provavelmente corrigirá o problema.
4	LimiteDeTentativasExcedido	O cálculo do valor da coluna falhou porque o número máximo de tentativas para calcular o valor foi excedido devido ao número alto de conflitos de simultaneidade e bloqueio.
5	LimiteDeRecursãoHierárquicaAtingido	O cálculo do valor de coluna falhou porque o limite máximo de profundidade da hierarquia para o cálculo foi atingido.
6	LoopDetected	O cálculo do valor da coluna falhou porque um loop recursivo foi detectado na hierarquia da linha.
7	MoedaAusente	O cálculo do valor da coluna falhou porque a moeda do campo obrigatório está ausente.

Cálculos de acúmulo

Os rollups são calculados por trabalhos do sistema programados que operam de maneira assíncrona em segundo plano. É necessário ter privilégios de administrador para visualizar e gerenciar as tarefas de agregação.

Visualizar trabalhos de agregação

Para exibir tarefas de agregação:

1. Entre no Power Apps e selecione o ambiente desejado.
2. Selecione Configurações (engrenagem) >Configurações avançadas.
3. No painel de navegação esquerdo, selecione Trabalhos do Sistema.
4. No seletor de exibição, escolha Trabalhos do Sistema Recorrentes.
5. Para localizar rapidamente um trabalho relevante, você pode filtrar pelo Tipo de Trabalho do Sistema: Calcular Campo Cumulativo em Massa ou Calcular Campo Cumulativo.

Calcular Campo de Consolidação Massivamente

Calcular Campo Cumulativo Em Massa é um trabalho recorrente, criado para cada coluna cumulativa. Ele é executado uma vez, depois de criar ou atualizar uma coluna cumulativa. O trabalho recalcula o valor da coluna de resumo especificada em todos os registros existentes que contenham essa coluna. Por padrão, o trabalho será executado 12 horas após a criação ou atualização de uma coluna. Quando a coluna for modificada, o trabalho será reiniciado para executar novamente em 12 horas após a atualização. O atraso de 12 horas é necessário para garantir que o Campo de Cálculo Cumulativo em Massa seja executado durante as horas não operacionais do ambiente.

É recomendável que um administrador ajuste a hora de início do trabalho Calcular Campo Cumulativo em Massa após a coluna cumulativa ser criada ou modificada, de forma que seja executado durante as horas não operacionais. Por exemplo, um bom horário para executar a tarefa seria à meia-noite para garantir um processamento eficiente das colunas de rolamento.

Observe que, quando ocorrer uma situação em que a coluna cumulativa nunca é atualizada, o trabalho Calcular Campo Cumulativo Em Massa não será mais executado para essa coluna até que 10 anos tenham se passado. Esse comportamento é por design. Quando não houver atualizações nas colunas subjacentes associadas ao campo cumulativo, não haverá motivo para executar o trabalho com mais frequência.

Calcular campo de agregação

Calcular Campo Cumulativo é um trabalho recorrente que realiza cálculos incrementais de todas as colunas cumulativas nas linhas existentes de uma tabela específica. Existe apenas um trabalho Calcular Campo Cumulativo por tabela. Os cálculos incrementais significam que o trabalho Calcular Campo Cumulativo processa as linhas criadas, atualizadas ou excluídas após a execução do último trabalho Calcular Campo Cumulativo em Massa. A configuração padrão mínima de recorrência é de uma hora. O trabalho é criado automaticamente quando a primeira coluna cumulativa em uma tabela é criada e ele é excluído quando a coluna cumulativa mais recente é excluída.

Opção de recálculo online

A coluna cumulativa no formulário exibe uma imagem da calculadora, o valor acumulado e a hora do último cálculo. Para recalcular, selecione a imagem da calculadora e, em seguida, selecione o botão Recalcular que é exibido.

Há algumas considerações que você deve sempre se lembrar ao usar a opção Recálculo online (atualização manual no formulário):

• Você deve ter privilégios de gravação na tabela e escrever direitos de acesso na linha de origem na qual está solicitando a Atualização. Por exemplo, se você estiver calculando a receita estimada das oportunidades abertas de uma conta, não precisará ter permissões de escrita na tabela de oportunidades, apenas na tabela de contas.
• Esta opção está disponível apenas no modo online. Não é possível usá-la no modo offline.
• O número máximo de linhas durante a atualização do rollup é limitado a 50.000 linhas. Em caso de rollup hierárquico, isso se aplica às linhas relacionadas na hierarquia. Se o limite for excedido, você verá uma mensagem de erro: Não é possível realizar cálculos online porque o limite de cálculo de 50.000 linhas relacionadas foi atingido. Esse limite não se aplica quando o acúmulo é recalculado automaticamente pelos trabalhos do sistema.
• A profundidade máxima da hierarquia está limitada a 10 para a linha de origem. Se o limite for excedido, você verá uma mensagem de erro: Não é possível realizar cálculos online porque o limite de profundidade da hierarquia de 10 para a linha de origem foi atingido. Esse limite não se aplica quando o acúmulo é recalculado automaticamente pelos trabalhos do sistema.

Modificar a recorrência de trabalhos de acúmulo

Como administrador do sistema, você pode alterar o padrão de recorrência do trabalho de rollup, adiar, pausar ou retomar o trabalho de rollup. No entanto, você não poderá cancelar ou excluir uma tarefa de rollup.

Para pausar, adiar, retomar ou modificar o padrão de recorrência, é necessário exibir os trabalhos do sistema. Mais informações Exibir trabalhos de Rollup

Na barra de navegação, escolha Ações e selecione a ação que você deseja.

Para o trabalho Calcular Campo Cumulativo em Massa, as seleções disponíveis são: Retomar, Adiar e Pausar.

Para a tarefa Calcular Campo Cumulativo, as seleções disponíveis são: Modificar Recorrência, Retomar, Adiar e Pausar.

Exemplos

Vamos analisar vários exemplos de coluna cumulativa. Agregaremos dados para uma linha a partir das linhas relacionadas, com e sem o uso de uma hierarquia. Também agregaremos dados para uma linha a partir de atividades relacionadas e atividades indiretamente relacionadas a uma linha por meio da tabela ActivityParty. Em cada exemplo, definimos a coluna de rollup usando o Editor de Colunas. Para abrir o Editor do Coluna, abra o gerenciador de soluções e expanda Componentes>Tabelas. Selecione a tabela desejada e selecione Colunas. Escolha Novo. No editor, forneça as informações necessárias para a coluna, incluindo Tipo de Coluna e Tipo de Dados. No Tipo de Coluna, selecione Consolidação, após selecionar o tipo de dados. Os tipos de dados incluem números decimais ou inteiros, moeda e data/hora. Escolha o botão Editar ao lado de Tipo de Coluna. Isso o leva para o editor de definição da coluna cumulativa. A definição da coluna cumulativa consiste em três seções: Tabela de origem, **Tabela relacionada e Agregação.

• Na seção Tabela de origem, especifique a tabela para a qual a coluna de rollup é definida e se você agrega ou não em uma hierarquia. Você pode adicionar filtros com várias condições para especificar as linhas na hierarquia que você deseja usar para rollup.

• Na seção Tabela relacionada, especifique a tabela na qual você agrega. Esta seção é opcional quando você opta por agregar na hierarquia da tabela de origem. Você pode adicionar filtros com várias condições para especificar quais linhas relacionadas usar no cálculo. Por exemplo, você inclui a receita das oportunidades abertas com uma receita anual maior que R$ 1.000,00.

• Na seção Agregar, especifique a métrica para computar. Você pode escolher as funções agregadas disponíveis, como SUM, COUNT, MIN, MAX ou AVG.

Agregar informações para uma linha a partir de dados de linhas relacionadas

Neste exemplo, uma hierarquia não é usada. A receita estimada total é calculada para uma conta, de oportunidades abertas relacionadas.

Dados de uma linha agregados a partir das linhas filhas na hierarquia

Neste exemplo, calculamos a receita total estimada de uma oportunidade incluindo oportunidades secundárias, na hierarquia.

Agregue dados de uma linha a partir das linhas relacionadas, dentro da hierarquia

Neste exemplo, calculamos a receita total estimada de oportunidades abertas em todas as contas, ao longo da hierarquia.

Agregar dados de todas as atividades relacionadas para uma linha

Neste exemplo, calculamos o tempo total gasto e cobrado de todas as atividades relacionadas a uma conta. Isso pode incluir o tempo gasto ao telefone, em compromissos ou em atividades personalizadas.

Em versões anteriores, você pode definir uma coluna cumulativa para uma atividade individual, como um telefonema, um fax ou um compromisso. Mas, para obter os resultados do exemplo mostrado abaixo, você precisou obter o total dos dados usando as colunas calculadas. Agora, você pode fazer tudo em uma etapa ao definir uma coluna cumulativa para a tabela Atividade.

Agregar dados para uma linha de todas as atividades relacionadas e atividades indiretamente relacionadas por meio da tabela de Participantes da Atividade

Neste exemplo, contamos o número total de emails enviados para uma conta, em que a conta está listada na linha "Para o Destinatário" ou na linha "Destinatário em Cc" do email. Isso é feito por meio da especificação do Tipo de Participação em FILTROS para a tabela de Parte de Atividade na definição da coluna cumulativa. Se você não usar a filtragem, todos os tipos de participação disponíveis para uma atividades serão usados no cálculo.

Para obter mais informações sobre a tabela Activity Party e os tipos de participação disponíveis para uma atividade específica, consulte tabela Activity Party.

Agregar dados para uma linha a partir de linhas relacionadas usando o operador AVG

Neste exemplo, calculamos uma receita estimada média de todas as oportunidades relacionadas a uma conta.

O exemplo a seguir mostra como calcular uma receita estimada média de oportunidades relacionadas em uma hierarquia de contas. Uma receita média estimada pode ser observada em cada nível da hierarquia.

Considerações da coluna de resumo

Você deve estar ciente de certas condições e restrições ao trabalhar com colunas cumulativas:

• Por padrão, você pode definir um máximo de 200 colunas de agregação para o ambiente e até 50 colunas de agregação por tabela. Mais informações: Definir o número máximo de colunas cumulativas em um ambiente ou tabela
• Não é possível ativar um fluxo de trabalho pelas atualizações da coluna agregadora.
• Uma condição de espera do fluxo de trabalho não pode usar uma coluna cumulativa.
• Uma acumulação sobre a coluna de acumulação não é suportada.
• Um rollup não pode referenciar uma coluna calculada que utiliza outra coluna calculada, mesmo que todas as colunas da outra coluna calculada estejam na tabela atual.
• Uma coluna de valor acumulado não será atualizada automaticamente se usar uma coluna de fórmula dependente de funções vinculadas ao tempo, como Now() e IsUTCToday(). A opção de recálculo online (uma atualização manual no formulário) ou o botão Recalcular devem ser usados para calcular o valor mais recente da coluna de agregação.
• O rollup só pode aplicar filtros à tabela de origem ou a tabelas relacionadas, colunas simples ou colunas calculadas que não sejam complexas.
• Um rollup pode ser realizado apenas em tabelas relacionadas com o relacionamento 1:N. Não é possível realizar uma agregação em relacionamentos N:N.
• Não é possível fazer uma acumulação no relacionamento 1:N para a tabela de Atividades ou a tabela de Participantes da Atividade.
• As regras de negócios, os fluxos de trabalho ou as colunas calculadas sempre usam o último valor calculado da coluna cumulativa.
• Uma coluna cumulativa é agregada no contexto do usuário do sistema. Todos os usuários podem visualizar o mesmo valor da coluna de agregação. Você pode controlar a visibilidade da coluna cumulativa com a segurança em nível de coluna (FLS), restringindo quem pode acessar a coluna cumulativa. Mais informações Segurança em nível de coluna para controlar o acesso.

Definir o número máximo de colunas cumulativas em um ambiente ou tabela

Por padrão, você pode definir um máximo de 200 colunas de agregação para o ambiente e até 50 colunas de agregação por tabela.

Para alterar o máximo, siga estas etapas:

1. ACesse o Power Apps (make.powerapps.com), selecione Tabela no painel de navegação esquerdo e abra a tabela Organização.
2. Selecione a lista nmais e, em seguida, digite maxr na caixa Pesquisar. Selecione as colunas MaxRollupFieldsPerOrg e MaxRollupFieldsPerEntity e, em seguida, selecione Salvar.
3. Altere os valores de MaxRollupFieldsPerOrg (até 200) e MaxRollupFieldsPerEntity (até 50) que você deseja.

Importante

Ter mais de 100 colunas acumuladas em um ambiente pode resultar em desempenho degradado dessas colunas e maior consumo de armazenamento.

Arredondamento de precisão

Se a precisão da coluna agregada for superior à da coluna consolidada, a precisão da coluna agregada será arredondada para a precisão da coluna consolidada antes de realizar a agregação. Para ilustrar esse comportamento, vamos analisar um exemplo específico. Digamos que a coluna cumulativa na tabela de contas, para calcular a receita total estimada das oportunidades relacionadas, tenha uma precisão de dois pontos decimais. A coluna Coluna de receita na tabela de oportunidade é a coluna agregada com a precisão de quatro pontos decimais. No nosso exemplo, a conta tem duas oportunidades relacionadas. A soma da agregação da receita estimada é calculada da seguinte forma:

1. Rec. Receita da primeira oportunidade: US$ 1000,0041
2. Rec. Receita da segunda oportunidade: US$ 2.000,00
3. Soma agregada de Estimativa Receita: US$1.000,00 + US$2.000,00 = US$3.000,00

Como você pode ver, o arredondamento da precisão para dois pontos decimais na coluna agregada é feito antes da agregação ser executada.

Comportamento diferente das grelhas associadas

Certos formulários de tabela, como Conta ou Contato, prontos para uso, contêm as tabelas associadas. Por exemplo, o formulário Conta inclui Contatos, Ocorrências, Oportunidades e outros quadros. Algumas das linhas mostradas nas grades do formulário Conta são associadas diretamente à linha de conta; outras, de forma indireta, pelos relacionamentos com outras linhas. Em comparação, a agregação da coluna de resumo usa apenas relacionamentos diretos definidos explicitamente na definição da coluna de resumo. Nenhuma outra relação será considerada. Para ilustrar a diferenças de comportamento, vamos analisar o exemplo a seguir.

1. A conta A1 tem um contato primário, P1. A ocorrência C1 está associada à conta A1 (coluna C1.Customer = A1) e o caso C2 está associado ao contato P1 (coluna C2.Customer = P1).
2. A grade de Casos no formulário de Conta para a linha A1 mostra dois casos: C1 e C2.
3. A coluna cumulativa na tabela de contas, chamada Total de Casos, é usada para contar os casos associados à conta.
4. Na definição da coluna de consolidação da conta, especificamos os casos que têm o relacionamento de Cliente com a conta. Depois da agregação, o Número total de ocorrências é igual a 1 (ocorrência C1). O caso C2 não está incluído no total porque está diretamente relacionado ao contato, não à conta, e não é possível definir explicitamente na definição da coluna de consolidação da conta. Como resultado, o número total de casos retornado pela operação de rollup não corresponderá ao número de casos exibidos na grade Ocorrências.

Consulte também

Criar e editar colunas
Definir colunas calculadas
Colunas especializadas
Comportamento e formato da coluna de Data e Hora
Definir e consultar dados relacionados hierarquicamente