Funktionen Choices

Gælder for: Lærredapps Modelbaserede apps

Returnerer en tabel med de mulige værdier for en opslagskolonne.

Description

Funktionen Choices returnerer en tabel med de mulige værdier for en opslagskolonne.

Brug funktionen Choices til at oprette en liste med valgmuligheder, som brugeren kan vælge fra. Denne funktion bruges ofte sammen med Combo box-kontrolelementet i redigeringsformularer.

Ved et opslag matcher tabellen, som Choices returnerer, den fremmedtabel, der er tilknyttet opslaget. Når du bruger Choices, fjerner du behovet for at tilføje fremmedtabellen som en yderligere datakilde. Choices returnerer alle kolonnerne i fremmedtabellen.

Fordi Choices returnerer en tabel, kan du bruge Filter, Sort, AddColumns og alle de andre tabelmanipuleringsfunktioner til at filtrere, sortere og forme tabellen.

Du kan på nuværende tidspunkt ikke delegereChoices. Hvis denne begrænsning udgør et problem i din app, skal du tilføje den fremmede tabel som en datakilde og bruge den direkte.

Choices kræver ikke, at kolonnenavne skal være strenge og omgivet af dobbelte anførselstegn til forskel fra ShowColumns, Search og andre tabelfunktioner. Angiv formlen, som om du refererer direkte til kolonnen.

Kolonnereferencer skal være direkte til datakilden. Hvis datakilden f.eks. er Konti, og opslaget er SLA, så er kolonnereferencen Accounts.SLA. Referencen kan ikke passere gennem en funktion, en variabel eller et kontrolelement. I forlængelse af dette eksempel kan nævnes, at hvis Konti videregives til et Gallery-kontrolelement, skal du bruge formlen Gallery.Selected.SLA til at referere til SLA'en for den valgte konto. Hvis denne reference imidlertid har passeret gennem et kontrolelement, så den kan ikke videregives til funktionen Columns – du skal stadig bruge Accounts.SLA.

På nuværende tidspunkt kan du kun bruge opslagskolonner sammen med SharePoint og Microsoft Dataverse.

Syntaks

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

  • column-reference – påkrævet. En opslagskolonne i en datakilde. Indsæt ikke kolonnenavnet mellem dobbelte anførselstegn. Referencen skal være direkte til kolonnen i datakilden og ikke passeret gennem en funktion eller et kontrolelement.
  • text-filter - valgfrit. Filtrer listen over valgmuligheder ved kun at returnere de valg, der starter med den tekst, der er angivet i tekstfilteret. Hvis der angives en tom streng, returneres alle valgmuligheder.

Eksempler

Valgmuligheder for et opslag

  1. Opret en database i Dataverse, og markér afkrydsningsfeltet Medtag eksempel på apps og data.

    Mange tabeller, f.eks. Konti, oprettes.

    Bemærk: Tabelnavne er i ental på make.powerapps.com og i flertal i Power Apps Studio.

    En delvis liste over felterne fra tabellen Konto i Dataverse til Apps med fremhævning af, at

    Tabellen Konti har en Primær kontakt-kolonne, der er et opslag til tabellen Kontakter.

    En delvis liste over felterne fra tabellen Kontakt i Dataverse.

    For hver konto er en kontakt angivet som den primære kontakt, eller den primære kontakt er tom.

  2. Opret en app ud fra tabellen Konti.

  3. På listen over skærmbilleder og kontrolelementer nær den venstre kant skal du rulle ned, indtil EditScreen1 vises. Vælg derefter EditForm1 lige under den.

    Vælg EditForm1 på EditScreen1 på venstre navigationslinje.

  4. Vælg Rediger felter i ruden til højre på fanen Egenskaber.

    Åbn ruden Data.

  5. Vælg Tilføj felt i ruden Felter.

  6. Søg efter feltet Primær kontakt, markér afkrydsningsfeltet, og vælg derefter Tilføj.

    Vælg Konti for at åbne ruden Data.

    Feltet Primær kontakt vises nederst i formularen. Hvis der vises en fejl i feltet, skal du markere Datakilder under fanen Vis, vælge ellipsen (...) for Konti-datakilderne og derefter vælge Opdater.

  7. (valgfrit) Træk feltet Primær kontakt fra bunden til toppen af listen over felter.

  8. Vælg Combo box-kontrolelementet på kortet Primær kontakt.

    Egenskaben Items for det pågældende kontrolelement er angivet til en formel, der identificerer kolonnen med visningsnavn, som i det første eksempel, eller dets logiske navn som i det andet eksempel:

    • Choices( Accounts.'Primary Contact' )

    • Choices( Accounts.primarycontactid )

      En lærredsskærm med et formularkontrolelement. Kontrolelementet med kombinationsfelt i kortet Primær kontakt er valgt, og egenskaben Items med formlen Choices ( Accounts.'Primary Contact' ) vises.

  9. Du kan f.eks. få vist den fuldstændige tabel, der returneres af funktionen Choices i et Data table-kontrolelement. Vælg Ny skærm på fanen Start, og vælg derefter Tom.

  10. Vælg Data table på fanen Indsæt.

  11. Angiv egenskaben Items for kontrolelementet Data table til denne formel:

    Choices( Accounts.'Primary Contact' )

  12. Markér det link, der starter med Vælg felterne..., i midten af kontrolelementet Data table, og markér derefter afkrydsningsfeltet for det eller de felter, du vil have vist (f.eks. fornavn og efternavn).

    En lærredsskærm med et datatabelkontrolelement. Egenskaben Items er indstillet til formlen Choices( Accounts.'Primary Contact' ), og tabellen viser kolonnerne med fornavn og efternavn for det første sæt af poster fra tabellen Kontakter.