Rakenduse objekt Power Appsis

Kehtib: Lõuendirakendused

Saate teavet parajasti töötava rakenduse kohta ja reguleerida rakenduse käitumist.

Kirjeldus

Sarnaselt juhtelemendiga on rakenduseobjektil atribuudid, mis tuvastavad, milline ekraan kuvatakse, ja palub teil muudatused salvestada, et te neid ei kaotaks. Igal rakendusel on objekt Rakendus.

Kirjutage rakenduseobjekti mõne atribuudi valemid. Paani Puu vaade ülaosas valige objekt Rakendus, nagu teeksite seda iga teise juhtelemendi või ekraaniga. Mõne objekti atribuudi kuvamiseks või redigeerimiseks valige see valemiribast vasakul asuvast ripploendist.

Puuvaate paanil valitud rakenduseobjekti kuvatõmmis. Atribuutide paan on nähtav.

Selles artiklis käsitletakse järgmisi rakenduseobjekti atribuute.

  • ActiveScreen – praegu kuvatav ekraan.
  • BackEnabled – kuidas rakendus reageerib seadme tagasi žestile.
  • ConfirmExit ja ConfirmExitMessage – hoiatavad kasutajat enne rakenduse sulgemist.
  • Ühendusstring – saate häälestada rakenduseülevaadete logimise.
  • Valemid – määratleb nimega valemid, kasutaja määratletud funktsioonid ja kasutaja määratletud tüübid.
  • OnError – töötleb tõrkeid globaalselt.
  • OnStart – käivitage loogika rakenduse käivitamisel.
  • StartScreen – määrake rakenduse laadimisel esimesena kuvatav kuva.
  • StudioVersion – tagastab rakenduse avaldanud Power Apps Studio versiooni.

Atribuut ActiveScreen

Atribuut ActiveScreen tuvastab parajasti kuvatava ekraani.

See atribuut tagastab ekraaniobjekti. Selle abil saate viidata praeguse kuva atribuutidele (nt nimele, mille valem App.ActiveScreen.Name). Samuti saate seda atribuuti võrrelda mõne muu ekraaniobjektiga , näiteks võrdlusvalemiga App.ActiveScreen = Screen2 , et kontrollida, kas Screen2 on praegune ekraan.

Kuvatava kuva vahetamiseks kasutage funktsiooni Tagasi või Navigeeri .

Atribuut BackEnabled

Atribuut BackEnabled muudab seda, kuidas rakendus reageerib seadme tagasiliigutusele (nipsake või kasutage Androidi seadmetes riistvaratagastusnuppu või nipsake iOS-seadmetes vasakult) Power Appsi mobiiliversioonis töötamisel. Kui see on lubatud, liigub seadme tagasiliigutus viimati kuvatud ekraanile, mis sarnaneb valemiga Tagasi . Kui see on keelatud, viib seadme tagasiliigutus kasutaja rakenduseloendisse.

Atribuudid ConfirmExit

Mitte keegi ei taha salvestamata muudatusi kaotada. Kasutage atribuute ConfirmExit ja ConfirmExitMessage , et hoiatada kasutajat enne rakenduse sulgemist.

Märkus.

  • ConfirmExit ei tööta rakendustes, mis on manustatud näiteks Power BI-sse ja SharePointi.
  • ConfirmExit pole kohandatud lehtedel toetatud.
  • Nüüd saavad need atribuudid juhtelementidele viidata ainult esimesel ekraanil, kui viivitusega koormuse eelvaate funktsioon on lubatud (see on vaikimisi uute rakenduste jaoks). Kui viitate muudele kuvadele, ei kuva Power Apps Studio tõrget, kuid avaldatud rakendus ei avane Power Apps Mobile'is ega brauseris. Microsoft tegeleb selle piirangu tühistamisega. Seni lülitage sätete> (jaotises Eelvaade) välja viivitatud koormus.

ConfirmExit

