Funkcije Launch i Param u aplikaciji Power Apps

Pokreće web-stranicu ili aplikaciju radnog područja i pruža pristup parametrima pokretanja.

Pokretanje

Pokreće web-stranicu ili aplikaciju radnog područja. Funkcija podržava sljedeće:

  • Adresa (obvezno), URL web-stranice ili ID aplikacije radnog područja.
  • Parametri (neobvezno), imenovane vrijednosti koje se prosljeđuju web-stranici ili aplikaciji radnog područja. U aplikaciji radnog područja parametri se mogu očitati pomoću funkcije Param.
  • Cilj (neobvezno), kartica preglednika u kojoj se pokreće web-stranica ili aplikacija radnog područja.

Launch se može koristiti samo u formulama ponašanja.

Adresa

Web-stranice pokreću se putem URL adrese. Na primjer:

Launch( "https://bing.com" )

Aplikacije radnog područja možete pokrenuti pomoću web-veze ili ID-a aplikacije. Da biste pronašli ove vrijednosti za aplikaciju:

  1. Idite na Power Apps.

  2. U lijevom navigacijskom oknu odaberite Aplikacije.

  3. Odaberite aplikaciju.

  4. Na gornjem izborniku odaberite Pojedinosti.
    Također, možete odabrati i ... (Dodatne naredbe), a zatim s padajućeg izbornika odabrati Detalji.

    Opcija pojedinosti o aplikaciji.

  5. Kopirajte web-vezu ili ID aplikacije.

    Pojedinosti o aplikaciji s web-vezom i ID-om aplikacije.

Web-veza može se upotrebljavati na bilo kojoj web-stranici i pokrenut će aplikaciju radnog područja. Također se može koristiti s funkcijom Launch.

ID aplikacije može se koristiti s funkcijom Launch, ali mora imati prefiks /providers/Microsoft.PowerApps/apps/. Na primjer:

Launch( "/providers/Microsoft.PowerApps/apps/f342faaf-5f82-4ace-a64b-7c1b01499231" )

Izvorne aplikacije na nekom uređaju ne mogu se izravno pokrenuti. Na nekim platformama mogu postojati neizravne mogućnosti, poput izvorne aplikacije koja instalira prilagođenu shemu URL-a ili se registrira putem web-preglednika kako bi se ponudila neka mogućnost za određene web-stranice.

Parametri

Launch može proslijediti parametre web-stranici ili aplikaciji radnog područja. Parametri se mogu pružiti na dva načina:

  • Popis argumenata s parovima vrijednosti naziva. Na primjer:

    Launch( "http://bing.com/search", "q", "Power Apps", "count", 1 )
    
  • Snimak vrijednosti polja. Na primjer:

    Launch( "http://bing.com/search", { q: "Power Apps", count: 1 } )
    

    S ovim se obrascem može lakše raditi jer povezivanje naziva i vrijednosti postaje jasnije. To je jedini obrazac koji podržava izborni argument LaunchTarget.

Adresa i parametri se kodiraju pomoću URL-a prije nego što ih se proslijedi kako bi se zamijenili određeni nealfanumerički znakovi s % i heksadecimalnim brojem, kao da je za svaki korištena funkcija EncodeUrl.

Prilikom pokretanja neke web-stranice, niz upita parametara može se dodati na kraj URL adrese. Svi dodatni parametri pruženi funkciji Launch bit će dodani na kraj niza upita. Nizovi upita ne rade prilikom pokretanja aplikacije radnog područja.

Cilj

Upotrijebite argument LaunchTarget kako biste odredili ciljni prozor preglednika u kojem će se otvoriti ta web-stranica ili aplikacija. Koristite jednu od sljedećih vrijednosti enumeracije LaunchTarget ili pružite prilagođeni naziv prozora.

LaunchTarget enumeracija Opis
New Web-stranica ili aplikacija otvara se u novom prozoru ili kartici.
Replace Web-stranica ili aplikacija zamjenjuje trenutačni prozor ili karticu.
name Umjesto vrijednosti enumeracije, koristite vlastiti tekstni niz za naziv prozora ili kartice. Self je interni naziv koji koristi samo funkcija Launch. Nema utjecaja niti će odgovarati naslovu prozora koji vide vaši korisnici. Ako prozor ili kartica s danim nazivom već postoji, njegov će se sadržaj zamijeniti. U suprotnom, stvorit će se novi prozor ili kartica. Naziv ne može započeti znakom podcrtavanja „_”.

New je zadana enumeracija kada se pokreće u web-pregledniku sa Replace i name kao dostupnim mogućnostima. U mobilnom uređaju za reprodukciju Novo je zadano za web-stranice s nazivom kao dostupnom mogućnošću; dok će trenutnu aplikaciju od gotovih gradivnih elemenata uvijek zamijeniti druga aplikacija od gotovih gradivnih elemenata

