Objekt aplikacije na platformi Power Apps

Primjenjuje se na sljedeće: Aplikacije radnog područja

Dohvatite informacije o trenutno pokrenutoj aplikaciji i upravljajte ponašanjem aplikacije.

Opis

Kao i kontrola, objekt Aplikacije ima svojstva koja identificiraju zaslon koji se prikazuje i od vas traži da spremite promjene da ih ne biste izgubili. Svaka aplikacija ima objekt Aplikacija.

Zapišite formule za neka svojstva objekta App . Pri vrhu okna Prikaz stabla odaberite objekt Aplikacija kao što biste bilo koju drugu kontrolu ili zaslon. Da biste prikazali ili uredili jedno od svojstava objekta, odaberite ga na padajućem popisu lijevo od trake formule.

U ovom su članku obuhvaćena sljedeća svojstva objekta aplikacije:

• ActiveScreen – zaslon koji je trenutno prikazan.
• BackEnabled – način na koji aplikacija reagira na gestu natrag uređaja.
• ConfirmExit i ConfirmExitMessage – upozorite korisnika prije zatvaranja aplikacije.
• Niz za povezivanje – postavite zapisivanje uvida u aplikacije.
• Formule – definirajte imenovane formule, korisnički definirane funkcije i korisnički definirane vrste.
• OnError – globalno rukuje pogreškama.
• OnStart – pokrenite logiku prilikom pokretanja aplikacije.
• StartScreen – postavite zaslon koji se prikazuje prvi put kada se aplikacija učita.
• StudioVersion - vratite verziju Power Apps Studio koja je objavila aplikaciju.

Svojstvo ActiveScreen

Svojstvo ActiveScreen identificira zaslon koji je trenutno prikazan.

Ovo svojstvo vraća objekt zaslona. Koristi se za referenciranje svojstava trenutnog zaslona, kao što je naziv s formulom App.ActiveScreen.Name. To svojstvo možete usporediti i s drugim zaslonskim objektom, primjerice pomoću formule za usporedbu App.ActiveScreen = Screen2 da biste provjerili je li zaslon2 trenutni zaslon.

Pomoću funkcije Natragili Navigacija promijenite prikazani zaslon.

Svojstvo BackEnabled

Svojstvo BackEnabled mijenja način na koji aplikacija reagira na gestu natrag uređaja (povlačenjem prsta ili korištenjem gumba za vraćanje hardvera na uređajima sa sustavom Android ili prelaskom prsta s lijeve strane na uređajima sa sustavom iOS) prilikom pokretanja u aplikaciji Power Apps mobile. Kada je omogućena, gesta za povratak uređaja vraća se na zaslon koji je zadnji prikazan, što je slično formuli Natrag . Kada je onemogućena, gesta za vraćanje uređaja vodi korisnika na popis aplikacija.

Svojstvo ConfirmExit

Nitko ne želi izgubiti nespremljene promjene. Pomoću svojstava ConfirmExit i ConfirmExitMessage upozorite korisnika prije zatvaranja aplikacije.

Napomena

• ConfirmExit ne funkcionira u aplikacijama ugrađenima u, primjerice, Power BI i SharePoint.
• ConfirmExit nije podržan na prilagođenim stranicama.
• Sada ta svojstva mogu referenciravati kontrole samo na prvom zaslonu ako je omogućena značajka pretpregleda odgođenog učitavanja (što je po zadanom za nove aplikacije). Ako se pozivate na druge zaslone, Power Apps Studio ne prikazuje pogrešku, ali se objavljena aplikacija ne otvara u aplikaciji Power Apps Mobile ni u pregledniku. Microsoft radi na rješavanju tog ograničenja. U međuvremenu isključite odgođeno učitavanje u odjeljkuNadolazeće>značajke postavki (u odjeljku Pretpregled).

ConfirmExit

ConfirmExit je Booleova svojstvo koje, kada je istinito, otvara dijaloški okvir za potvrdu prije zatvaranja aplikacije. Prema zadanim postavkama ovo je svojstvo false i ne pojavljuje se dijaloški okvir.

Kada korisnik u aplikaciji ima nespremljene promjene, pomoću tog svojstva prije izlaska iz aplikacije prikažite dijaloški okvir za potvrdu. Koristite formulu koja provjerava varijable i svojstva kontrole (na primjer, svojstvo Nespremljeni kontrole obrasca ).

