Função Distinct

Aplica-se a: Aplicativos Canvas Fluxos de desktop Aplicativos orientados a modelos Power Pages Power Platform CLI

Resume os registros de uma tabela, removendo as duplicatas.

Description

A função Distinct avalia uma fórmula em cada registro de uma tabela e retorna uma tabela de uma coluna dos resultados com os valores duplicados removidos. O nome da coluna é Value.

Os campos do registro que está sendo processado no momento estão disponíveis na fórmula. Use o operador ThisRecord ou simplesmente referencie os campos por nome como faria com qualquer outro valor. O operador Astambém pode ser usado para nomear o registro que está sendo processado, o que pode ajudar a tornar sua fórmula mais fácil de entender e tornar os registros aninhados acessíveis. Para obter mais informações, veja os exemplos abaixo e consulte trabalhando com escopo de registros.

Quando usada em uma fonte de dados, esta função não poderá ser delegada. Somente a primeira parte da fonte de dados será recuperada e então a função será aplicada. O resultado pode não representar a história completa. Um aviso pode ser exibido no momento da criação para lembrá-lo dessa limitação e para sugerir a troca para alternativas delegáveis sempre que possível. Para obter mais informações, consulte visão geral de delegação.

Sintaxe

Distinto( Tabela, Fórmula )

• Tabela - Obrigatório. Tabela para avaliação.
• Fórmula - Obrigatório. Fórmula para avaliar cada registro.

Exemplo

1. Insira um controle Button e defina sua propriedade OnSelect para esta fórmula.

   ClearCollect( CityPopulations,
       { City: "London",    Country: "United Kingdom", Population: 8615000 },
       { City: "Berlin",    Country: "Germany",        Population: 3562000 },
       { City: "Madrid",    Country: "Spain",          Population: 3165000 },
       { City: "Hamburg",   Country: "Germany",        Population: 1760000 },
       { City: "Barcelona", Country: "Spain",          Population: 1602000 },
       { City: "Munich",    Country: "Germany",        Population: 1494000 }
   );
   

2. Selecione o botão enquanto mantém pressionado a tecla Alt.

   A fórmula é avaliada e a coleção CityPopulations é criada, que pode ser exibida selecionando CityPopulations na barra de fórmulas:

   

3. Insira um controle Data table e defina a propriedade Items como esta fórmula:

   Distinct( CityPopulations, Country )
   

   Para visualizar o resultado dessa fórmula na barra de fórmulas, selecione a fórmula inteira:

   

4. Use o link Editar campos no painel de propriedades da tabela de dados para adicionar a coluna Valor:

   

5. Insira um controle Label e defina a propriedade Text com a fórmula:

   First( Sort( Distinct( CityPopulations, Country ), Value ) ).Value
   

   Esta fórmula classifica os resultados de Distinct com a função Sort, utiliza o primeiro registro da tabela resultante com a função First e extrai o campo Resultado para obter apenas o nome do país/região.