Funkcije pokretanja i parametra

Članak
10/16/2024

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

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 (obavezno), URL web stranice aplikacije radnog područja.
Parametri (neobavezno), 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 (opcionalno), kartica preglednika u kojoj se pokreće web-stranica ili aplikacija radnog područja.

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

Napomena

Ako se formula Pokreni koristi za otvaranje Power Apps , a aplikacija nije vidljiva krajnjem korisniku, preporučuje se provjeriti blokira li aplikaciju blokator skočnih prozora preglednika ili preglednik čeka odgovor korisnika na dijaloški okvir koji pita želi li se kretati na novi zaslon.

Adresa

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

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

Aplikacije radnog područja možete pokrenuti s web-vezom ili URI-jem aplikacije (ID aplikacije s prefiksom ). /providers/Microsoft.PowerApps/apps/ Da biste pronašli ove vrijednosti za aplikaciju:

Idite na Power Apps.
U lijevom navigacijskom oknu odaberite Aplikacije.
Odaberite aplikaciju.
Na gornjem izborniku odaberite Pojedinosti.
Također, možete odabrati i ... (Dodatne naredbe), a zatim s padajućeg izbornika odabrati Detalji.
Kopiraj web-poveznicu.

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. Na primjer:

Launch( "https://apps.powerapps.com/e/{environment id}/a/{app id}?tenantId={tenantId}" )

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

Pokretanje može proslijediti parametre na web-stranicu ili aplikaciju radnog područja. Parametri se mogu pružiti na dva načina:

Popis argumenata s parovima vrijednosti naziva. Na primjer:

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