Dijaloški okvir za potvrdu prikazuje se u situacijama u kojima se podaci mogu izgubiti, kao što su:

• Pokrenite funkciju Exit .
• Ako se aplikacija pokreće u pregledniku:
  • Zatvorite preglednik ili karticu preglednika na kojoj se aplikacija pokreće.
  • Odaberite gumb natrag u pregledniku.
  • Pokrenite funkciju Launch uz LaunchTarget od Self.
• Ako se aplikacija pokreće u aplikaciji Power Apps Mobile (iOS ili Android):
  • Prijeđite prstom da biste prešli na drugu aplikaciju u aplikaciji Power Apps Mobile.
  • Odaberite gumb natrag na uređaju sa sustavom Android.
  • Pokrenite funkciju Launch da biste pokrenuli neku drugu aplikaciju platna.

Točan izgled dijaloškog okvira za potvrdu može se razlikovati na svim uređajima i u verzijama aplikacija Power Apps.

Dijaloški okvir za potvrdu ne prikazuje se u aplikaciji Power Apps Studio.

ConfirmExitMessage

Prema zadanim postavkama potvrdni dijaloški okvir prikazuje generičku poruku, kao što je „Možda imate nespremljene promjene.” na jeziku korisnika.

Upotrijebite ConfirmExitMessage kako biste osigurali prilagođenu poruku u potvrdnom dijaloškom okviru. Ako je ovo svojstvo prazno, upotrebljava se zadana vrijednost. Prilagođene se poruke prema potrebi skraćuju da bi se stali u dijaloški okvir za potvrdu, pa poruku zadržite na najviše nekoliko redaka.

U pregledniku dijaloški okvir za potvrdu može prikazati generičku poruku iz preglednika.

Primjer

1. Postavite svojstvo ConfirmExit objekta Aplikacija ovom izrazu:

   AccountForm.Unsaved Or ContactForm.Unsaved
   

   Ako korisnik promijeni podatke u bilo kojem obrascu, prikazat će se dijaloški okvir, a zatim pokuša zatvoriti aplikaciju bez spremanja tih promjena.

   

2. Postavite svojstvo ConfirmExitMessage objekta Aplikacija ovom izrazu:

   If( AccountForm.Unsaved,
       "Accounts form has unsaved changes.",
       "Contacts form has unsaved changes."
   )
   

   Dijaloški okvir prikazuje poruku specifičnu za obrazac kada korisnik promijeni podatke u bilo kojem obrascu, a zatim pokuša zatvoriti aplikaciju bez spremanja tih promjena.

   

Svojstvo niza za povezivanje

Svojstvo Niz za povezivanje koristite za izvoz zapisnika aplikacija koje generira sustav u uvide u aplikacije.

Da biste postavili connection string:

1. Otvorite aplikaciju za uređivanje Power Apps Studio.
2. Odaberite objekt Aplikacija u lijevom prikazu navigacijskog stabla.
3. Unesite niz za povezivanje u okno sa svojstvima.

Ako se podaci ne šalju u uvide u aplikacije, obratite se administratoru servisa Power Platform i provjerite jesu li uvidi u aplikacije onemogućeni na razini klijenta.

Svojstvo formule

Pomoću svojstva Formule definirajte logiku koju je moguće ponovno koristiti u aplikaciji. Svojstvo Formulas podržava tri konstruktora:

• Imenovane formule – formuli dodijelite naziv i ponovno koristite vrijednost u cijeloj aplikaciji.
• Korisnički definirane funkcije – imenovane formule koje sadrže parametre i vraćaju vrijednost.
• Korisnički definirane vrste – imenovane vrste koje možete ponovno koristiti u formulama i potpisima funkcija.

Imenovane formule

Pomoću imenovanih formula u svojstvu Formule definirajte formulu koju možete ponovno koristiti u cijeloj aplikaciji.

U Power Apps, formule određuju vrijednost kontrolnih svojstava. Da biste, primjerice, dosljedno postavili boju pozadine u cijeloj aplikaciji, postavite svojstvo Ispuna za svaku kontrolu na zajedničku formulu:

Label1.Fill: ColorValue( Param( "BackgroundColor" ) )
Label2.Fill: ColorValue( Param( "BackgroundColor" ) )
Label3.Fill: ColorValue( Param( "BackgroundColor" ) )

