Função Choices no Power Apps

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

Descrição

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 Caixa de combinação 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 delegar a função Choices. Se esta limitação colocar problemas à sua aplicação, adicione a entidade 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 Galeria, 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

Choices( column-reference )

  • 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.

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 entidades, tais como Contas.

    Nota: os nomes de entidades aparecem no singular em make.powerapps.com e no plural no Power Apps Studio.

    Uma lista parcial dos campos da entidade Conta no Dataverse para Aplicações, a realçar que o campo "Contacto Principal" é um campo de pesquisa

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

    Uma lista parcial dos campos da entidade Contactos no Dataverse

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

  2. Crie uma aplicação a partir da entidade 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.

    Na barra de navegação à esquerda, selecione EditForm1 em EditScreen1

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

    Abra o painel Dados

  5. No painel Campos, selecione Adicionar campo.

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

    Selecione Contas para abrir o painel Dados

    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 Caixa de combinação.

    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 )

      Um ecrã de telas com um controlo de formulário. O controlo Caixa de combinação no cartão Contacto Principal está selecionado e a propriedade Itens na fórmula Choices(Contas."Contacto Principal") é apresentada

  9. Para fins ilustrativos, podemos ver a tabela completa devolvida pela função Choices num controlo de Tabela de Dados. 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 Tabela de dados para esta fórmula:

    Choices( Accounts.'Primary Contact' )

  12. Na parte central do controlo Tabela de dados, 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).

    Um ecrã de telas com um controlo de tabelas de dados. A propriedade Itens é definida para a fórmula Choices(Contas."Contacto Principal") e a tabela mostra as colunas firstname e lastname do primeiro conjunto de registos da entidade Contactos

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).