Napomena

  • Korištenje LaunchTarget s bilo kojom vrijednošću osim Novo u ugrađenim scenarijima (na primjer, Power BI ili SharePoint) nije podržano i može rezultirati neočekivanim ponašanjem. U budućnosti se takvo ponašanje može promijeniti ili uzrokovati pogrešku.

Sigurnosne zone

U preglednicima Internet Explorer i klasičnom Microsoft Edge, funkcija Launch otvara web-stranicu ili aplikaciju radnog područja samo ako su njezine sigurnosne postavke iste ili veće nego kod pozivajuće aplikacije.

Na primjer, ako dodate funkciju Launch aplikaciji koja će se pokretati u sigurnosnoj zoni Pouzdana web-mjesta, provjerite je li to web-mjesto ili aplikacija koju želite da funkcija otvori u zoni Pouzdana web-mjesta ili Lokalni intranet (tj. nije na popisu Web-lokacije s ograničenjem). Dodatne informacije: Promjena sigurnosnih i postavki privatnosti za Internet Explorer 11.

Param

Funkcija Param dohvaća neki parametar proslijeđen aplikaciji prilikom njezinog pokretanja. Ako imenovani parametar nije proslijeđen, Param vraća prazno.

  • Kada pokrećete aplikaciju radnog područja iz neke druge aplikacije radnog područja, upotrijebite argumente Parameter funkcije Launch. Nazivi i vrijednosti parametara automatski će se kodirati URL-om.
  • Kada pokrećete neku aplikaciju radnog područja s neke web-stranice, dodajte parametre u niz upita od web-veze aplikacije radnog područja. To obuhvaća dodavanje &parametername=parametervalue pod pretpostavkom da je niz upita već pokrenut za tenantId. Na primjer, dodavanje &First%20Name=Vicki&category=3 proslijedilo bi dva parametra: First Name s vrijednošću "Vicki" i category s vrijednošću "3" (vrsta vrijednosti je tekst). Naziv i vrijednost parametra moraju biti kodirani URL-om ako sadrže razmake ili posebne znakove, slično upotrebi funkcije EncodeURL.
  • U nazivima parametara razlikuju se velika i mala slova.
  • Nazivi i vrijednosti parametara automatski će se dekodirati URL-om za upotrebu u vašoj aplikaciji.
  • Čak i ako parametar sadrži neki broj, vrsta koju vraća funkcija Param uvijek će biti tekstni niz. Pretvaranje u druge vrste automatski će se dogoditi ili će upotrijebiti eksplicitne konverzije poput funkcije Value za eksplicitno pretvaranje u broj.

Sintaksa

Launch( adresa [, naziv parametra 1, vrijednost parametra 1, ... ] )

  • Adresa – Required. Adresa web-stranice ili ID aplikacije koju treba pokrenuti.
  • Naziv(i) paramet(a)ra – Neobvezno. Naziv parametra.
  • ParameterValue(s) – Neobvezno. Odgovarajuće vrijednosti parametara koje treba proslijediti aplikaciji ili web-stranici.

Launch( adresa, { [ naziv parametra 1: vrijednost parametra 1, ... ] } [, LaunchTarget ] )

  • Adresa – Required. Adresa web-stranice ili ID aplikacije koju treba pokrenuti.
  • Naziv(i) paramet(a)ra – Neobvezno. Naziv parametra.
  • ParameterValue(s) – Neobvezno. Odgovarajuće vrijednosti parametara koje treba proslijediti aplikaciji ili web-stranici.
  • LaunchTarget – Neobavezno. LaunchTarget vrijednost enumeracije ili prilagođen naziv.

Param( naziv parametra )

  • Naziv parametra – Required. Naziv parametra proslijeđenog aplikaciji.

Primjeri

Jednostavna upotreba funkcije Launch

Iz aplikacije radnog područja na web-stranicu:

Formula Opis
Launch( "http://bing.com/search", 
"q", "Power Apps", "count", 1 )
Otvara web-stranicu http://bing.com/search?q=Power%20Apps&count=1. Otvara se novi prozor ili kartica.
Launch( "http://bing.com/search", 
{ q: "Power Apps", count: 1 } )
Isto kao prethodni primjeri, koristeći ekvivalentnu notaciju zapisa. Otvara se novi prozor ili kartica.
Launch( "http://bing.com/search", 
{ q: "Power Apps", count: 1 }, 
LaunchTarget.Replace )
Isto kao prethodni primjeri, zamjenjujući trenutačni prozor ili karticu rezultatom ako se izvodi u web-pregledniku.
Launch( "http://bing.com/search", 
{ q: "Power Apps", count: 1 }, 
"Search Results" )
Isto kao u prethodnom primjeru, stvaranje ili zamjena sadržaja prozora ili kartice pod nazivom Search Results.

Iz jedne aplikacije radnog područja u drugu

Ažurirajte ID aplikacije, zaslonsko ime i broj zapisa prema potrebi.

Launch( "/providers/Microsoft.PowerApps/apps/YOUR-APP-ID",
        { Navigate: "Second Screen", Record: 34 }
)

S web-straniceu aplikaciju radnog područja

