Comentários

Função Choices no Power Apps

  • Artigo
  • 2 minutos para o fim da leitura

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 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 delegar a função Choices. 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

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

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

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

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

    Uma lista parcial dos campos da tabela de contactos em Dataverse.

    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.

    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 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 )

      Um ecrã de telas com um controlo de formulário. O controlo Combo box no cartão Contacto Principal está selecionado e a propriedade Items 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 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).

    Um ecrã de telas com um controlo de tabelas de dados. A propriedade Items é definida para a fórmula Escolhas (Contas."Contacto Principal") e a tabela mostra as colunas firstname e lastname do primeiro conjunto de registos da tabela 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).