Operatorer og id'er i Power Apps

Gælder for: Lærredapps Modelbaserede apps

Nogle af disse operatorer er afhængige af forfatterens sprog. Du kan finde flere oplysninger om understøttelse af sprog i lærredapps under Globale apps.

in- og exactin-operatorer

Brug operatorerne in og exactin til at søge efter strenge i en datakilde, f.eks. i en samling eller i en importeret tabel. Operatoren in identificerer overensstemmelser, uafhængigt af store og små bogstaver, og operatoren exactin identificerer kun overensstemmelser, hvis de benytter små og store bogstaver på samme måde. Her er et eksempel:

1. Opret eller importér en samling, der hedder Inventory, og vis den i galleriet som den første procedure, der er beskrevet i Vise billeder og tekst i et galleri.

2. Angiv egenskaben Items for galleriet til denne formel:
   Filter(Inventory, "E" in ProductName)

   Galleriet viser alle produkter undtagen Callisto, fordi navnet på produktet er det eneste, der ikke indeholder det angivne bogstav.

3. Rediger egenskaben Items for galleriet til denne formel:
   Filter(Inventory, "E" exactin ProductName)

   Galleriet viser kun Europa, da kun dette navn indeholder det bogstav, du har angivet i dette tilfælde.

ThisItem-, ThisRecord- og As-operatorer

Nogle enkelte kontrolelementer og funktioner anvender formler på individuelle poster i en tabel. Du kan henvise til den individuelle post i en formel ved at bruge en af følgende fremgangsmåder:

ThisItem-operator

I følgende Gallery-kontrolelement angives egenskaben Items f.eks. til datakilden Medarbejdere (f.eks. tabellen Medarbejdere, der er inkluderet i eksemplet Northwind Traders):

Employees

Det første element i galleriet er en skabelon, der replikeres for de enkelte medarbejdere. I skabelonen bruger formlen til billedet ThisItem til at referere til det aktuelle element:

ThisItem.Picture

Desuden bruger formlen for navnet også ThisItem:

ThisItem.'First Name' & " " & ThisItem.'Last Name'

ThisRecord-operator

ThisRecord bruges i funktioner, der har et postområde. Vi kan f.eks. bruge Filter-funktionen sammen med galleriets egenskab Items til kun at vise fornavne med M:

Filter( Employees, StartsWith( ThisRecord.Employee.'First Name', "M" ) )

ThisRecord er valgfri og forudsætter at bruge felterne direkte, f.eks. i dette tilfælde kunne vi have skrevet:

Filter( Employees, StartsWith( 'First Name', "M" ) )

Selvom det er valgfrit, kan ThisRecord gøre det nemmere at forstå formler. Det kan være nødvendigt i tvetydige situationer, hvor et feltnavn også kan være et relationsnavn. ThisRecord er valgfrit, mens ThisItem altid er påkrævet.

Brug ThisRecord til at referere til hele posten med Patch, Collect og andre postområdefunktioner. Følgende formel angiver f.eks. statussen for alle inaktive medarbejdere til aktiv:

With( { InactiveEmployees: Filter( Employees, Status = 'Status (Employees)'.Inactive ) },
      ForAll( InactiveEmployees,
              Patch( Employees, ThisRecord, { Status: 'Status (Employees)'.Active } ) ) )

As-operator

Brug As-operatoren til at navngive en post i en galleri- eller postområdefunktion, hvilket tilsidesætter ThisItem eller ThisRecord som standard. Hvis du navngiver posten, kan formlerne blive nemmere at forstå og være nødvendige i indlejrede situationer for at få adgang til poster i andre områder.

Du kan f.eks. redigere egenskaben Items for galleriet til at bruge As for at identificere, at vi har at gøre med en medarbejder:

Employees As Employee

Formlerne til billedet og navnet justeres, så de bruger dette navn til den aktuelle post:

Employee.Picture

