Funktionerne Filter, Search og LookUp

Gælder for: Lærredapps Skrivebordsflow Modelbaserede apps Power Pages Power Platform CLI

Finder en eller flere poster i en tabel.

Se denne video for at få mere at vide om, hvordan du bruger funktionerne Filter, **Søg og Slå op:

Bemærk

PAC CLI pac power-fx-kommandoer understøtter ikke søgefunktionen .

Beskrivelse

Funktionen Filter finder de poster i en tabel, som opfylder en formel. Brug Filter til at finde et sæt poster, der matcher et eller flere kriterier, og se bort fra de poster, der ikke gør.

Funktionen LookUp finder den første post i en tabel, som opfylder en formel. Brug LookUp til at finde en enkelt post, der opfylder et eller flere kriterier.

For begge funktioner bliver formlen evalueret for hver post i tabellen. De poster, der resulterer i sand, medtages i resultatet. Ud over de almindelige operatorer kan du bruge operatorerne in og exactin til at matche delstrenge.

Felter i den post, der behandles i øjeblikket, er tilgængelige i formlen. Brug ThisRecord-operatoren, eller referer blot til feltet med navn, som du ville gøre med en vilkårlig anden værdi. As-operatoren kan også bruges til at navngive den post, der behandles, hvilket kan hjælpe med at gøre din formel mere forståelig og gøre indlejrede poster tilgængelige. Du kan få flere oplysninger i eksemplerne nedenfor og arbejdet med posternes omfang.

Funktionen Search finder de poster i en tabel, der indeholder en streng i en af kolonnerne. Strengen kan være overalt i kolonnen, og en søgning f.eks. efter "rob" eller "bert" vil finde et match i en kolonne, der indeholder "Robert". Der skelnes ikke mellem store og små bogstaver i søgninger. Til forskel fra Filter og LookUp bruger funktionen Search en enkelt streng til matchningen i stedet for en formel.

Filtrer og Søg returnerer en tabel, der indeholder de samme kolonner som den oprindelige tabel og de poster, der opfylder kriterierne. LookUp returnerer kun den første post, der findes, efter at der er anvendt en formel til at reducere posten til en enkelt værdi. Hvis der ikke findes nogen poster, vil Filter og Search returnere en empty tabel, og LookUp vil returnere tom.

Tabeller er en værdi i Power Apps, ligesom en streng eller et tal. De kan overføres til og returneres fra funktioner. Filter, Søg og Opslag ændrer ikke en tabel. De bruger i stedet en tabel som argument og returnerer en tabel, en post eller en enkelt værdi fra tabellen. Se Arbejde med tabeller for at få flere oplysninger.

Delegering

Hvis det er muligt, uddelegerer Power Apps filtrerings- og sorteringshandlinger til datakilden og -siden via resultaterne efter behov. Når du f.eks. starter en app, som viser et Galleri-kontrolelement fyldt med data, hentes indledningsvist kun første sæt af poster til enheden. Når brugeren ruller, hentes yderligere data fra datakilden. Resultatet er en hurtigere opstartstid for appen og adgang til meget store datasæt.

Det er dog ikke altid muligt at foretage uddelegering. Datakilder varierer med hensyn til de funktioner og operatorer, de understøtter med uddelegering. Hvis en komplet uddelegering af en formel ikke er mulig, vil oprettelsesmiljøet markere den del, som ikke kan uddelegeres, med en advarsel. Hvis det er muligt, kan du overveje at ændre formlen for at undgå funktioner og operatorer, som ikke kan uddelegeres. Uddelegeringslisten viser, hvilke datakilder og handlinger som ikke kan uddelegeres.

Hvis uddelegering ikke er mulig, henter Power Apps kun et lille sæt af poster for at arbejde med dem lokalt. Filtrerings- og sorteringsfunktioner fungerer på et reduceret antal poster. Det, der er tilgængeligt i galleriet, er muligvis ikke hele historien, hvilket kan være forvirrende for brugerne.

Se uddelegeringsoversigten for at få flere oplysninger.

Syntaks

Filter(Tabel*; Formel1 [;*Formel2*;... ] )

• Tabel - Påkrævet. Den tabel, der skal søges i.
• Formler - Påkrævet. Den formel, som hver post i tabellen evalueres for. Funktionen returnerer alle de poster, der giver resultatet sand. Du kan referere til kolonner i tabellen. Hvis du angiver mere end én formel, vil resultaterne for alle formlerne blive kombineret med funktionen And.

Søg(Tabel*; Søgestreng; Kolonne1 [, *Kolonne2*; ... ] )

• Tabel - Påkrævet. Den tabel, der skal søges i.
• SearchString – Påkrævet. Den streng, der skal søges efter. Hvis tom eller en tom streng, returneres alle poster.
• Kolonner - Påkrævet. Navnene på de kolonner i Table, der skal søges efter. Hvis SearchStreng bliver fundet i dataene i disse kolonner som et delvist match, bliver hele posten returneret.