ConfirmExit on kahendatribuut, mis kui tõene on, avab enne rakenduse sulgumist kinnitusdialoogiboksi. Vaikimisi on selle atribuudi väärtuseks väär ja dialoogiboksi ei kuvata.

Kui kasutajal võib rakenduses olla salvestamata muudatusi, saate selle atribuudi abil enne rakendusest väljumist kuvada kinnituse dialoogiboksi. Kasutage valemit, mis kontrollib muutujaid ja juhtelemendi atribuute (nt vormi juhtelemendi Redigeeri vormisalvestamata atribuuti).

Kinnituse dialoogiboks kuvatakse igas olukorras, kus andmed võivad kaotsi läinud olla, näiteks:

  • Käivitage funktsioon Exit .
  • Kui rakendus töötab brauseris, tehke järgmist.
    • Sulgege brauser või brauseri vahekaart, kus rakendus töötab.
    • Valige brauseri nupp Tagasi.
    • Käivitage funktsioon Launch funktsiooniga LaunchTarget of Self.
  • Kui rakendus töötab rakenduses Power Apps Mobile (iOS või Android), tehke järgmist.
    • Nipsake Power Apps Mobile'is mõne muu rakenduse aktiveerimiseks.
    • Valige Androidi seadmes nupp Tagasi.
    • Mõne muu lõuendirakenduse käivitamiseks käivitage funktsioon Launch .

Kinnitusdialoogiboksi täpne ilme võib erinevates seadmetes ja Power Appsi versioonides erineda.

Kinnituse dialoogiboksi ei kuvata Power Apps Studios.

ConfirmExitMessage

Vaikimisi kuvab kinnituse dialoogiboks üldise sõnumi nagu näiteks "Teil võib olla salvestamata muudatusi.” kasutaja keeles.

Kasutage elementi ConfirmExitMessage kinnituse dialoogiboksis kohandatud sõnumi edastamiseks. Kui see atribuut on tühi, kasutatakse vaikeväärtust. Kohandatud sõnumeid kärbitakse vastavalt vajadusele, et need mahuksid kinnitusdialoogiboksi, seega jätke sõnum kõige rohkem paarile reale.

Brauseris saab kinnitusdialoogiboksis kuvada brauseri üldise sõnumi.

Näide

  1. Määrake objekti Rakendus atribuut ConfirmExit järgmisele avaldisele:

    AccountForm.Unsaved Or ContactForm.Unsaved

    Dialoogiboks kuvatakse siis, kui kasutaja muudab andmeid mõlemas vormis ja proovib siis rakendust sulgeda neid muudatusi salvestamata.

    Üldise kinnituse dialoogiboks.

  2. Määrake objekti Rakendus atribuut ConfirmExitMessage järgmisele valemile:

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

    Dialoogiboksis kuvatakse vormikohane teade, kui kasutaja muudab andmeid mõlemas vormis ja proovib seejärel rakenduse sulgeda neid muudatusi salvestamata.

    Vormipõhine kinnituse dialoogiboks.

Ühendusstringi atribuut

Süsteemi loodud rakenduselogide eksportimiseks rakendusülevaadetesse kasutage ühendusestringi atribuuti.

connection string määramiseks tehke järgmist.

  1. Avage rakendus redigeerimiseks Power Apps Studio.
  2. Valige vasakpoolses navigeerimispuu vaates objekt App .
  3. Sisestage atribuutide paanile ühendusstring .

Kui rakendusülevaatesse ei saadeta andmeid, pöörduge oma Power Platformi administraatori poole ja kontrollige, kas rakenduseülevaade on rentniku tasemel keelatud.

Valemite atribuudid

Kasutage atribuuti Valemid korduvkasutatava loogika määratlemiseks kogu rakenduses. Atribuut Formulas (Valemid) toetab kolme koostet.

Nimega valemid

Kasutage atribuudis Valemid nimega valemeid , et määratleda valem, mida saate oma rakenduses korduvalt kasutada.

Valemid Power Apps määravad kontrollomaduste väärtuse. Näiteks selleks, et määrata taustavärv ühtlaselt kogu rakenduses, määrake iga juhtelemendi atribuudi Fill väärtuseks ühine valem:

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

