Launch i Param funkcije

Članak
10/16/2024

Odnosi se na: Canvas aplikacije

Pokreće veb-stranicu ili aplikaciju sa podlogom i pruža pristup parametrima za pokretanje.

Pokretanje

Pokreće veb-stranicu ili aplikaciju sa podlogom. Funkcija podržava:

Adresa (obavezno), URL veb stranice aplikacije platna.
Parametri (opciono), nazvane vrednosti koje će proći na veb stranicu ili aplikaciju platna. U aplikaciji sa podlogom, parametri se mogu očitati pomoću funkcije Param.
Target (opciono), kartica pretraživača u kojoj se pokrene veb stranica ili aplikacija platna.

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

Belešku

Ako se formula za pokretanje koristi za otvaranje Power Apps , a aplikacija nije vidljiva krajnjem korisniku, preporučuje se da proverite da li je aplikacija blokirana od strane blokatora iskačućih prozora pretraživača ili ako pretraživač čeka odgovor korisnika na dijaloški okvir koji pita da li žele da se kreću na novi ekran.

Adresu

Veb-stranice se pokreću putem URL adrese. Na primer:

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

Možete pokrenuti aplikacije platna sa Veb linkom ili App URI (ID aplikacije sa prefiksom sa /providers/Microsoft.PowerApps/apps/). Da biste pronašli ove vrednosti za aplikaciju:

Idi na Power Apps.
Izaberite Aplikacije u levom oknu za navigaciju.
Izaberite aplikaciju.
Izaberite Detalji iz gornjeg menija.
Takođe možete da izaberete ... (Još komandi), a zatim izaberite Detalji u padajućem meniju.
Kopiraj veb vezu.

Veb-veza se može koristiti na bilo kojoj veb-stranici i pokrenuće aplikaciju sa podlogom. Takođe se može koristiti sa funkcijom Launch. Na primer:

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

Matične aplikacije na uređaju ne mogu se direktno pokrenuti. Na nekim platformama mogu biti indirektne opcije, poput matične aplikacije koja instalira prilagođenu URL šemu, ili se registruju pomoću veb-pregledača kako bi se ponudila opcija za određene veb-lokacije.

Parametri

Pokretanje može da prenese parametre na veb stranicu ili aplikaciju platna. Parametri se mogu kreirati na dva načina:

Lista argumenata parova vrednosti imena. Na primer:

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

Zapis vrednosti polja. Na primer:
```
Launch( "https://bing.com/search", { q: "Power Apps", count: 1 } )
```
Ovaj obrazac može biti lakši za rad, jer čini povezivanje između imena i vrednosti jasnijim. To je jedini oblik koji podržava opcionalni argument LaunchTarget.

Adresa i parametri se kodiraju pre nego što se proslede kako bi se zamenili određeni nealfanumerički znakovi sa % i heksadecimalnim brojem, kao da je na svakom od njih korišćena funkcija EncodeUrl.

Prilikom pokretanja veb-stranice, niska upita sa parametrima može biti uključeni na kraju URL adrese. Bilo koji dodatni parametri u funkciji Launch biće dodati na kraju niske upita. Niske upita ne rade prilikom pokretanja aplikacije sa podlogom.

Prilikom pokretanja aplikacije na mobilnom uređaju na kojem je ta aplikacija već pokrenuta, parametri neće biti osveženi u pokrenutoj aplikaciji. Potrebno je ponovno učitavanje aplikacije da bi se parametri osvežili.

Cilj

Koristite argument LaunchTarget da biste odredili prozor ciljanog pregledača u kojem treba da otvorite veb-stranicu ili aplikaciju. Koristite jednu od sledećih numeričkih vrednost LaunchTarget ili navedite naziv prilagođenog prozora.

Numerički parametar LaunchTarget	Opis
Novi	Veb-stranica ili aplikacija otvara se u novom prozoru ili na novoj kartici.
Zameni	Veb-stranica ili aplikacija menja trenutni prozor ili karticu.
Ime	Umesto numeričke vrednosti, koristite svoj tekstualni niz za naziv prozora ili kartice. Self je samo interno ime koje koristi samo funkcija Launch. Ona ne utiče niti će se podudarati sa naslovom prozora koji vaši korisnici vide. Ako prozor ili kartica sa datim imenom već postoji, njihov sadržaj će biti zamenjen. U suprotnom, kreiraće se novi prozor ili kartica. ime ne može da počne sa znakom podvlake "_".