Bemærk

I Power Apps før version 3.24042 blev kolonnenavne for funktionen Søg angivet med en tekststreng ved hjælp af dobbelte anførselstegn, og hvis de var knyttet til en datakilde, skulle de også være logiske navne. Det logiske navn "cr43e_name" med dobbelte anførselstegn blev f.eks. brugt i stedet for det viste navn Navn uden anførselstegn. For SharePoint- og Excel-datakilder, der indeholder kolonnenavne med mellemrum, blev hvert mellemrum angivet med "_x0020_", f.eks. "Navn på kolonne" som "Navn_x0020_på_x0020_kolonne". Efter denne version blev alle apps automatisk opdateret til den nye syntaks, der er beskrevet i denne artikel.

Opslag(Tabel*; Formel [;Reduktionsformel] )

• Tabel - Påkrævet. Den tabel, der skal søges i. I brugergrænsefladen vises syntaksen som source over funktionsfeltet.
• Formel - Påkrævet. Den formel, som hver post i tabellen evalueres for. Funktionen returnerer den første post, der giver resultatet sand. Du kan referere til kolonner i tabellen. I brugergrænsefladen vises syntaksen som condition over funktionsfeltet.
• ReductionFormula – valgfrit. Denne formel evalueres for den post, der blev fundet, og den reducerer derefter posten til en enkelt værdi. Du kan referere til kolonner i tabellen. Hvis du ikke bruger denne parameter, returnerer funktionen hele posten fra tabellen. I brugergrænsefladen vises syntaksen som result over funktionsfeltet.

Eksempler

Følgende eksempler bruger IceCream-datakilden:

Formel	Beskrivelse	Resultat
Filter(IceCream, OnOrder > 0)	Returnerer de poster, hvor OnOrder er større end nul.
Filter(IceCream, antal + OnOrder > 225)	Returnerer de poster, hvor summen af kolonnerne Quantity og OnOrder er større end 225.
Filter (IceCream, "chokolade" i lavere (smag))	Returnerer de poster, hvor ordet "chocolate" findes i kolonnen Flavor, og der skelnes ikke mellem store og små bogstaver.
Filter(IceCream, antal < 10 & OnOrder < 20)	Returnerer de poster, hvor Quantity er mindre end 10 og OnOrder er mindre end 20. Der er ingen poster, der opfylder disse kriterier, så der returneres en tom tabel.
Søg (IceCream, "choc", Smag)	Returnerer de poster, hvor strengen "choc" findes i kolonnen Flavor, og der skelnes ikke mellem store og små bogstaver.
Søg(IceCream, "", Smag)	Da søgeudtrykket er tomt, returneres alle poster.
LookUp(IceCream, Smag = "Chokolade", Antal)	Søger efter en post, hvor Flavor er lig med "Chokolade", hvilket kun gælder for én post. For den første post, der findes, returneres Quantity for den post.	100
Opslag(IceCream, antal > 150, antal + på bestilling)	Søger efter en post, hvor Quantity er større end 150, og dem er der flere af. Den første post, der bliver fundet, er "Vanilla", og summen af kolonnerne Quantity og OnOrder returneres.	250
LookUp(IceCream, Flavor = "Pistacie", OnOrder)	Søger efter en post, hvor Flavor er lig med "Pistachio". Dem er der ingen af. Da der ikke blev fundet nogen poster, vil funktionen Lookup returnere blank.	hvid
LookUp(Is, Smag = "Vanilje")	Søger efter en post, hvor Flavor er lig med "Vanilla", hvilket gælder for én post. Da der ikke var angivet en formel til yderligere reduktion, bliver hele posten returneret.	{ Flavor: "Vanilla", Quantity: 200, OnOrder: 75 }

Filtrering med valgkolonner

I følgende eksempel bruges tabellen Konto i Microsoft Dataverse som datakilde. I dette eksempel vises, hvordan du kan filtrere listen over konti baseret på de valgte værdier for et kombinationsfelt:

Trin for trin

1. Åbn en tom app.

2. Tilføj et nyt skærmbillede ved at vælge indstillingen Ny skærm.

3. Vælg Galleri på fanen Indsæt, og vælg derefter Lodret.

4. Åbn fanen Egenskaber i ruden til højre, åbn Datakilde, og vælg derefter Konti.

5. (Valgfrit) Vælg forskellige indstillinger på listen Layout.

6. Vælg Input på fanen Indsæt, og vælg derefter Kombinationsfelt. Gentag trinnet for at tilføje yderligere to kontrolelementer af typen kombinationsfelt.

7. For hvert kontrolelement af typen kombinationsfelt skal du åbne fanen Egenskaber i ruden til højre, åbne Datakilde og derefter vælge Konti. Vælg Rediger ud for indstillingen Felter, og vælg derefter værdierne Primær tekst og SearchField. Primær tekst skal være den kolonne med valgmuligheder, du vil føje til kombinationsfeltet. Gentag trinnet for yderligere to kontrolelementer af typen kombinationsfelt.

   

