Partilhar via


Função Distinct

Aplica-se a: Canvas apps Fluxos de área de trabalho CLI de aplicativos Power Pages Power Platform orientados por modelo

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

Distinto ( tabela, fórmula )

  • Tabela - Obrigatório. Tabela a avaliar.
  • Fórmula - 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:

    A coleção CityPopulations mostrada na vista de resultados.

  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:

    Saída da função Distinct mostrada na vista de resultados.

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

    Saída da função Distinct mostrada na tabela de dados.

  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.

    Saída da função Distinct a mostrar o primeiro país/região pelo nome.