Função Choices

  • Artigo

Aplica-se a: Aplicativos de tela Aplicativos baseados em modelo

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

Description

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

Use a função Choices para fornecer uma lista de opções a serem selecionadas pelo usuário. Essa função é geralmente usada com o controle Combo box em formulários de edição.

Para uma pesquisa, a tabela retornada por Choices corresponde à tabela estrangeira associada à pesquisa. Usando a função Choices, você elimina a necessidade de adicionar a tabela estrangeira como uma fonte de dados adicional. A função Choices retorna todas as colunas da tabela estrangeira.

Como a função Choices retorna uma tabela, você pode usar Filter, Sort, AddColumns e todas as outras funções de manipulação de tabela para filtrar, classificar e formatar a tabela.

No momento, não é possível delegarChoices. Se essa limitação for um problema em seu aplicativo, adicione a tabela estrangeira como uma fonte de dados e use-a diretamente.

A função Choices não exige que os nomes de coluna sejam cadeias de caracteres nem que sejam colocados entre aspas duplas, ao contrário de ShowColumns, Search e outras funções de tabela. Forneça a fórmula como se estivesse referenciando a coluna diretamente.

As referências de coluna precisam ser feitas diretamente à fonte de dados. Por exemplo, se a fonte de dados for Accounts e a pesquisa for SLA, a referência de coluna será Accounts.SLA. A referência não pode passar por uma função, uma variável ou um controle. Detalhando este exemplo, se Accounts for alimentado em um controle Gallery, use a fórmula Gallery.Selected.SLA para referenciar o SLA da conta selecionada. No entanto, essa referência passou por um controle e, portanto, não pode ser passada para a função Columns – você ainda precisará usar Accounts.SLA.

No momento, você pode usar colunas de pesquisa apenas com SharePoint e Microsoft Dataverse.

Sintaxe

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

  • column-reference – obrigatória. Uma coluna de pesquisa de uma fonte de dados. Não coloque o nome da coluna entre aspas duplas. A referência precisa ser feita diretamente à coluna da fonte de dados e não passar por uma função ou um controle.
  • text-filter - opcional. Filtra a lista de opções retornando apenas opções que começam com o texto especificado em text-filter. Se uma cadeia de caracteres vazia for especificada, todas as opções serão retornadas.

Exemplos

Opções para uma pesquisa

  1. Crie um banco de dados no Dataverse e selecione a caixa Incluir aplicativos e dados de exemplo.

    Muitas tabelas, como Accounts, são criadas.

    Observação: os nomes das tabelas estão no singular no site make.powerapps.com e no plural no Power Apps Studio.

    Uma lista parcial dos campos da tabela Account no Dataverse para Aplicativos, realçando que

    A tabela Accounts tem uma coluna Primary Contact, que é uma pesquisa da tabela Contacts.

    Uma lista parcial dos campos da tabela Contact no Dataverse.

    Para cada conta, um contato é designado como o contato principal, ou o contato principal fica em branco.

  2. Gere um aplicativo da tabela Accounts.

  3. Na lista de telas e controles próxima à borda esquerda, role a tela para baixo até que EditScreen1 seja exibido e, em seguida, selecione EditForm1 logo abaixo dele.

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

  4. Na guia Propriedades do painel direito, selecione Editar campos.

    Abra o painel Dados.

  5. No painel Campos, selecione Adicionar campo.

  6. Procure o campo Contato Principal, marque sua caixa de seleção e selecione Adicionar.

    Selecionar Accounts para abrir o painel Dados.

    O campo Contato Principal aparece na parte inferior do formulário. Se o campo mostrar um erro, selecione Fontes de dados na guia Exibir, selecione as reticências (...) para a fonte de dados Contas e selecione Atualizar.

  7. (opcional) Arraste o campo Contato Principal na parte inferior até a parte superior da lista de campos.

  8. No cartão de Contato Principal, selecione o controle Combo box.

    A propriedade Items desse controle é definida como uma fórmula que identifica a coluna pelo nome de exibição, como no primeiro exemplo, ou pelo nome lógico, como no segundo exemplo:

    • Choices( Accounts.'Primary Contact' )

    • Choices( Accounts.primarycontactid )

      Uma tela com um controle de formulário. O controle Combo box no cartão Primary Contact está marcado e a propriedade Items com a fórmula Choices( Accounts.'Primary Contact' ) é exibida.

  9. Para fins ilustrativos, podemos exibir a tabela completa retornada pela função Choices em um controle Data table. Na guia Página Inicial, selecione Nova tela e, em seguida, selecione Em branco.

  10. Na guia Inserir, selecione Tabela de dados.

  11. Defina a propriedade Items do controle Data table como esta fórmula:

    Choices( Accounts.'Primary Contact' )

  12. No meio do controle Data table, selecione o link que começa com Escolha os campos... e então marque as caixas de seleção do campo ou campos que você deseja mostrar (por exemplo, firstname e lastname).

    Uma tela com um controle de tabela de dados. A propriedade Items é definida como a fórmula Choices( Accounts.'Primary Contact' ) e a tabela mostra as colunas firstname e lastname para o primeiro conjunto de registros da tabela Contacts.