Kui see valem on nii mitmes kohas kuvatud, muutub see tüütuks ja veaks, mis võib vajadusel neid kõiki värskendada. Selle asemel looge onStart-objektis globaalne muutuja, et määrata värv üks kord, ja seejärel kasutage väärtust uuesti kogu rakenduses.

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

Kuigi see meetod on parem, sõltub see ka rakendusest OnStart , mis töötab enne BGColor välja töötamist. BGColoriga võidakse manipuleerida ka rakenduse mõnes nurgas, millest tegija pole teadlik, kellegi teise tehtud muudatusest ja millele võib olla raske jälile saada.

Nimega valemid pakuvad alternatiivi. Nagu tavaliselt kirjutate juhtelemendi-atribuuti = avaldist, saate selle asemel kirjutada nime = avaldise ja seejärel kasutada avaldise asendamiseks nime uuesti kogu rakenduses. Määratlege need valemid atribuudis Valemid :

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

Nimega valemite kasutamise eelised on järgmised:

  • Valemi väärtus on alati saadaval. Pole ajastussõltuvust, pole rakendust OnStart mis peab käivituma esmalt enne väärtuse seadmist, pole aega, mil valemi väärtus on vale. Nimega valemid võivad üksteisele viidata igas järjekorras, kui nad ei loo ringviitet. Neid saab arvutada paralleelselt.
  • Valemi väärtus on alati ajakohane. Valem võib teostada arvutuse, mis sõltub juhtelemendi atribuutidest või andmebaasikirjetest, ja kui need muutuvad, siis valemi väärtus värskendatakse automaatselt. Muutuja puhul ei pea väärtust käsitsi värskendama. Ja valemeid arvutatakse ümber ainult vajadusel.
  • Valemi määratlus on muutumatu. Määratlus Valemites on üks sisestamisallikas ning väärtust ei saa rakenduses mujal muuta. Muutujate korral võib mõni kood ootamatult väärtust muuta, kuid raskesti silutav olukord pole nimega valemite puhul võimalik.
  • Valemi arvutuse saab edasi lükata. Kuna selle väärtus on muutumatu, saab seda alati vajadusel arvutada, mis tähendab, et seda ei pea arvutama enne, kui seda on vaja. Valemiväärtusi, mida ei kasutata enne kui kuvatakse rakendus ekraan2 ei pea arvutama enne kui ekraan2 on nähtav. Selle töö edasilükkamine võib parandada rakenduse laadimisaega. Nimega valemid on deklaratiivsed ja pakuvad süsteemi jaoks võimalusi arvutamise aja optimeerimiseks.
  • Nimega valemid on Exceli kontseptsiooniks. Power Fx kasutab võimalusel Excel-i mõisteid, kuna nii paljud inimesed teavad Excel-it hästi. Nimega valemid on nimega lahtrite ja nimega valemite ekvivalendid Excelis, mida hallatakse nimehalduriga. Need arvutavad automaatselt ümber nagu arvutustabeli lahtrid ja juhtelemendi atribuudid.

Määratlege nimega valemid atribuudis Valemid üksteise järel, igaüks lõpeb semikooloniga. Valemi tüüp tuletatakse valemis olevate elementide tüüpidest ja sellest, kuidas neid koos kasutatakse. Näiteks need nimega valemid võivad tuua kasulikku teavet praeguse kasutaja Dataverse rakenduse kohta:

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' );

Kui UserTitle'i valemit on vaja värskendada, saate selle ühes kohas hõlpsalt värskendada. Kui UserPhone pole rakenduses vaja, siis neid kõnesid Kasutajad tabelisse rakenduses Dataverse ei ole tehtud. Kasutamata valemi määratluse lisamise eest ei karistata.

Teatud nimega valemite piirangud:

  • Nad ei saa rakenduses käitumisfunktsioone kasutada ega muul viisil kõrvalmõjusid põhjustada.
  • Nad ei saa luua ringviidet. Võrrandid a = b; ja b = a; samas rakenduses pole lubatud.