Ažurirajte ID aplikacije, ID klijenta, zaslonsko ime i broj zapisa prema potrebi.

<html><body>
    <a href="https://apps.powerapps.com/play/YOUR-APP-ID?tenantId=YOUR-TENANT-ID&Navigate=Second%20Screen&Record=34">
        Launch canvas app
    </a>
</body></html>

Jednostavna upotreba funkcije Param

Jednostavni gornji primjeri funkcije Launch za pokretanje aplikacije radnog područja s web-stranice ili iz druge aplikacije radnog područja prikazuju jednostavne primjere funkcije Param:

Formula Opis Rezultat
Param( "Navigate" ) Parametar Navigate navodi se pri pokretanju aplikacije i vraća se. „Drugi zaslon”
Param( "Record" ) Parametar Record navodi se pri pokretanju aplikacije. Čak i ako je proslijeđen u vidu broja funkciji Launch, rezultat funkcije Param bit će neki tekstni niz koji se može implicitno ili eksplicitno pretvoriti u druge vrste. „34”
Param( "User" ) Parametar User nije naveden. Vraća se vrijednost prazno koja se može ispitati funkcijom IsBlank. prazno

Primjeri korak po korak za Launch i Param

Za sljedeće primjere upotrijebljen je predložak izgleda za tablet Predstavljanje proizvoda. Da biste stvorili neku aplikaciju s ovim predloškom, slijedite korake iz članka stvaranje aplikacije i odaberite predložak Predstavljanje proizvoda. Možete koristiti i vlastitu aplikaciju.

Primjer – Launch

  1. Idite na Power Apps.

  2. U lijevom navigacijskom oknu odaberite Aplikacije.

  3. Odaberite svoju aplikaciju, a zatim odaberite Uredi.

  4. U izborniku odaberite Umetni, a zatim odaberite Label.

  5. Pomaknite oznaku u donji desni dio zaslona.

  6. U oknu svojstava na desnoj strani, za Color odaberite white i postavite Border thickness na 1.

  7. Odaberite svojstvo Text s desne strane i unesite tekst kao Surface tablets in news.

  8. S popisa svojstava u gornjem lijevom kutu odaberite OnSelect.

  9. Unesite formulu kao Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). Također, možete koristiti bilo koji drugi URL, parametar i ključne riječi po izboru.

    Primjer za Launch.

  10. Spremite i objavite aplikaciju.

  11. Pokrenite aplikaciju.

  12. Odaberite oznaku Surface tablets in news kako biste pokrenuli pretraživanje vijesti s ključnim riječima Microsoft Surface tablets.

Savjet

Radi skalabilnosti, možete zamijeniti ručno unesene ključne riječi u funkciji Launch varijable.

Primjer – Param

  1. Idite na Power Apps.

  2. U lijevom navigacijskom oknu odaberite Aplikacije.

  3. Odaberite svoju aplikaciju, a zatim odaberite Uredi.

  4. U izborniku odaberite Umetni, a zatim odaberite Label.

  5. Pomaknite oznaku u donji desni dio zaslona.

  6. Odaberite svojstvo Text za oznaku u gornjem lijevom kutu.

  7. Unesite formulu kao Param("browser"). Također, možete koristiti neki drugi parametar po svom izboru.

    Primjer za Param.

  8. Spremite i objavite aplikaciju.

  9. Kopirajte internetsku vezu za vašu aplikaciju iz Power Apps,

  10. Otvorite novi preglednik.

  11. Zalijepite internetsku vezu aplikacije u preglednik i na kraj dodajte &browser=Microsoft%20Edge.

    Web-adresa.

  12. Kad se vaša aplikacija pokrene, oznaka prikazuje proslijeđenu vrijednost parametra.

    Primjer oznake za Param.

  13. Zatvorite reproduktor aplikacije i uredite aplikaciju.

  14. Odaberite Aplikacija u prikazu stabla na lijevoj navigaciji.

  15. Odaberite svojstvo OnStart u gornjem lijevom kutu.

  16. Unesite formulu kao If(Param("screen")="techspecs",Navigate(TechSpecs,Fade)).

    Primjer funkcije Param za navigaciju.

    Ako funkcija u svojstvu OnStart provjerava je li parametar jednak određenoj vrijednosti, u ovom slučaju vrijednosti techspecs. Ako se podudara, aplikacija prelazi na zaslon TechSpecs.

    Napomena

    Zamijenite zaslonsko ime TechSpecs u funkciji Navigate zaslonskim imenom u vašoj aplikaciji ako ne upotrebljavate predložak aplikacije Predstavljanje proizvoda.

  17. Spremite i objavite aplikaciju.

  18. Otvorite novi preglednik.

  19. Zalijepite internetsku vezu aplikacije u preglednik i na kraj dodajte &screen=techspecs.

    Web-adresa zaslona TechSpecs.

  20. Aplikacija se izravno pokreće s TechSpecs ili zaslonom koji ste unijeli u funkciji Navigate.

Pogledajte također

Referenca formule za aplikaciju radnog područja