Função Distinct

Aplica-se a: Aplicações de tela Fluxos de ambiente de trabalho Aplicações condicionadas por modelo Power Platform CLI

Resume registos de uma tabela ao remover duplicados.

Descrição

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

Os atuais campos do registo em processamento estão disponíveis na fórmula. Utilize o operador ThisRecord ou simplesmente campos de referência pelo nome, como com qualquer outro valor. O operador As também pode ser usado para nomear o registo que está a ser processado, o que pode ajudar a tornar a sua fórmula mais fácil de compreender e tornar os registos aninhados acessíveis. Para mais informações, consulte os exemplos abaixo e trabalhar com o âmbito de registo.

Quando utiliza com uma origem de dados, esta função não pode ser delegada. Só será obtida a primeira parte da origem de dados e, em seguida, a função aplicada. O resultado pode não representar o cenário completo. Poderá aparecer um aviso à hora de criação para lembrá-lo desta limitação e para sugerir que mude para alternativas delegáveis sempre que possível. Para mais informações, consulte a descrição geral de delegação.

Sintaxe

Distinct( Table, Formula )

• Table – Obrigatório. Tabela a avaliar.
• Formula – Obrigatório. Fórmula a avaliar para cada registo.

Exemplo

1. Insira um controlo Button e defina a respetiva 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 premida a tecla Alt.

   A fórmula é avaliada e é criada a coleção CityPopulations, que pode mostrar ao selecionar CityPopulations na barra de fórmulas:

   

3. Insira um controlo Data table e defina a respetiva propriedade Items para esta fórmula:

   Distinct( CityPopulations, Country )
   

   Pode ver o resultado desta fórmula na barra de fórmulas ao selecionar a fórmula completa:

   

4. Utilize a ligação Editar campos no painel de propriedades da tabela de dados para adicionar a coluna Valor:

   

5. Insira um controlo Label e defina a respetiva propriedade Text para a fórmula:

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

   Esta fórmula ordena os resultados de Distinct com a função Sort, pega no primeiro registo da tabela resultante com a função First e extrai o campo Result para obter apenas o nome do país/região.