Kasutaja määratletud funktsioonid

Power Fx sisaldab pikka loendit sisseehitatud funktsioonidest, nagu If, Text ja Set. Kasutaja määratletud funktsioonide abil saate kirjutada oma funktsioone, mis võtavad parameetreid ja tagastavad väärtuse, täpselt nagu sisseehitatud funktsioonid. Kasutaja määratletud funktsioonid on nimega valemite laiendus, mis lisab parameetreid ja toetab käitumisvalemeid.

Näiteks võite määratleda nimega valemi, mis tagastab teegist ilukirjandusraamatud.

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" );

Ilma parameetriteta peate iga žanri jaoks määratlema eraldi nimega valemid. Kuid selle asemel seadke oma nimega valem parameetriks.

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

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

Nüüd saate ühe kasutaja määratletud funktsiooni abil helistada LibraryGenre( "Fiction" )LibraryGenre( "Reference" ), või filtreerida muude žanrite järgi.

Süntaks on:

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

  • FunctionName – nõutav. Kasutaja määratletud funktsiooni nimi.
  • ParameterNames – valikuline. Funktsiooniparameetri nimi.
  • ParameterTypes – valikuline. Tüübi nimi, kas valmisandmetüübi nimi, andmeallika nimi või funktsiooniGa Type määratletud tüüp.
  • ReturnType – nõutav. Funktsiooni tagastusväärtuse tüüp.
  • Valem – nõutav. Valem, mis arvutab parameetrite põhjal funktsiooni väärtuse.

Peate tippima iga parameetri ja kasutaja määratletud funktsiooni väljundi. Selles näites määratleb funktsiooni esimese parameetri, mille tüüp on Tekst, SelectedGenre: Text ja SelectedGenre on filtritoimingu kehas kasutatava parameetri nimi. Vt teemat Toetatud tüübinimede andmetüübid . Funktsiooni Type kasutatakse teegi jaoks kokkuvõttetüübi loomiseks, et saaksite funktsioonist tagastada raamatute tabeli.

LibraryType Kirjetüübiks määratakse mitmustabel. Kui soovite funktsioonile edastada ühe raamatu, saate selle tabeli kirjetüübi ekstraktimiseks kasutada funktsiooni RecordOf.

BookType := Type( RecordOf( LibraryType ) );

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

Funktsiooni parameetrite kirjete sobitamine on tihedam kui teistes osades Power Fx. Kirjeväärtuse väljad peavad olema tüübimääratluse õige alamhulk ega tohi sisaldada lisavälju. Näiteks IsGenre( { Title: "My Book", Published: 2001 }, "Fiction" ) annab tulemiks vea.

Kasutaja määratletud funktsioonid ei toeta veel rekursiooni.

Käitumine kasutaja määratletud funktsioonid

Nimega valemid ja enamik kasutaja määratletud funktsioone ei toeta kõrvalmõjudega käitumisfunktsioone (nt Määra või Teata). Üldiselt vältige võimalusel oleku värskendamist. Selle asemel kasutage funktsioonilisi programmeerimismustreid ja laske Power Fx-il valemid vastavalt vajadusele automaatselt ümber arvutada. Kuid on juhtumeid, kus see on vältimatu. Käitumisloogika lisamiseks kasutaja määratletud funktsiooni Pakendamine keha lokkis traksidega:

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

Nüüd saate helistada Spend( 12 ) , et kontrollida, kas teie säästudes on 12, ja kui on, siis debiteerige see 12-ga ja lisage muutujale Kulutatud 12. Selle funktsiooni tagastuse tüüp on Void , kuna see ei tagasta väärtust.