Novo je podrazumevano nabrajanje kada se radi u veb pretraživaču sa Zameni i ime kao dostupne opcije. U plejeru za mobilne uređaje,Novo je podrazumevano za veb-stranice sa jedinom dostupnom opcijom naziv; dok će trenutnu aplikaciju sa podlogom uvek zameniti druga aplikacija sa podlogom.

Belešku

Korišćenje funkcije LaunchTarget sa bilo kojom vrednošću osim Novo u ugrađenim scenarijima (na primer, Power BI ili SharePoint) nije podržano i može dovesti do neočekivanog ponašanja. U budućnosti se takvo ponašanje može promeniti ili uzrokovati grešku.

Param

Funkcija Param preuzima parametar koji je prosleđen aplikaciji prilikom pokretanja. Ako imenovani parametar nije prosleđen, Param vraća prazno.

Kada pokrećete aplikaciju sa podlogom iz druge aplikacije sa podlogom, koristite argumente Parametar u funkciji Launch. Nazivi i vrednosti parametara automatski će se kodirati putem URL adrese.
Kada pokrećete aplikaciju sa podlogom sa veb-stranice, dodajte parametre u nisku upita u veb-vezu aplikacije sa podlogom. Ovo uključuje dodavanje &parametername=parametervalue, pod pretpostavkom da je niska upita već pokrenuta za tenantId. Na primer, dodavanjem &First%20Name=Vicki&category=3 prošla bi dva parametra: First Name sa vrednosti od "Vicki" i category sa vrednosti od "3" (tip vrednosti je tekst). Naziv i vrednost parametra moraju biti kodirani URL ako sadrže razmake ili posebne znakove, slično upotrebi funkcije EncodeURL.
Param imena razlikuju velika i mala slova.
Param imena i vrednosti automatski se dekodiraju za upotrebu u vašoj aplikaciji.
Vrednosti parametara se ne menjaju ukoliko se aplikacija ponovo ne učita. Korišćenje pokretanja na mobilnom uređaju na kojem je aplikacija već pokrenuta ne osvežava parametre.
Čak i ako parametar sadrži broj, tip koji vraća Param uvek će biti tekstualna niska. Konverzija u druge vrste će se automatski dogoditi ili koristiti eksplicitne konverzije, kao što je funkcija Value za eksplicitno pretvaranje u broj.

Belešku

Za prilagođene stranice, jedini parametri koje stranica prihvata su: recordId i entityName.

Sintaksa

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

Adresa – Obavezno. Adresa veb-stranice ili ID aplikacije za pokretanje.
ParameterNames – Opciono. Naziv parametra.
ParameterValues – Opciono. Odgovarajuće vrednosti parametara koje treba preneti na aplikaciju ili veb-stranicu.

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

Adresa – Obavezno. Adresa veb-stranice ili ID aplikacije za pokretanje.
ParameterNames – Opciono. Naziv parametra.
ParameterValues – Opciono. Odgovarajuće vrednosti parametara koje treba preneti na aplikaciju ili veb-stranicu.
LaunchTarget – Opciono. Numerička vrednost LaunchTarget ili običaj ime.

Param( ParameterName )

ParameterName - Obavezno. Naziv parametra je prešao na aplikaciju.

Rezervisani parametri

Sledeće ključne reči su rezervisane (bez obzira na veličinu slova) za internu upotrebu i ne bi trebalo da se koriste 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
hint
hostclienttype
hostmode
iframecontainerid
isfullscreen
ispreviewmode
loader
loaderType
lokalni standard
lokacija
packagekind
packageproperties
playerresourcespath
playersessionid
powerappslanguage
screencolor
sdkversion
lokacija
skipappmetadata
skipiframecreation
skiplaunchappcache
izvor
Izvorno vreme
standaloneconsent
teamid
teamtype
tenantId
tema
uselocalpackagehostresources
userteamrole

Primeri

Jednostavno pokretanje

Kreiranje aplikacije sa podlogom, do veb-stranice:

Formula	Opis
Launch( "http://bing.com/search", "q", "Power Apps", "count", 1 )	Otvara veb stranicu https://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 u prethodnim primerima koristeći ekvivalentnu notu zapisa. Otvara se novi prozor ili kartica.
Launch( "http://bing.com/search", { q: "Power Apps", count: 1 }, LaunchTarget.Replace )	Isto kao u prethodnim primerima, zamenićemo trenutni prozor ili karticu rezultatom ako se pokreće u veb-pregledaču.
Launch( "http://bing.com/search", { q: "Power Apps", count: 1 }, "Rezultati pretrage" )	Isto kao u prethodnom primeru, kreiranje ili zamena sadržaja prozora ili kartice pod nazivom Rezultati pretrage.