8. Nu skal du vælge kontrolelementet Gallery og angive egenskaben Items til følgende formel:

   Filter(Accounts,
    'Industry' = ComboBox3.Selected.Industry Or IsBlank(ComboBox3.Selected.Industry),
    'Relationship Type' = ComboBox2.Selected.'Relationship Type' Or
      IsBlank(ComboBox2.Selected.'Relationship Type'),
    'Preferred Method of Contact' = ComboBox1.Selected.'Preferred Method of Contact' Or
      IsBlank(ComboBox1.Selected.'Preferred Method of Contact'))
   

   

Søg efter brugeroplevelse

Følgende eksempler bruger IceCream-datakilden:

I mange apps kan du skrive et eller flere tegn i søgefeltet for at filtrere en liste over poster i et stort datasæt. Når du skriver, vises kun de poster, der opfylder søgekriterierne.

Eksemplerne i resten af denne artikel viser søgeresultaterne for en liste med navnet Customers, som indeholder følgende data:

Hvis du vil oprette denne datakilde som en samling, skal du oprette et Button-kontrolelement og angive dets OnSelect-egenskab til denne formel:

ClearCollect(Kunder, Tabel({ Navn: "Fred Garcia", Firma: "Northwind Traders" }, { Navn: "Cole Miller", Firma: "Contoso" }, { Navn: "Glenda Johnson", Firma: "Contoso" }, { Navn: "Mike Collins", Firma: "Adventure Works" }, { Navn: "Colleen Jones", Firma: "Adventure Works" }) )

Ligesom i dette eksempel kan du få vist en liste over poster i et Gallery-kontrolelement nederst i skærmbilledet. Næsten øverst i skærmbilledet kan du tilføje et Text input-kontrolelement, som hedder SearchInput, så brugerne kan angive, hvilke poster de er interesserede i.

Når brugeren skriver tegn i SearchInput, filtreres resultaterne i galleriet automatisk. I dette tilfælde er galleriet konfigureret til at vise de poster, hvor kundenavnet (ikke navnet på virksomheden) starter med rækkefølgen af de tegn, der angives i SearchInput. Hvis brugeren skriver co i søgefeltet, vises følgende resultater i galleriet:

Hvis du vil filtrere på kolonnen Name, skal du indstille egenskaben Items for gallerikontrolelementet til en af disse formler:

Formel	Beskrivelse	Resultat
Filter(Kunder, StartsWith(Navn, SearchInput.Text) )	Filtrerer Customers-datakilden, så de poster, hvor søgestrengen vises i starten af kolonnen Name, vises. Der skelnes ikke mellem store og små bogstaver i testen. Hvis brugeren skriver co i søgefeltet, vises Colleen Jones og Cole Miller i galleriet. Mike Collins vises ikke i galleriet, da kolonnen Name for den post ikke starter med søgestrengen.
Filter(Kunder, SearchInput.Text i navn)	Filtrerer datakilden Customers, så det er de poster, hvor søgestrengen vises hvor som helst i kolonnen Name, der vises. Der skelnes ikke mellem store og små bogstaver i testen. Hvis brugeren skriver co i søgefeltet, vises Colleen Jones,Cole Miller, og Mike Collins, fordi søgestrengen findes et sted i kolonnen Navn i alle de pågældende poster.
Søg(Kunder, SøgInput.Tekst, Navn)	Funktionen Search søger efter et match hvor som helst i kolonnen Name for hver enkelt post. Det svarer til at bruge operatoren in. Du skal bruge dobbelte anførselstegn rundt om kolonnenavnet.

Du kan udvide søgningen til at omfatte kolonnen Company og kolonnen Name:

Formel	Beskrivelse	Resultat
Filter(Kunder, StartsWith(Navn, SearchInput.Text) || StarterWith(Firma, SøgInput.Tekst) )	Filtrerer datakilden Customers, så de poster, hvor kolonnen Name eller kolonnen Company starter med søgestrengen (f.eks. co), vises. ||-operatoren er sand, hvis en af funktionerne StartsWith er sand.
Filter(Kunder, SearchInput.Text i navn || Søg Input. tekst i virksomhed)	Filtrerer datakilden Customers, så de poster, hvor kolonnen Name eller kolonnen Company indeholder søgestrengen (f.eks. co), vises.
Søg(Kunder, SøgInput.Tekst, Navn, Firma)	Funktionen Search søger i datakilden Customer efter de poster, hvor kolonnen Name eller Company indeholder søgestrengen (f.eks. co), vises. Det svarer til at bruge operatoren in. Funktionen Search er nemmere at læse og skrive end Filter, hvis du vil angive flere kolonner og flere operatorer af typen in.