Käitumise kasutaja määratletud funktsiooni süntaks on:

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

  • FunctionName – nõutav. Kasutaja määratletud funktsiooni nimi.
  • ParameterNames – valikuline. Funktsiooniparameetri nimi.
  • ParameterTypes – valikuline. Tüübi nimi, kas sisseehitatud andmetüübi nimi, andmeallika nimi või funktsiooniga Typemääratletud tüüp.
  • ReturnType – nõutav. Funktsiooni tagastusväärtuse tüüp. Kasutage Void-i , kui funktsioon ei tagasta väärtust.
  • Valemid – nõutav. Valem, mis arvutab parameetrite põhjal funktsiooni väärtuse.

Nagu kõigi Power Fx valemite puhul, ei lõpe käivitamine tõrke ilmnemisel. Pärast funktsiooni Error kutsumist takistab funktsioon If muudatuste tekkimist funktsioonis Savings ja Spent. Funktsiooni IfError saab kasutada ka edasise käivitamise vältimiseks pärast viga. Kuigi see tagastab väärtuse Void, võib valem probleemi korral siiski vea tagastada.

Kasutaja määratletud tüübid

Kasutage kasutaja määratletud tüüpide loomiseks nimega valemeid koos funktsiooniga Type . Kasutage := selle asemel = , et määratleda näiteks Book := Type( { Title: Text, Author: Text } ) kasutaja määratletud tüüp. Lisateavet ja näiteid leiate funktsioonist Tüüp .

OnError atribuut

Kasutage funktsiooni OnError , et teha toiminguid, kui rakenduses ilmneb tõrge. See pakub globaalset võimalust kinni püüda tõrkeriba, enne kui see lõppkasutajale kuvatakse. Samuti saate tõrke logimiseks kasutada funktsiooni Trace või kirjutada andmebaasi või veebiteenusesse.

Lõuendirakendustes kontrollitakse iga valemihindamise tulemust vea suhtes. Tõrke ilmnemisel hinnatakse funktsiooni OnError samade ulatusemuutujatega FirstError ja AllErrors, mida rakendus kasutab, kui kogu valem on mähitud funktsiooni IfError.

Kui onError on tühi, kuvatakse tõrke vaikeribal teade FirstError.Message . Valemi Tõrke_korral määratlemine alistab selle käitumise, et tegija saaks tõrketeavitust vastavalt vajadusele töödelda. Tõrke_korral vaikekäitumise taotlemiseks saate tõrke taasalustada funktsiooni Error abil. Kasutage taassündimisviisi, kui soovite mõnda tõrget teistmoodi välja filtreerida või käsitleda, kuid lasta teistel seda teha.

OnError ei saa asendada arvutustes olevat viga nii, nagu seda saab teha IfError . Kui onError on käivitatud, on tõrge juba ilmnenud ja seda töödeldakse juba valemiarvutuste (nt IfError) abil; OnError kontrollib ainult tõrketeavitust.

OnErrori valemeid hinnatakse samaaegselt ja on võimalik, et nende hindamine võib kattuda muude vigade töötlemisega. Kui määrate näiteks globaalse muutuja tõrke_ korral ülaserva ja loete selle hiljem samas valemis ette, võib väärtus olla muutunud. Kasutage Abil funktsiooni et luua valemi jaoks kohaliku nimega väärtuse.

Kuigi Tõrke _ korral töötleb iga tõrget ükshaaval, ei pruugita iga tõrke puhul eraldi vaikeveariba kuvada. Selleks et vältida korraga liiga paljude tõrkeribade kuvamist, ei kuvata sama tõrkeriba uuesti, kui see kuvati hiljuti.

Näide

Mõelge Sildi juhtelemendile ja Liugur juhtelemendile, mis on valemiga kokku seotud.

Label1.Text = 1/Slider1.Value

Silt ja liuguri juhtelement, mis on seotud valemiga Label1.Text = 1/Slider1.Value.

Vaikimisi on liugur kuni 50. Kui nihutate liuguri väärtusele 0, ei kuvata sildil Label1 väärtust ja kuvatakse veariba.

Liuguri juhtimine liikus asendisse 0, mille tulemuseks oli jagamine nullveaga ja veariba.

