Operatori i identifikatori platforme Power Apps

Odnosi se na: Aplikacije od gotovih gradivnih elemenata Aplikacije stvorene prema modelu

Neki od tih operatora ovise o jeziku autora. Dodatne informacije o jezičnoj podršci u aplikacijama od gotovih gradivnih elemenata potražite u odjeljku Globalne aplikacije.

u završnim exactin operatorima

Koristite operatore in i exactin za pronalaženje niza u izvoru podataka, kao što je zbirka ili uvezena tablica. Operator in identificira podudaranja bez obzira na slučaj, a operator exactin identificira podudaranja samo ako su ispisani velikim slovima na isti način. Evo primjera:

1. Stvarate ili uvozite zbirku po imenu Zaliha i prikažite je u galeriji kao prvi postupak u opisima Prikaži slike i tekst u galeriji.

2. Postavite svojstvo Items za galeriju na ovu formulu:
   Filter(Inventory, "E" in ProductName)

   Gallery prikazuje sve proizvode osim Callisto jer je naziv tog proizvoda jedini koji ne sadrži slovo koje ste naveli.

3. Promijenite svojstvo Items za galeriju na ovu formulu:
   Filter(Inventory, "E" exactin ProductName)

   Gallery prikazuje samo Europa jer samo njeno ime sadrži slovo koje ste naveli u slučaju koji ste naveli.

Operatori ThisItem, ThisRecord i As

Nekoliko kontrola i funkcija primjenjuje formule na pojedinačne zapise tablice. Za upućivanje na pojedinačni zapis u formuli koristite jedno od sljedećeg:

Operator ThisItem

Primjerice, u sljedećoj kontroli Galerija, svojstvo Stavke postavljeno je na izvor podataka Zaposlenici (kao što je tablica Zaposlenici uključena u uzorak Northwind TRaders):

Employees

Prva stavka u galeriji je predložak koji se ponavlja za svakog zaposlenika. U predlošku, formula za sliku koristi funkciju ThisItem za upućivanje na trenutnu stavku:

ThisItem.Picture

Isto tako, formula za naziv također koristi ThisItem:

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

Operator ThisRecord

ThisRecord se koristi u funkcijama koje imaju djelokrug zapisa. Na primjer, možemo koristiti funkciju Filter sa svojstvom Items naše galerije za prikaz samo imena koja počinju sa slovom M:

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

Operator ThisRecord nije obavezan i podrazumijeva se direktnom upotrebom polja, na primjer, u ovom smo slučaju mogli napisati:

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

Iako nije obavezna, upotreba operatora ThisRecord može olakšati razumijevanje formula i može biti potrebna u nejasnim situacijama kada naziv polja može biti i naziv odnosa. Operator ThisRecord nije obavezan, ali ThisItem uvijek jeste.

Koristite operator ThisRecord za upućivanje na cijeli zapis s funkcijama Patch, Collect i ostalim funkcijama djelokruga zapisa. Na primjer, sljedeća formula postavlja status svih neaktivnih zaposlenika u aktivne:

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

Operator As

Koristite operator As za imenovanje zapisa u galeriji ili funkciji djelokruga zapisa, nadjačavajući zadani operator ThisItem ili ThisRecord. Imenovanje zapisa može vam olakšati razumijevanje formula i može biti potrebno u ugniježđenim situacijama za pristup zapisima u drugom djelokrugu.

Na primjer, možete izmijeniti svojstvo Items naše galerije za upotrebu operatora As kako bismo utvrdili da radimo sa zaposlenikom:

Employees As Employee

Formule za sliku i naziv prilagođene su upotrebi ovog naziva za trenutni zapis:

Employee.Picture

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

Operator As se također može koristiti s funkcijama djelokruga zapisa za zamjenu zadanog naziva ThisRecord. To možemo primijeniti na naš prethodni primjer da bismo pojasnili zapis s kojim radimo:

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

Pri ugnježđivanju galerija i funkcija djelokruga zapisa, operatori ThisItem i ThisRecord uvijek se odnose na unutarnji djelokrug, što zapise u vanjskom djelokrugu ostavlja nedostupnim. Koristite operator As da bi svaki djelokrug postao dostupan tako što ćete mu dati jedinstven naziv.

Na primjer, ova formula stvara uzorak šahovske ploče kao tekstni niz ugnježđivanjem dviju funkcija ForAll:

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
)

Postavljanje svojstva Text kontrole Label prema ovoj formuli prikazat će sljedeće:

Analizirajmo što se ovdje događa:

• Počinjemo iteracijom neimenovane tablice od 8 numeriranih zapisa iz funkcije Sequence. Ova petlja je za svaki red ploče koji se obično naziva Rang i zato mu dajemo ovaj naziv.
• Za svaki red ponavljamo još jednu neimenovanu tablicu od 8 stupaca i dajemo zajednički naziv Datoteka.
• Ako je vrijednost Rank.Value + File.Value neparni broj, kvadrat dobiva X, u suprotnom, točku. Ovaj dio formule odnosi se na obje petlje ForAll, što je omogućeno pomoću operatora As.
• Concat koristi se dvaput, prvo za sastavljanje stupaca, a zatim redaka, uz funkciju Char(10) ubačenu za stvaranje novog retka.

Sličan primjer moguć je s ugniježđenim kontrolama Gallery umjesto funkcijama ForAll. Započnimo s okomitom galerijom za Rang. Ova kontrola galerije imat će formulu Items sačinjenu od:

Sequence(8) as Rank

Unutar ove galerije postavit ćemo vodoravnu galeriju za Datoteku, koja će se replicirati za svaki Rang, sa svojstvom Items sačinjenim od:

