Napomena
Za pristup ovoj stranici potrebna je autorizacija. Možete se pokušati prijaviti ili promijeniti direktorije.
Za pristup ovoj stranici potrebna je autorizacija. Možete pokušati promijeniti direktorije.
Primjenjuje se na sljedeće: Aplikacije radnog područja
Pokreće web-stranicu ili aplikaciju radnog područja i pruža pristup parametrima pokretanja.
Launch
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 platna parametri se mogu čitati pomoću Param funkcije.
- Cilj (opcionalno), kartica preglednika u kojoj se pokreće web-stranica ili aplikacija radnog područja.
Launch može se koristiti samo u formulama ponašanja.
Napomena
- Launch Ako se formula koristi za otvaranje aplikacije Power Apps, a aplikacija nije vidljiva krajnjem korisniku, preporučuje se da provjerite je li aplikaciju blokirao blokator skočnih prozora preglednika ili je preglednik čekati odgovor korisnika na dijaloški okvir u kojem se pita želi li doći do novog zaslona.
- Samo https: URI-ji su podržani prilikom korištenja u značajci Launch Power Apps Visual u dodatku PowerBI.
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. Može se koristiti i 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
Launch može proslijediti parametre na web-stranicu ili aplikaciju platna. 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 za Launch koje je potrebno dodati će se 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 numeratorne vrijednosti prozoru ili kartici dodijelite naziv pomoću vlastitog tekstnog niza. Samo interni je naziv koji koristi samo Launch funkcija. 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 parametar proslijeđen aplikaciji prilikom pokretanja. Ako imenovani parametar nije proslijeđen, Param vraća polje prazno.
- Prilikom pokretanja aplikacije platna iz druge aplikacije za platno funkciju koristite argumente Launch Parametar. 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
¶metername=parametervaluepod pretpostavkom da je niz upita već pokrenut zatenantId. Na primjer, dodavanje&First%20Name=Vicki&category=3proslijedilo bi dva parametra:First Names vrijednošću"Vicki"icategorys 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. - Param razlikuju velika i mala slova.
- Param nazivi i vrijednosti automatski će biti dekodirani URL-om za korištenje u aplikaciji.
- Vrijednosti parametara ne mijenjaju se ako se aplikacija ponovno ne učita. Korištenje Launch na mobilnom uređaju na kojem je aplikacija već pokrenuta ne osvježava parametre.
- Čak i ako parametar sadrži broj, vrsta koju vraća 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( Adresa [, 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( Adresa, { [ 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( ParameterName )
- ParameterName - Obavezno. Naziv parametra proslijeđenog aplikaciji.
Rezervirani parametri
Sljedeće ključne riječi rezervirane su (bez obzira na slučaj) za internu upotrebu i ne smiju se koristiti kao prilagođeni parametar u Paramfunkciji ( ):
- amp%3Bauthmode
- amp%3Benableonbehalfof
- amp%3Bhidenavbar
- amp%3Blocale
- appmetadataversion
- authmode
- channeltype
- cordovapath
- correlationid
- ispravljanje pogrešaka
- delegatelaunchurl
- delegatelaunchurl
- disablepreviewredirect
- embedderorigin
- enableonbehalfof
- groupid
- hideappsplash
- hidenavbar
- podsjetnik
- hostclienttype
- hostmode
- iframecontainerid
- isfullscreen
- ispreviewmode
- loader
- loaderType
- regionalna shema
- lokacija
- packagekind
- packageproperties
- playerresourcespath
- playersessionid
- powerappslanguage
- screencolor
- sdkversion
- mjesto
- skipappmetadata
- skipiframecreation
- skiplaunchappcache
- ishodište
- Vrijeme izvora
- standaloneconsent
- teamid
- teamtype
- tenantId
- tema
- uselocalpackagehostresources
- userteamrole
Primjeri
Jednostavan 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", broj: 1 } ) |
Isto kao prethodni primjeri, koristeći ekvivalentnu notaciju zapisa. Otvara se novi prozor ili kartica. |
|
Launch( "http://bing.com/search", { q: "Power Apps", broj: 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", broj: 1 }, "Rezultati pretraživanja" ) |
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>
Jednostavan Param
Gore navedeni primjeri jednostavnog pokretanja radi pokretanja aplikacije platna s web-stranice ili iz druge aplikacije za platno prikazuju jednostavne primjere Param za funkciju:
| Formula | Opis | Rezultat |
|---|---|---|
| Param( "Navigacija" ) | Parametar Navigate navodi se pri pokretanju aplikacije i vraća se. | „Drugi zaslon” |
| Param( "Record" ) ("Zapis") | Parametar Record navodi se pri pokretanju aplikacije. Iako je funkciji proslijeđen Launch kao broj, Param rezultat će biti 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 i LaunchParam
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 tablets in news kako biste pokrenuli pretraživanje vijesti s ključnim riječima Microsoft Surface tablets.
Savjet
Za skalabilnost ručno unesene ključne riječi u funkciji možete zamijeniti Launchvarijablama.
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.