S toliko mjesta na kojima se formula pojavljuje postaje zamorna i postoji mogućnost da ih sve ažurirate ako je potrebna promjena. Umjesto toga, u odjeljku OnStart stvorite globalnu varijablu da biste jednom postavili boju, a zatim ponovno upotrijebite vrijednost u cijeloj aplikaciji:

App.OnStart: Set( BGColor, ColorValue( Param( "BackgroundColor" ) ) )
Label1.Fill: BGColor
Label2.Fill: BGColor
Label3.Fill: BGColor

Iako je ova metoda bolja, ona također ovisi o pokretanju programa OnStart prije nego što se uspostavi vrijednost za BGColor . BGColor se također može manipulirati u nekom kutu aplikacije za koji proizvođač nije svjestan, promjena koju je napravio netko drugi, a kojoj može biti teško ući u trag.

Imenovane formule pružaju alternativu. Baš kao što obično pišete control-property = izraz, umjesto toga možete upisati naziv = izraz, a zatim ponovno koristiti naziv u cijeloj aplikaciji da biste zamijenili izraz. Definirajte ove formule u svojstvu Formule:

App.Formulas: BGColor = ColorValue( Param( "BackgroundColor" ) );
Label1.Fill: BGColor
Label2.Fill: BGColor
Label3.Fill: BGColor

Prednosti korištenja imenovanih formula uključuju:

• Vrijednost formule je uvijek dostupna. Ne postoji vremenska ovisnost, nema programa OnStart koji se mora pokrenuti prvi prije postavljanja vrijednosti, nema vremena u kojem je vrijednost formule netočna. Imenovane formule mogu se odnositi jedna na drugu bilo kojim redoslijedom, sve dok ne stvaraju kružnu referencu. Mogu se računati paralelno.
• Vrijednost formule je uvijek ažurirana. Formula može izvesti izračun koji ovisi o svojstvima kontrole ili zapisima baze podataka, a kako se oni mijenjaju, vrijednost formule se automatski ažurira. Ne morate ručno ažurirati vrijednost kao što to radite s varijablom. A formule ponovno izračunavaju samo kada je to potrebno.
• Definicija formule je nepromjenjiva. Definicija u odjeljku Formule jedini je izvor istine i vrijednost se ne može promijeniti negdje drugdje u aplikaciji. Kod s varijablama može neočekivano promijeniti vrijednost, ali ta situacija s teškom ispravljanje pogrešaka nije moguća s imenovanim formulama.
• Izračun formule može se odgoditi. Budući da je njegova vrijednost nepromjenjiva, uvijek se može izračunati kada je potrebno, što znači da se ne mora izračunavati dok nije potrebna. Vrijednosti formule koje se ne koriste dok se ne prikaže screen2 aplikacije ne moraju se izračunati dok screen2 ne bude vidljiv. Odgoda ovog rada može poboljšati vrijeme učitavanja aplikacije. Imenovane formule su deklarativne i pružaju mogućnosti sustavu da optimizira kako i kada se izračunavaju.
• Imenovane formule koncept su programa Excel. Power Fx upotrebljava koncepte programa Excel gdje je to moguće jer puno ljudi dobro poznaje Excel. Imenovane formule ekvivalent su imenovanih ćelija i imenovanih formula u programu Excel kojima se upravlja pomoću upravitelja naziva. Automatski se preračunavaju kao što to čine ćelije proračunske tablice i svojstva kontrole.

Definirajte imenovane formule jednu za drugom u svojstvu Formule , svaka završava točkom sa zarezom. Vrsta formule zaključuje se iz vrsta elemenata unutar formule i načina na koji se koriste zajedno. Na primjer, ove imenovane formule dohvaćaju korisne informacije o trenutačnom korisniku iz usluge Dataverse:

UserEmail = User().Email;
UserInfo = LookUp( Users, 'Primary Email' = User().Email );
UserTitle = UserInfo.Title;
UserPhone = Switch( UserInfo.'Preferred Phone', 
                    'Preferred Phone (Users)'.'Mobile Phone', UserInfo.'Mobile Phone',
                    UserInfo.'Main Phone' );