Snimak vrijednosti polja. Na primjer:
```
Launch( "https://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.

Prilikom pokretanja aplikacije na mobilnom uređaju na kojem je ta aplikacija već pokrenuta, parametri se neće osvježavati u pokrenutoj aplikaciji. Za osvježavanje parametara potrebno je ponovno učitavanje aplikacije.

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
Nov	Web-stranica ili aplikacija otvara se u novom prozoru ili kartici.
Nadomjestiti	Web-stranica ili aplikacija zamjenjuje trenutačni prozor ili karticu.
ime	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. Ime ne može započeti znakom donje crte "_".

Novo je zadana enumeracija kada se izvodi u web-pregledniku s opcijama Zamijeni i nazovite kao dostupne. 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.

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.
Vrijednosti parametara ne mijenjaju se ako se aplikacija ponovno ne učita. Korištenje značajke Pokreni na mobilnom uređaju na kojem je aplikacija već pokrenuta ne osvježava parametre.
Č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.

Napomena

Za prilagođene stranice jedini parametri koje stranica prihvaća su: recordId i entityName.

Sintaksa

Launch( Address [, ParameterName1; ParameterValue1, ... ] )

Adresa – Obavezno. Adresa web-stranice ili ID aplikacije koju treba pokrenuti.
ParameterNames – Nije obavezno. Naziv parametra.
ParameterValues – Nije obavezno. Odgovarajuće vrijednosti parametara koje treba proslijediti aplikaciji ili web-stranici.

Launch(Address,[ParameterName1: ParameterValue1, ... ] { } [, LaunchTarget ] )

Adresa – Obavezno. Adresa web-stranice ili ID aplikacije koju treba pokrenuti.
ParameterNames – Nije obavezno. Naziv parametra.
ParameterValues – Nije obavezno. Odgovarajuće vrijednosti parametara koje treba proslijediti aplikaciji ili web-stranici.
LaunchTarget – Nije obavezno. LaunchTarget vrijednost enumeracije ili prilagođen naziv.

Param( Naziv parametra)

ParameterName - Obavezno. Naziv parametra proslijeđenog aplikaciji.

Rezervirani parametri

Sljedeće ključne riječi rezervirane su (bez obzira na velika i mala slova) za internu upotrebu i ne bi se trebale koristiti kao prilagođeni parametar u funkciji Param():

amp%3Bauthmode
amp%3Benableonbehalfof
amp%3Bhidenavbar
amp%3Blocale
appmetadataversion
authmode
channeltype
cordovapath
correlationid
debug
delegatelaunchurl
delegatelaunchurl
disablepreviewredirect
embedderorigin
enableonbehalfof
groupid
hideappsplash
hidenavbar
podsjetnik
hostclienttype
hostmode
iframecontainerid
isfullscreen
ispreviewmode
loader
loaderType
regionalna shema
mjesto
packagekind
packageproperties
playerresourcespath
playersessionid
powerappslanguage
screencolor
sdkversion
mjesto
skipappmetadata
skipiframecreation
skiplaunchappcache
izvor
Vrijeme izvora
standaloneconsent
teamid
teamtype
tenantId
tema
uselocalpackagehostresources
userteamrole

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 https://bing.com/search?q=Power%20Apps& broj=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/e/YOUR-APP-ENVIRONMENT-ID/a/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( "Navigacija" )	Parametar Navigate navodi se pri pokretanju aplikacije i vraća se.	„Drugi zaslon”
Param( "Rekord" )	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( "Korisnik" )	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

Idite na Power Apps.
U lijevom navigacijskom oknu odaberite Aplikacije.
Odaberite svoju aplikaciju, a zatim odaberite Uredi.
U izborniku odaberite Umetni, a zatim odaberite Label.
Pomaknite oznaku u donji desni dio zaslona.
U oknu svojstava na desnoj strani, za Color odaberite white i postavite Border thickness na 1.
Odaberite svojstvo Text s desne strane i unesite tekst kao Surface tablets in news.
S popisa svojstava u gornjem lijevom kutu odaberite OnSelect.
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.
Spremite i objavite aplikaciju.
Pokrenite aplikaciju.
Odaberite oznaku Surface tablete u vijestima da biste pokrenuli pretraživanje vijesti s ključnim riječima Microsoft Surface tableti.

Savjet

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

Primjer – Param

Idite na Power Apps.
U lijevom navigacijskom oknu odaberite Aplikacije.
Odaberite svoju aplikaciju, a zatim odaberite Uredi.
U izborniku odaberite Umetni, a zatim odaberite Label.
Pomaknite oznaku u donji desni dio zaslona.
Odaberite svojstvo Text za oznaku u gornjem lijevom kutu.
Unesite formulu kao Param("browser"). Također, možete koristiti neki drugi parametar po svom izboru.
Spremite i objavite aplikaciju.
Kopirajte internetsku vezu za vašu aplikaciju iz Power Apps,
Otvorite novi preglednik.
Zalijepite internetsku vezu aplikacije u preglednik i na kraj dodajte &browser=Microsoft%20Edge.
Kad se vaša aplikacija pokrene, oznaka prikazuje proslijeđenu vrijednost parametra.
Zatvorite reproduktor aplikacije i uredite aplikaciju.
Odaberite Aplikacija u prikazu stabla na lijevoj navigaciji.
Odaberite svojstvo StartScreen u gornjem lijevom kutu.
Unesite formulu kao If( Param("screen") = "techspecs", TechSpecs ).

If funkcija u svojstvu StartScreen provjerava je li parametar jednak određenoj vrijednosti, u ovom slučaju vrijednost techspecs. A ako se podudara, vraća kontrolu zaslona Tehničke specifikacije svojstvu StartScreen .

Napomena

Zamijenite naziv kontrole Tehničke specifikacije u funkciji If nazivom kontrole zaslona u vlastitoj aplikaciji ako ne koristite predložak aplikacije Product Showcase .
Spremite i objavite aplikaciju.
Otvorite novi preglednik.
Zalijepite internetsku vezu aplikacije u preglednik i na kraj dodajte &screen=techspecs.
Aplikacija se izravno pokreće s tehničkim specifikacijama kao početnim zaslonom.