Función de eleccións
Aplícase a: Aplicacións de lenzo Aplicacións baseadas en modelos
Devolve unha táboa dos valores posibles para unha columna de busca.
Descripción
A función Opcións devolve unha táboa dos valores posibles para unha columna de busca.
Use a funcións Opcións para proporcionar unha lista de opcións para o que o seu usuario seleccione. Esta función úsase habitualmente co control Caixa de combinación en formularios de edición.
Para facer unha busca, a táboa que Opcións devolve coincide coa táboa externa asociada á busca. Ao empregar Opcións, eliminará a necesidade de engadir a táboa externa como orixe de datos adicional. Opcións devolve todas as columnas da táboa estranxeira.
Debido a que Opcións devolve unha táboa, pode usar Filter, Sort, AddColumns e todas as outras funcións de manipulación de táboas para filtrar, ordenar e dar forma á táboa.
Neste momento, non pode delegarOpcións. Se esta limitación supón un problema na aplicación, engada a táboa externa como orixe de datos e úsea directamente.
Choices non require que os nomes das columnas sexan cadeas e entre comiñas dobres, a diferenza de ShowColumns, Busca, e outras funcións da táboa. Proporcione a fórmula como se estivese facendo referencia á columna directamente.
As referencias ás columnas deben ser directas á orixe de datos. Por exemplo, se a orixe de datos é Contas e a busca é SLA, a referencia da columna sería Contas.SLA. A referencia non pode pasar por unha función, unha variable ou un control. Seguindo este exemplo, se Contas se introduce nun control de Galería, use a fórmula Gallery.Selected.SLA para facer referencia ao SLA da conta seleccionada. Con todo, esta referencia pasou por un control polo que non se pode pasar á función Columnas. Aínda debe usar Accounts.SLA.
Neste momento, só pode usar columnas de busca con SharePoint e Microsoft Dataverse.
Sintaxe
Opcións( referencia-columna [, filtro de texto ] )
- column-reference - Obrigatorio. Unha columna de busca dunha orixe de datos. Non introduza o nome da columna entre comiñas dobres. A referencia debe dirixirse directamente á columna da orixe de datos e non pasar por unha función ou un control.
- text-filter - Opcional. Filtra a lista de opcións devolvendo só as opcións que comezan co texto especificado en text-filter. Se se especifica unha cadea baleira, devolveranse todas as opcións.
Exemplos
Opcións para unha busca
Crea unha base de datos en Dataverse e selecciona a caixa Incluír aplicacións de mostra e datos .
Créanse moitas táboas, comoContas.
Nota: os nomes das táboas son singulares en make.powerapps.com e plural en Power Apps Studio.
A táboa Contas ten unha columna Contacto principal, que é unha busca para a táboa Contactos.
Para cada conta, un contacto é designado como o contacto principal, ou o contacto principal é en branco.
Xera unha aplicación a partir da táboa Contas .
Na lista de pantallas e controis preto do bordo esquerdo, desprácese cara abaixo ata que apareza EditScreen1 e, a continuación, seleccione EditForm1 xusto debaixo.
No separador Propiedades do panel dereito, seleccione Editar campos.
No panel de Campos, seleccione Engadir campo.
Busque o campo Contacto principal, seleccione a súa caixa de verificación e logo seleccione Engadir.
O campo Contacto principal aparecerá na parte inferior do formulario. Se o campo mostra un erro, seleccione Orixes de datos no separador Ver, seleccione os tres puntos (...) para a orixe de datos Contas e logo seleccione Actualizar.
(opcional) Arrastre o campo Contacto principal dende a parte inferior á parte superior da lista de campos.
Na tarxeta para Contacto principal, seleccione o control Caixa de combinación.
A propiedade Items dese control está definida nunha fórmula que identifica a columna polo seu nome de visualización, como no primeiro exemplo, ou polo seu nome lóxico, como no segundo exemplo:
Opcións( Contas. 'Contacto principal' )
Opcións ( Accounts.primarycontactid )
A título ilustrativo, podemos ver a táboa completa devolta pola función Opcións dun control de Táboa de datos. No separador Inicio, seleccione Pantalla nova e, a seguir, seleccione En branco.
No separador Inserir, seleccione Táboa de datos.
Configure a propiedade Items do control Táboa de datos nesta fórmula:
Opcións( Contas. 'Contacto principal' )
Na metade do control de Táboa de datos, seleccione a ligazón que comeza por Escolla os campos... e logo seleccione as caixas de verificación do campo ou campos que desexa amosar (por exemplo, nome e apelidos).