Função Choices

Aplica-se a: Aplicações de tela Aplicações condicionadas por modelo

Devolve uma tabela com os valores possíveis de uma coluna de pesquisa.

Description

A função Choices devolve uma tabela com os valores possíveis de uma coluna de pesquisa.

Utilize a função Choices para disponibilizar uma lista de opções que o utilizador possa selecionar. Esta função é utilizada frequentemente com o controlo Combo box nos formulários de edição.

Numa pesquisa, a tabela devolvida por Choices corresponde à tabela externa associada à pesquisa. Ao utilizar a função Choices, não terá necessidade de adicionar a tabela externa como origem de dados adicional. A função Choices devolve todas as colunas da tabela externa.

Visto que Choices devolve uma tabela, pode utilizar as funções Filter, Sort, AddColumns e todas as outras funções de manipulação de tabelas para filtrar, ordenar e formatar a tabela.

Nesta fase, não pode delegarChoices. Se esta limitação colocar problemas à sua aplicação, adicione a tabela externa como origem de dados e utilize-a diretamente.

A função Choices não necessita que os nomes de coluna sejam cadeias e estejam entre aspas, ao contrário de ShowColumns, Search e outras funções de tabela. Indique a fórmula como se estivesse a referenciar diretamente a coluna.

As referências a colunas têm de remeter diretamente à origem de dados. Por exemplo, se a origem de dados for Contas e a pesquisa for SLA, a coluna de referência seria Contas.SLA. A referência não pode passar por uma função, variável ou controlo. Prosseguindo com este exemplo, se a origem de dados Contas for atribuída a um controlo da Gallery, utilize a fórmula Gallery.Selected.SLA para referenciar o SLA da conta selecionada. No entanto, esta referência passou por um controlo, pelo que não pode ser passada para a função Columns: tem de continuar a utilizar Contas.SLA.

Neste momento, só pode utilizar colunas de pesquisa com o SharePoint e o Microsoft Dataverse.

Sintaxe

Escolhas( column-reference [, text-filter ] )

• column-reference — Obrigatório. Uma coluna de pesquisa de uma origem de dados. Não coloque o nome da coluna entre aspas. A referência tem de ser feita diretamente à coluna da origem de dados ao invés de passar por uma função ou controlo.
• text-filter — Opcional. Filtra a lista de escolhas devolvendo apenas as escolhas que comecem com o texto especificado em text-filter. Se for especificada uma cadeia vazia, todas as escolhas serão devolvidas.

Exemplos

Escolhas para uma pesquisa

1. Crie uma base de dados no Dataverse e selecione a caixa Incluir aplicações e dados de exemplo.

   São criadas várias tabelas, tais como Contas.

   Nota: Os nomes das tabelas são singulares em make.powerapps.com e plurais em Power Apps Studio.

   

   A tabela Contas contém a coluna Contacto Principal, que é uma pesquisa da tabela Contactos.

   

   Em cada conta, um contacto é designado como o contacto principal ou este é apresentado blank.

2. Gerar uma app a partir da tabela Contas.

3. Na lista de ecrãs e controlos junto à margem esquerda, desloque-se para baixo até aparecer o campo EditScreen1 e, em seguida, selecione o campo EditForm1 que aparece sob o anterior.

   

4. No separador Propriedades do painel à direita, selecione Editar campos.

   

5. No painel Campos, selecione Adicionar campo.

6. Procure o campo Contacto Principal, selecione a caixa de verificação e, em seguida, selecione Adicionar.

   

   O campo Contacto Princiapl aparece na parte inferior do formulário. Se o campo mostrar um erro, selecione Origens de dados no separador Vista, selecione as reticências (...) para a origem de dados Contas e, em seguida, selecione Atualizar.

7. (opcional) Arraste o campo Contacto Principal do fundo para o topo da lista de campos.

8. No cartão Contacto Principal, selecione o controlo Combo box.

   A propriedade Items desse controlo é definida como uma fórmula que identifica a coluna de acordo com o nome a apresentar, como no primeiro exemplo, ou o seu nome lógico, como no segundo exemplo:

   • Choices( Accounts.'Primary Contact' )

   • Choices( Accounts.primarycontactid )

     

9. Para fins ilustrativos, podemos ver a tabela completa devolvida pela função Choices num controlo de Data table. No separador Home Page, selecione Novo ecrã e, em seguida, selecione Em branco.

10. No separador Inserir, selecione Tabela de dados.

11. Defina a propriedade Items do controlo Data table para esta fórmula:

    Choices( Accounts.'Primary Contact' )

12. Na parte central do controlo Data table, selecione a ligação que começa Escolher os campos... e, em seguida, selecione as caixas de verificação para os campos que pretende mostrar (por exemplo, NomePróprio e Apelido).