Sequence(8) as File

Na kraju ćemo unutar ove galerije dodati kontrolu Label koja će se replicirati za svaku Datoteku i svaki Rang. Podesit ćemo njenu veličinu kako bi ispunila cijeli prostor i upotrijebit ćemo svojstvo Fill za pružanje boje pomoću ove formule:

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

Operatori Self i Parent

Postoje tri načina za upućivanje na kontrolu i njena svojstva u formuli:

Self i Parent su operatori, a ne svojstva na samim kontrolama. Upućivanje na Parent.Parent, Self.Parent ili Parent.Self nije podržano.

Nazivi identifikatora

Nazivi varijabli, izvora podataka, stupaca i drugih objekata mogu sadržavati svaki Unicode standard.

Upotrijebite pojedinačne navodnike oko naziva koji sadrži razmak ili drugi posebni znak.
Upotrijebite dva jednostruka navodnika zajedno kako biste predstavili jedan jednostruki navodnik u nazivu. Nazivima koji ne sadrže posebne znakove ne trebaju jednostruki navodnici.

Evo nekoliko primjera naziva stupaca na koje možete naići u tablici i načina njihova prikazivanja u formuli:

Dvostruki navodnici upotrebljavaju se za određivanje tekstnih nizova.

Prikaz naziva i logičkih naziva

Neki izvori podataka kao što su SharePoint i Microsoft Dataverse imaju dva različita naziva koja se odnose na istu tablicu ili stupac podataka:

• Logički naziv – Naziv za koji se jamči da je jedinstven, ne mijenja se nakon stvaranja, obično ne dopušta razmake ili druge posebne znakove i ne prevodi se na različite jezike. Kao rezultat, naziv može biti zagonetan. Ove nazive upotrebljavaju profesionalni razvojni inženjeri. Na primjer, cra3a_customfield. Ovaj se naziv može također navesti kao naziv sheme ili samo naziv.

• Zaslonski naziv – naziv koji je prilagođen korisniku i vidljiv krajnjim korisnicima. Taj naziv možda nije jedinstven, može se vremenom mijenjati, može sadržavati razmake i svaki Unicode znak, a može biti preveden na različite jezike. U skladu s prethodnim primjerom, zaslonski naziv može biti Prilagođeno polje s razmakom između riječi.

Budući da su zaslonski nazivi lakše razumljivi, aplikacije od gotovih gradivnih elemenata predložit će ih kao odabir, a neće predlagati logička imena. Iako logički nazivi nisu predloženi, i dalje ih se može upotrebljavati ako se upišu neizravno.

Na primjer, zamislite da ste dodali Prilagođeno polje u tablicu na usluzi Dataverse. Logički naziv dodijelit će vam sustav i možete ga mijenjati samo tijekom stvaranja polja. Rezultat bi bio sličan sljedećem:

Tijekom stvaranja reference na polje Računi predložit će se uporaba naziva „Prilagođeno polje”, budući da je to zaslonski naziv. Moraju se koristiti jednostruki navodnici jer ovaj naziv sadrži razmak:

Nakon odabira prijedloga, na traci formule prikazuje se 'Prilagođeno polje' i podatci se preuzimaju:

Iako nije predloženo, mogli bismo za ovo polje upotrijebiti i logički naziv. To će rezultirati preuzimanjem istih podataka. Jednostruki navodnici nisu potrebni jer ovaj naziv ne sadrži razmake ili posebne znakove:

Iza scene održava se mapiranje između zaslonskih naziva koji se vide u formulama i pozadinskih logičkih imena. Budući da se logički nazivi moraju upotrijebiti za interakciju s izvorom podataka, ovo se mapiranje upotrebljava za automatsko pretvaranje trenutačnog zaslonskog naziva u logički naziv i to je ono što se vidi u mrežnom prometu. Ovo se mapiranje koristi i za pretvaranje natrag u logičke nazive za prelazak na nove zaslonske nazive, na primjer, ako se zaslonski naziv promijeni ili autor uredi aplikaciju na drugom jeziku.

Rješavanje nesklada polja

Budući da zaslonski nazivi nisu jedinstveni, isti zaslonski naziv može se prikazati više puta u istoj tablici. Kada se to dogodi, logički naziv dodat će se na kraju zaslonskog naziva unutar zagrada za jedan od više sukobljenih naziva. Vodeći se gornjim primjerom, ako je postojalo drugo polje istog zaslonskog naziva Prilagođeno polje i logičkog imena cra3a_customfieldalt tada bi prijedlozi pokazali:

Nizovi s dvoznačnim nazivima dodaju se u drugim situacijama u kojima dolazi do sukoba imena, poput naziva tablice, odabira i drugih stavki usluge Dataverse.

Operator rješavanja nesklada

Neke funkcije stvaraju opsege zapisa za pristup poljima tablice tijekom obrade svakog zapisa, kao što su Filter, AddColumns i Sum. Nazivi polja dodani s pomoću opsega zapisa zamjenjuju iste nazive svugdje u aplikaciji. Kada se to dogodi, i dalje možete pristupiti vrijednostima izvan opsega zapisa s pomoću operatora za rješavanje nesklada @:

• Za pristup vrijednostima s ugniježđenih opsega zapisa upotrijebite operator @ s nazivom tablice kojom se koristi ovaj uzorak:
  Tablica[@Naziv polja]
• Za pristup globalnim vrijednostima, poput izvora podataka, zbirki i varijabli konteksta, upotrijebite uzorak [@ObjectName] (bez oznake tablice).

Dodatne informacija i primjere potražite u odjeljku Opsezi zapisa.