Vaatame üksikasjalikult, mis juhtub.

  1. Nihutate liuguri vasakule ja atribuut Slider1.Value muutub väärtuseks 0.
  2. Silt1.Tekst teisendab automaatselt ümber. Tekib nullväärtusega jagamine, genereerides tõrke.
  3. Selles valemis ei ole IfError atribuuti. Nullveaga jagamise tagastab valemi hindamine.
  4. Label1.Tekst ei saa selle tõrke korral midagi kuvada, seega kuvab see tühja oleku.
  5. Käivitatakse OnError . Kuna töötlejat pole, kuvatakse standardne veabänner koos veateabega.

Vajaduse korral saate valemiks määrata Label1.Text = IfError( 1/Slider1.Value, 0 ). IfErrori kasutamine tähendab, et tõrkeriba pole. Tõrke väärtust ei saa tõrke_korral muuta, kuna tõrge on juba juhtunud. Tõrke korral juhitakse ainult seda, kuidas tõrkest teatati.

Kui lisate tõrkeohjuri , ei mõjuta see etappe enne 5. juhist, kuid see muudab tõrke teatatud viisi.

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

App.OnErrori valem on seatud jälituse loomiseks.

Selle tõrkeohjuri korral ei kuvata rakenduse kasutajale ühtegi tõrget. Kuid tõrge lisatakse kuvari jälitusteabesse, sh esimese tõrke tõrketeabe allikasse:

Liuguri juhtimine liikus 0-le, mille tulemuseks oli jagamine nullveaga, kuid mitte veariba.

Kui soovite koos jälitusteabega kuvada ka vaikeveariba, taaskäivitage tõrge, kasutades funktsiooni Error pärast trace-kutset , nagu jälitus ei oleks seal.

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

Atribuut OnStart

Märkus.

Atribuudi OnStart kasutamine võib rakenduse laadimisel põhjustada jõudlusprobleeme. Enne loogika lisamist onStart-objektile kaaluge järgmisi alternatiive.

  • Andmete vahemällu salvestamiseks või globaalmuutujate häälestamiseks kasutage võimaluse korral atribuudis Valemidnimetatud valemit.
  • Esimese kuva kuvamiseks kasutage käsu Liigu asemel atribuuti StartScreen.
  • Loogika käivitamiseks kindla ekraani kuvamisel kasutage ekraani atribuuti OnVisible .

Olenevalt teie kontekstist võib atribuut OnStart olla vaikimisi keelatud. Kui te seda ei näe ja peate seda kasutama, kontrollige rakenduse täpsemaid sätteid, et lüliti lubada.

Kui mitteblokeeriv OnStart-reegel on lubatud (vaikesäte), töötab OnStart teiste rakendusereeglitega samal ajal. Selle tulemusena:

  • Kui teised rakendusereeglid neid loevad, ei pruugita onStart-is lähtestatud muutujaid täielikult lähtestada.
  • Ekraan võib renderdada ja muutuda interaktiivseks enne , kui App.OnStart või Screen.OnVisible lõpetab töötamise, eriti kui nende funktsioonide kasutamine võtab kaua aega.

Atribuut OnStart käivitub, kui kasutaja käivitab rakenduse. Selle atribuudi abil saate teha järgmist:

  • Kogumites olevate andmete toomine ja vahemällu salvestamine funktsiooni Collect abil.
  • Funktsiooni Määra kasutades globaalsete muutujate häälestamine.

See valem käivitub enne esimese ekraani kuvamist. Ühtegi ekraani ei laadita, seega ei saa te funktsiooniga UpdateContext konteksti muutujaid määrata. Kuid kontekstimuutujaid saate edastada funktsiooniga Navigate .

Pärast atribuudi OnStart muutmist viige see testimisel kursoriga puuvaate paanil rakenduseobjektile, valige kolmikpunkt (...) ja seejärel valige Käivitaalus. Erinevalt rakenduse esmakordsest laadimisest on olemasolevad kogumid ja muutujad juba määratud. Tühjade kogumitega alustamiseks kasutage funktsiooni Collect (Kogu) asemel funktsiooni ClearCollect (Tühjenda kogumine).