Employee.'First Name' & " " & Employee.'Last Name'

As kan også bruges sammen med postområdefunktioner til at erstatte standardnavnet ThisRecord. Vi kan anvende denne på vores tidligere eksempel for at tydeliggøre den post, vi arbejder med:

With( { InactiveEmployees: Filter( Employees, Status = 'Status (Employees)'.Inactive ) },
      ForAll( InactiveEmployees As Employee,
              Patch( Employees, Employee, { Status: 'Status (Employees)'.Active } ) ) )

Når gallerier og postområdefunktioner indlejres, henviser ThisItem og ThisRecord altid til det inderste område, så poster i ydre områder bliver utilgængelige. Brug As til at gøre alle postområder tilgængelige ved at give hvert enkelt et unikt navn.

F.eks. fremstiller denne formel et skakbrætmønster som en tekststreng ved at indlejre to ForAll-funktioner:

Concat(
    ForAll( Sequence(8) As Rank,
        Concat(
            ForAll( Sequence(8) As File,
                    If( Mod(Rank.Value + File.Value, 2) = 1, " X ", " . " )
            ),
            Value
        ) & Char(10)
    ),
    Value
)

Angivelse af et Label-kontrolelements Text-egenskab til denne formel viser:

Lad os udlægge, hvad der sker her:

• Vi starter med at gentage en unavngivet tabel med 8 nummererede poster fra funktionen Sequence. Denne løkke gælder for hver enkelt række på brættet, som almindeligvis kaldes Rangering, så derfor tildeler vi den dette navn.
• I forbindelse med de enkelte rækker gentager vi endnu en unavngivet tabel med 8 kolonner, og tildeler det almindelige navn Fil.
• Hvis Rank.Value + File.Value er et ulige tal, får ifrkanten et X, ellers et punktum. Denne del af formlen bruges til at henvise til begge ForAll-løkker, der er gjort muligt ved hjælp af As-operatoren.
• Concat bruges to gange - først til at samle kolonnerne og derefter rækkerne – med et Char(10) tilføjet for at oprette en ny linje.

Et lignende eksempel er muligt med indlejrede Gallery-kontrolelementer i stedet for ForAll-funktioner. Lad os begynde med det lodrette galleri for Rangering. Dette gallerikontrolelement indeholder følgende Items-formel for:

Sequence(8) as Rank

I dette galleri anbringer vi et vandret galleri for Fil, som replikeres for hver Rangering med en Items-egenskab for:

Sequence(8) as File

I dette galleri tilføjer vi endelig et Label-kontrolelement, der replikeres for hver enkelt Fil og Rangering. Vi tilpasser størrelsen, så den fylder hele pladsen, og bruger egenskaben Fill til at angive farven med denne formel:

If( Mod( Rank.Value + File.Value, 2 ) = 1, Green, Beige )

Selv-operatorer og overordnede operatorer

Der findes tre måder, du kan referere til et kontrolelement og dets egenskaber på i en formel:

Selv og Overordnet er operatorer og ikke egenskaber på selve kontrolelementerne. Referencer til Overordnet.Overordnet, Selv.Overordnet eller Overordnet.selv understøttes ikke.

Id-navne

Navnene på variabler, datakilder, kolonner og andre objekter kan indeholde Unicode.

Brug enkelte anførselstegn omkring et navn, der indeholder et mellemrum eller et andet specialtegn.
Brug to enkelte anførselstegn ved siden af hinanden for at repræsentere et enkelt anførselstegn i navnet. Navne, der ikke indeholder specialtegn, kræver ikke enkelte anførselstegn.

Her er et par eksempler på kolonnenavne, du kan støde på i en tabel, og hvordan de repræsenteres i en formel:

Dobbelte anførselstegn bruges til at angive tekststrenge.

Viste navne og logiske navne

Nogle datakilder som f.eks. SharePoint og Microsoft Dataverse har to forskellige navne til at referere til den samme tabel eller kolonne med data:

• Logisk navn – Et navn, der garanteret er entydigt, ændres ikke, når det er oprettet. Det tillader som regel ikke mellemrum eller andre specialtegn og er ikke oversat til andre sprog. Navnet kan derfor være kryptisk. Disse navne bruges af professionelle udviklere. F.eks. cra3a_customfield. Navnet kan også kaldet et skemanavn eller blot et navn.

• Vist navn – Et navn, der er brugervenligt og bestemt til at blive set af slutbrugerne. Dette navn er muligvis ikke entydigt, det kan ændre sig med tiden, indeholde mellemrum og ethvert Unicode-tegn, og det kan blive oversat til andre sprog. Tilsvarende ovenstående eksempel kan det viste navn være Brugerdefineret felt med mellemrum mellem ordene.

Da de viste navne er nemmere at forstå, foreslår lærredapps dem som valgmuligheder og foreslår ikke logiske navne. Selvom logiske navne ikke foreslås, kan de stadig bruges, hvis de skrives indirekte.

Forestil dig f.eks., at du har føjet et brugerdefineret felt til en tabel i Dataverse. Systemet tildeler dig et logisk navn, som du kun kan ændre, når du opretter feltet. Resultatet vil se nogenlunde sådan ud:

Når du opretter en reference til et område i Konti, foreslås det at bruge 'Brugerdefineret felt', da dette er det viste navn. Enkelte anførselstegn skal bruges, fordi der er mellemrum i dette navn:

Når du har valgt forslaget, vises 'Brugerdefineret felt' på formellinjen, og dataene hentes:

Selvom det ikke er foreslået, kan vi også bruge det logiske navn til dette felt. Det medfører, at de samme data hentes. Der kræves ingen enkelte anførselstegn, da dette navn ikke indeholder mellemrum eller specialtegn:

Bag kulisserne bevares en tilknytning mellem de viste navne, som ses i formlerne, og de underliggende logiske navne. Da logiske navne skal bruges til at kommunikere med datakilden, bruges denne tilknytning til automatisk at konvertere fra det aktuelle viste navn til det logiske navn, og det er det, der ses i netværkstrafikken. Denne tilknytning bruges også til at konvertere tilbage til logiske navne for at skifte til nye viste navne, f.eks. hvis et vist navn ændres eller en udvikler på et andet sprog redigerer appen.

Fjernelse af flertydige udtryk for navne

Da viste navne ikke er entydige, kan det samme viste navn forekomme flere gange i den samme tabel. Når dette sker, tilføjes det logiske navn i parentes i slutningen af det viste navn for et eller flere af de navne, der er i konflikt med hinanden. Hvis vi tager eksemplet ovenfor, og der er et andet felt med det samme viste navn Brugerdefineret felt og det logiske navn cra3a_customfieldalt, vil forslagene være:

Utvetydige navnestrenge tilføjes i andre situationer, hvor der opstår navnekonflikter, f.eks. navnene på tabeller, valgmuligheder og andre Dataverse-elementer.

Fjernelse af flertydige udtryk for operator

Nogle funktioner opretter postområder for at få adgang til felter i tabellen, mens hver post behandles, f.eks. Filter, AddColumns og Sum. De feltnavne, der tilføjes sammen med postområdet, tilsidesætter de samme navne fra andre steder i appen. Når det sker, kan du stadig få adgang til værdier uden for postområdet med operatoren @ til fjernelse af flertydige udtryk:

• Du kan få adgang til værdier fra indlejrede postområder ved at bruge operatoren @ sammen med navnet på den tabel, der arbejdes på, ved hjælp af mønsteret:
  Table[@FieldName]
• Du kan få adgang til globale værdier, som f.eks. datakilder, samlinger og kontekstvariabler, ved at bruge mønsteret [@ObjectName] (uden en tabelangivelse).

Se Postområder for at få flere oplysninger og eksempler.