Ako je potrebno ažurirati formulu za UserTitle , možete je jednostavno ažurirati na ovom mjestu. Ako UserPhone nije potreban u aplikaciji, tada se ti pozivi tablici Korisnici na usluzi Dataverse ne upućuju. Nema kazne za uključivanje definicije formule koja se ne upotrebljava.

Neka ograničenja imenovanih formula:

• Ne mogu upotrebljavati funkcije ponašanja niti na drugi način uzrokovati nuspojave unutar aplikacije.
• Ne mogu stvoriti kružnu referencu. Nije dozvoljeno imati a = b; i b = a; u istoj aplikaciji.

Korisnički definirane funkcije

Power Fx uključuje dugačak popis ugrađenih funkcija, kao što su Ako, Tekst i Postavi. Pomoću korisnički definiranih funkcija možete napisati vlastite funkcije koje unose parametre i vraćaju vrijednost, baš kao i ugrađene funkcije. Korisnički definirane funkcije zamislite kao proširenje imenovanih formula koje dodaju parametre i podržavaju formule ponašanja.

Na primjer, možete definirati imenovanu formulu koja vraća beletristiku iz biblioteke:

Library = [ { Title: "The Hobbit", Author: "J. R. R. Tolkien", Genre: "Fiction" },
            { Title: "Oxford English Dictionary", Author: "Oxford University", Genre: "Reference" } ];

LibraryFiction = Filter( Library, Genre = "Fiction" );

Bez parametara morate definirati zasebne imenovane formule za svaki žanr. No umjesto toga parametarizirajte imenovanu formulu:

LibraryType := Type( [ { Title: Text, Author: Text, Genre: Text } ] );

LibraryGenre( SelectedGenre: Text ): LibraryType = Filter( Library, Genre = SelectedGenre );

Sada možete nazvati LibraryGenre( "Fiction" ), ili LibraryGenre( "Reference" )filtrirati prema drugim žanrovima pomoću jedne korisnički definirane funkcije.

Sintaksa je:

FunctionName( [ ParameterName1: ParameterType1 [, ParameterName2:ParameterType2 ... ] ] : Formula = ReturnType;

• FunctionName – Obavezno. Naziv korisnički definirane funkcije.
• ParameterNames – Nije obavezno. Naziv parametra funkcije.
• ParameterTypes – Nije obavezno. Naziv vrste, naziv ugrađene vrste podataka, naziv izvora podataka ili vrsta definirana pomoću funkcije Type .
• ReturnType – Obavezno. Vrsta povratne vrijednosti iz funkcije.
• Formula – Obavezno. Formula koja izračunava vrijednost funkcije na temelju parametara.

Morate unijeti svaki parametar i izlaz iz korisnički definirane funkcije. U ovom primjeru SelectedGenre: Text definira prvi parametar SelectedGenre funkcije koji će biti vrste Tekst i naziv parametra koji se koristi u tijelu za operaciju filtriranja. Pogledajte Vrste podataka za podržane nazive vrsta. Funkcija Type koristi se za stvaranje vrste zbrajanja za biblioteku da biste iz funkcije mogli vratiti tablicu knjiga.

Vi definirate LibraryType kao tablicu zapisa u množini. Ako funkciji želite proslijediti jednu knjigu, pomoću funkcije RecordOf možete izdvojiti vrstu zapisa za tu tablicu:

BookType := Type( RecordOf( LibraryType ) );

IsGenre( Book: BookType, SelectedGenre: Text ): Boolean = (Book.Genre = SelectedGenre);

Podudaranje zapisa za parametre funkcije je čvršće nego u drugim dijelovima Power Fx. Polja vrijednosti zapisa moraju biti odgovarajući podskup definicije vrste i ne mogu sadržavati dodatna polja. Na primjer, IsGenre( { Title: "My Book", Published: 2001 }, "Fiction" ) rezultira pogreškom.

Korisnički definirane funkcije još ne podržavaju rekurzije.

Ponašanje korisnički definirane funkcije

Imenovane formule i većina korisnički definiranih funkcija ne podržavaju funkcije ponašanja s nuspojavama, kao što su Postavi ili Obavijesti. Općenito, ako je moguće, izbjegavajte ažuriranje stanja. Umjesto toga, po potrebi se po potrebi po potrebi možete ocijenite funkcionalnim programskim uzorcima i omogućiti dodatku Power Fx da ponovno izračuna formule. No, postoje slučajevi u kojima je to neizbježno. Da biste uključili logiku ponašanja u korisnički definiranu funkciju, Zamatanje tijela u vitičaste zagrade:

Spend( Amount: Number ) : Void = {
    If( Amount > Savings, 
        Error( $"{Amount} is more than available savings" ),
        Set( Savings, Savings - Amount );
        Set( Spent, Spent + Amount) 
    );
}

Sada možete nazvati da Spend( 12 ) biste provjerili imate li 12 u štednoj uštedi, a ako je tako, zapišite je za 12 i dodajte 12 varijabli Utrošeno. Vrsta povrata ove funkcije je Void jer ne vraća vrijednost.

Sintaksa funkcije ponašanja koju je definirao korisnik je:

FunctionName( [ ParameterName1: ParameterType1 [, ParameterName2:ParameterType2 ... ] ] : ReturnType = { Formula1 [ ; Formula2 ... ] };

• FunctionName – Obavezno. Naziv korisnički definirane funkcije.
• ParameterNames – Nije obavezno. Naziv parametra funkcije.
• ParameterTypes – Nije obavezno. Naziv vrste, ugrađeni naziv vrste podataka, naziv izvora podataka ili vrsta definirana funkcijom Vrsta.
• ReturnType – Obavezno. Vrsta povratne vrijednosti iz funkcije. Koristite Void ako funkcija ne vraća vrijednost.
• Formule – Obavezno. Formula koja izračunava vrijednost funkcije na temelju parametara.

Kao i kod svih Power Fx formula, izvršavanje ne završava kada se naiđe na pogrešku. Nakon pozivanja funkcije Pogreška funkcija If sprječava pojavu promjena u odjeljkuUšteda i Utrošeno. Funkcija IfError također se može koristiti za sprječavanje daljnjeg izvršavanja nakon pogreške. Iako vraća Void, formula i dalje može vratiti pogrešku ako postoji problem.

Korisnički definirane vrste

Koristite imenovane formule s funkcijom Type da biste stvorili korisnički definirane vrste. Koristite := umjesto za = definiranje korisnički definirane vrste, na primjer Book := Type( { Title: Text, Author: Text } ). Pogledajte funkciju Type za više informacija i primjere.

Svojstvo OnError

Upotrijebite OnError za poduzimanje radnji kada se pogreška dogodi bilo gdje u aplikaciji. Pruža globalnu priliku presresti natpis pogreške prije nego što se prikazuje krajnjem korisniku. Možete ga koristiti i za zapisivanje pogreške pomoću funkcije Trace ili zapisivanje u bazu podataka ili web-uslugu.

U aplikacijama radnog područja rezultat svake procjene formule provjerava se na pogrešku. Ako se dogodi pogreška, OnError se procjenjuje s istim varijablama opsega FirstError i AllErrors koje aplikacija koristi ako je cijela formula omotana u funkciju IfError.

Ako je OnError prazan, zadani natpis pogreške prikazuje firstError.Message pogreške. Definiranjem formule OnError nadjačava se to ponašanje, pa se proizvođač može po potrebi nositi s izvješćivanjem o pogreškama. Zadano ponašanje u programu OnError možete zatražiti ponovnim stvaranjem pogreške pomoću funkcije Pogreška. Pristup ponovnog dodavanja koristite ako želite filtrirati ili drugačije rukovati nekim pogreškama, no drugima omogućite da prodju.

OnError ne može zamijeniti pogrešku u izračunima na način na koji to može IfError . Ako se pozove OnError , pogreška se već dogodila i već se obrađuje u izračunima formula kao što je IfError; OnError kontrolira samo izvješćivanje o pogreškama.

Formule onError računaju se istovremeno i moguće je da se njihova procjena može preklapati s obradom drugih pogrešaka. Ako, primjerice, globalnu varijablu postavite pri vrhu pogreške OnError i kasnije je pročitate u istoj formuli, vrijednost se možda promijenila. Upotrijebite funkciju With za stvaranje imenovane vrijednosti koja je lokalna za formulu.

Iako OnError svaku pogrešku obrađuje pojedinačno, zadani natpis o pogrešci možda se neće pojedinačno pojavljivati za svaku pogrešku. Da se ne bi istovremeno prikazilo previše natpisa o pogreškama, isti natpis o pogrešci neće se ponovno prikazati ako je nedavno prikazan.

Primjer

Uzmite u obzir kontrolu Oznaka i kontrolu Klizač koje su povezane formulom:

Label1.Text = 1/Slider1.Value

Klizač se prema zadanim postavkama vraća na 50. Ako klizač pomaknete na 0, natpis1 ne prikazuje nikakvu vrijednost i prikazuje se natpis o pogrešci:

Pogledajmo što se događa s detaljima:

1. Klizač premjestite ulijevo, a svojstvo Slider1.Value promijenit će se u 0.
2. Label1.Tekst se automatski ponovno provjerava. Dolazi do dijeljenja s nulom, generirajući pogrešku.
3. Ne postoji IfError u ovoj formuli. Pogreška dijeljenja s nulom vraća se procjenom formule.
4. Oznaka1.Tekst ne može prikazati ništa za ovu pogrešku, pa prikazuje prazno stanje.
5. Poziva se OnError . Budući da nema obrađivača, prikazuje se standardni natpis pogreške s informacijama o pogrešci.

Ako je potrebno, formulu možete promijeniti i u Label1.Text = IfError( 1/Slider1.Value, 0 ). Ako koristite IfError , znači da nema natpisa pogreške ili pogreške. Vrijednost pogreške ne možete promijeniti iz pogreške OnError jer se pogreška već dogodila – OnError određuje samo način na koji se prijavljuje.

Ako dodate rukovatelj onError , on ne utječe na korake prije petog koraka, ali se mijenja način na koji se prijavljuje pogreška:

Trace( $"Error {FirstError.Message} in {FirstError.Source}" )

Uz ovaj rukovatelj onError , korisniku aplikacije ne prikazuje se pogreška. No pogreška se dodaje u praćenje monitora, uključujući izvor informacija o pogrešci iz firstError:

Ako želite prikazati i zadani natpis o pogrešci zajedno s praćenjem, ponovno stvorite pogrešku pomoću funkcije Pogreška nakon poziva praćenja, kao da trace nije bio ondje:

Trace( $"Error {FirstError.Message} in {FirstError.Source}" );
Error( FirstError )

Svojstvo OnStart

Napomena

Korištenje svojstva OnStart može uzrokovati probleme s performansama prilikom učitavanja aplikacije. Razmislite o ovim alternativama prije dodavanja logike u OnStart:

• Za predmemoriranje podataka ili postavljanje globalnih varijabli koristite imenovanu formulu u svojstvu Formule gdje je to moguće.
• Da biste postavili prikaz prvog zaslona, upotrijebite svojstvo StartScreen umjesto Navigacija.
• Da biste pokrenuli logiku kada se prikazuje određeni zaslon, koristite svojstvo OnVisible na zaslonu .

Ovisno o kontekstu, svojstvo OnStart možda je po zadanom onemogućeno. Ako je ne vidite i morate je koristiti, u naprednim postavkama aplikacije potražite prekidač da biste je omogućili.

Kada je omogućeno pravilo OnStart koje se deblokira (zadano), OnStart se pokreće istovremeno s drugim pravilima aplikacije. Kao rezultat:

• Varijable inicijalizirane u sustavu OnStart možda se neće u potpunosti inicijalizirati kada ih druga pravila aplikacije pročitaju.
• Zaslon može renderirati i postati interaktivan prije nego što App.OnStart ili Screen.OnVisible završi s radom, osobito ako te funkcije dugo trajati.

Svojstvo OnStart izvodi se kada korisnik pokrene aplikaciju. Koristite ovo svojstvo za:

• Dohvaćanje i predmemoriranje podataka u zbirkama pomoću funkcije Collect .
• Postavljanje globalnih varijabli s pomoću funkcije Set.

Ta se formula pokreće prije nego što se prikaže prvi zaslon. Nije učitan nijedan zaslon pa ne možete postaviti varijable konteksta s pomoću funkcije UpdateContext. No pomoću funkcije Navigacija možete proslijediti kontekstne varijable .

Kada promijenite svojstvo OnStart, testirajte ga tako da pokazivač miša postavite iznad objekta aplikacije u oknu prikaza stabla, odaberete trotočje (...), a zatim pokreni OnStart. Za razliku od prvog učitavanja aplikacije, postojeće zbirke i varijable već su postavljene. Kako biste započeli s praznim zbirkama, upotrijebite funkciju ClearCollect umjesto funkcije Collect.

Napomena

• Korištenje funkcije Navigate u svojstvu OnStart je povučeno iz upotrebe. Postojeće aplikacije i dalje funkcioniraju. Ograničeno vrijeme možete omogućiti u postavkama aplikacije (u odjeljku Povučeno iz upotrebe). No korištenje navigacije na taj način može uzrokovati kašnjenja učitavanja aplikacije jer sustav mora završiti s pokretanjem značajke OnStart prije prikazivanja prvog zaslona. Umjesto toga koristite svojstvo StartScreen da biste postavili prvi prikazani zaslon.
• Povučeni je prekidač isključen za aplikacije stvorene prije ožujka 2021. gdje ste dodali mogućnost Idi na početak rada između ožujka 2021. i sada. Prilikom uređivanja tih aplikacija u programu Power Apps Studio prikazuje se pogreška. Uključite povučeni prekidač da biste uklonili ovu pogrešku.

Svojstvo StartScreen

Svojstvo StartScreen postavlja koji će se zaslon najprije prikazati. Power Apps to svojstvo procjenjuje jednom kada se aplikacija učita i vrati zaslonski objekt za prikaz. Po zadanom je to svojstvo prazno, a prvi zaslon u prikazu stabla studio prikazuje se prvi.

StartScreen je svojstvo protoka podataka koje ne može sadržavati funkcije ponašanja. Dostupne su sve funkcije tijeka podataka. Koristite ove funkcije i signale da biste odlučili koji će se zaslon najprije prikazivati:

• Param funkcija za čitanje parametara koji se koriste za pokretanje aplikacije.
• Korisnička funkcija za čitanje informacija o trenutnom korisniku.
• LookUp, Filter, CountRows, Max i druge funkcije koje čitaju iz izvora podataka.
• API pozivi putem poveznika. Provjerite vraća li se poziv brzo.
• Signali kao što su Connection, Compass i App.

Napomena

Globalne varijable i zbirke, uključujući one stvorene u izborniku OnStart, nisu dostupne na početnom zaslonu. Imenovane formule dostupne su i često su bolja alternativa za ponovnu upotrebu formule u cijeloj aplikaciji.

Ako StartScreen vrati pogrešku, prvi zaslon u prikazu stabla studio prikazuje se kao da StartScreen nije postavljen. Funkciju IfError koristite za hvatanje pogrešaka i preusmjeravanje na zaslon pogreške.

Kada promijenite StartScreen u programu Studio, testirajte ga tako da pokazivač miša postavite iznad objekta aplikacije u oknu prikaza stabla, odaberete trotočje (...), a zatim stavku Idi na StartScreen. Zaslon se mijenja kao da je aplikacija upravo učitana.

Primjeri

Screen9

Screen9 prikazuje se prvi put kada se aplikacija pokrene.

If( Param( "admin-mode" ) = 1, HomeScreen, AdminScreen )

Provjerava je li parametar Param "admin-mode" postavljen i pomoću njega odlučuje prikazuje li se najprije HomeScreen ili AdminScreen.

If( LookUp( Attendees, User = User().Email ).Staff, StaffPortal, HomeScreen )

Provjerava je li sudionik član osoblja i usmjerava ga na ispravan zaslon prilikom pokretanja.

IfError( If( CustomConnector.APICall() = "Forest", 
             ForestScreen, 
             OceanScreen 
         ), 
         ErrorScreen 
)

Usmjerava aplikaciju na temelju API poziva na ForestScreen ili OceanScreen. Ako API ne uspije, aplikacija umjesto ErrorScreen toga koristi.

Svojstvo StudioVersion

Pomoću svojstva StudioVersion prikažite ili zapišite verziju programa Power Apps Studio koja se koristi za objavljivanje aplikacije. To svojstvo pomaže prilikom ispravljanja pogrešaka i provjere je li aplikacija ponovno objavljena pomoću nedavne verzije aplikacije Power Apps Studio.

StudioVersion vraća tekst. Oblik ovog teksta može se promijeniti s vremenom, pa ga tretirajte kao cjelinu i ne izdvajajte pojedinačne dijelove.