Kreiranje aplikacije sa podlogom

Ažurirajte ID aplikacije, ime ekrana i broj zapisa po potrebi.

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

Kreiranje veb-stranice do aplikacije sa podlogom

Ažurirajte ID aplikacije, ID zakupca, ime ekrana i broj zapisa po 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>

Jednostavni Param

Jednostavni primeri iznad za pokretanje aplikacije sa podlogom sa veb-stranice ili iz druge aplikacije sa podlogom pokazuju jednostavne primere za funkciju Param:

Formula	Opis	Rezultat
Param( "Navigate" )	Parametar Navigate je dat kada je aplikacija pokrenuta i vraća se.	"Drugi ekran"
Param( "Rekord" )	Parametar Record je dat kada je aplikacija pokrenuta. Iako je ovaj broj prosleđen kao broj u funkciju Launch, rezultat iz funkcije Param će biti tekstualna niska koja se može implicitno ili eksplicitno pretvoriti u druge tipove.	"34"
param( "korisnik")	Parametar User nije naveden. Vraća se vrednost prazno koja se može testirati sa funkcijom IsBlank.	Prazno

Detaljni primeri za funkcije Launch i Param

Predložak rasporeda tableta Izlog proizvoda korišćen je za sledeće primere. Da biste kreirali aplikaciju sa ovim predloškom, sledite korake iz članka kreiranje aplikacije i izaberite predložak Izlog proizvoda. Takođe možete da koristite sopstvenu aplikaciju.

Primer – Launch

Idi na Power Apps.
Izaberite Aplikacije u levom oknu za navigaciju.
Izaberite aplikaciju, a zatim izaberite Uredi.
Izaberite Umetni u meniju, a zatim izaberite Oznaka.
Premestite oznaku dole desno na ekranu.
U oknu sa svojstvima na desnoj strani, izaberite Boja kao bela i podesite Debljina ivice kao 1.
Izaberite svojstvo Text s desne strane i unesite tekst kao Surface tableti u vestima.
Na listi svojstva u gornjem levom uglu, izaberite OnSelect.
Unesite formulu kao Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). Možete koristiti i bilo koje druge URL adresu, parametar i ključne reči po vašem izboru.
Sačuvajte i objavite aplikaciju.
Pokretanje aplikacije.
Izaberite oznaku Surface tablete u vestima da pokrenete pretragu vesti sa ključnim rečima Microsoft Surface tablete.

Napojnica

Radi skalabilnosti, možete da zamenite ručno unete ključne reči u funkciji Launch pomoću promenljivih.

Primer – Param

Idi na Power Apps.
Izaberite Aplikacije u levom oknu za navigaciju.
Izaberite aplikaciju, a zatim izaberite Uredi.
Izaberite Umetni u meniju, a zatim izaberite Oznaka.
Premestite oznaku dole desno na ekranu.
Izaberite svojstvo Text za oznaku gore levo.
Unesite formulu kao Param("browser"). Možete koristiti različiti parametar po vašem izboru.
Sačuvajte i objavite aplikaciju.
Kopirajte veb-vezu za vašu aplikaciju u Power Apps.
Otvorite u novom pregledaču.
Nalepite vezu veb-aplikacije u pregledač i dodajte &browser=Microsoft%20Edge na kraju.
Kada se vaša aplikacija pokrene, oznaka prikazuje prenesenu vrednost parametra.
Zatvorite plejer aplikacije i uredite je.
Izaberite Aplikacija u prikazu stabla na levoj navigaciji.
Izaberite StartScreen osobinu u gornjem levom uglu.
Unesite formulu kao If( Param("screen") = "techspecs", TechSpecs ).

Ako funkcija u StartScreen osobina proverava da li je parametar jednak određenoj vrednosti, u ovom slučaju vrednost techspecs . A ako se poklapa, vraća TechSpecs kontrolu ekrana na StartScreen svojstvo.

Belešku

Zamenite ime kontrole TechSpecs u funkciji If sa imenom kontrole ekrana u sopstvenoj aplikaciji ako ne koristite šablon aplikacije Product Showcase .
Sačuvajte i objavite aplikaciju.
Otvorite u novom pregledaču.
Nalepite vezu veb-aplikacije u pregledač i dodajte &screen=techspecs na kraju.
Aplikacija se direktno pokreće sa TechSpecs kao početnim ekranom.