Käivitamisel käivitamise rakenduse üksuse kiirmenüü

Märkus.

  • Funktsiooni Navigate kasutamine atribuudis OnStart on kasutuselt kõrvaldatud. Olemasolevad rakendused töötavad endiselt. Piiratud aja jooksul saate selle lubada rakenduse sätetes (jaotises Kasutuselt kõrvaldatud). Sel viisil navigeerimine võib aga põhjustada rakenduse laadimise viivitusi, kuna see sunnib süsteemi lõpetama käivitamise OnStart enne esimese ekraani kuvamist. Esimese kuvatava kuva määramiseks kasutage selle asemel atribuuti StartScreen .
  • Kasutuselt kõrvaldatud lüliti on välja lülitatud rakenduste jaoks, mis on loodud enne 2021. aasta märtsi, kui lisasite 2021. aasta märtsist kuni praeguseni valiku Liigu olekusse OnStart . Kui redigeerite neid rakendusi Power Apps Studios, kuvatakse tõrketeade. Selle vea kõrvaldamiseks lülitage aegunud lüliti sisse.

Atribuut StartScreen

Atribuut StartScreen määrab, milline ekraan kuvatakse esimesena. Power Apps hindab seda atribuuti üks kord, kui rakendus laadib ja tagastab kuvaobjekti. Vaikimisi on see atribuut tühi ja esimesena kuvatakse stuudiopuu vaate esimene kuva.

StartScreen on andmevoo atribuut, mis ei tohi sisaldada käitumisfunktsioone. Saadaval on kõik andmevoofunktsioonid. Kasutage neid funktsioone ja signaale, et otsustada, milline ekraan esimesena kuvada.

  • Param funktsioon rakenduse käivitamiseks kasutatud parameetrite lugemiseks.
  • Kasutaja funktsioon praeguse kasutaja kohta teabe lugemiseks.
  • LookUp, Filter, CountRows, Max ja muud funktsioonid, mis loevad andmeallikas.
  • API kutsub konnektori kaudu. Veenduge, et kõne tagastatakse kiiresti.
  • Signaalid, nagu Connection, Compass ja Rakendus.

Märkus.

Globaalsed muutujad ja kogumid (sh onStart-objektidel loodud) pole Avakuval saadaval. Nimega valemid on saadaval ja on sageli parem alternatiiv valemite taaskasutamiseks kogu rakenduses.

Kui StartScreen tagastab tõrke, näitab stuudiopuu vaate esimene ekraan, et startScreen pole seatud. Kasutage funktsiooni IfError tõrgete tabamiseks ja tõrkekuvale ümbersuunamiseks.

Pärast stuudio StartScreeni muutmist viige see testimiseks puuvaate paanil rakenduseobjektile, valige kolmikpunkt (...) ja seejärel valige Liigu Avakuvale. Kuva muutub samamoodi nagu rakendus oleks just laaditud.

Avage StartScreen

Näited

Screen9

Screen9 kuvatakse rakenduse käivitamisel esimesena.

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

Kontrollib, kas param "admin-mode" on seatud ja kasutab seda otsustamiseks, kas HomeScreen või AdminScreen kuvab esimesena.

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

Kontrollib, kas osaleja on töötaja, ja suunab ta käivitamisel õigele kuvale.

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

Suunab rakenduse API-päringu põhjal kas ForestScreen või OceanScreen-ni. Kui API nurjub, kasutab ErrorScreen rakendus hoopis seda.

Atribuut StudioVersion

Atribuudi StudioVersion abil saate kuvada või logida rakenduse avaldamiseks kasutatava Power Apps Studio versiooni. See atribuut aitab teil siluda ja kontrollida, kas teie rakendus avaldatakse uuesti Power Apps Studio hiljutise versiooniga.

StudioVersion tagastab teksti. Selle teksti vorming võib aja jooksul muutuda, seega käsitlege seda tervikuna ja ärge ekstraktige üksikuid osi.

  • Last updated on