Funkcije Launch in Param

Članek
10/16/2024

Velja za: aplikacije Canvas

Zažene spletno stran ali aplikacijo delovnega območja in omogoči dostop do parametrov za zagon.

Odpiranje

Zažene spletno stran ali aplikacijo delovnega območja. Funkcija podpira:

Naslov (obvezno), URL spletne strani aplikacije Canvas.
Parametri (izbirno), poimenovane vrednosti za posredovanje spletni strani ali aplikaciji platna. V aplikaciji delovnega območja je parametre mogoče brati s funkcijo Param.
Cilj (izbirno), zavihek brskalnika, v katerem zaženete spletno stran ali aplikacijo platna.

Zagon se lahko uporablja le v formulah vedenja.

opomba,

Če se formula za zagon uporablja za odpiranje Power Apps in aplikacija ni vidna končnemu uporabniku, priporočamo, da preverite, ali je aplikacija blokirana s preprečevalnikom pojavnih oken v brskalniku ali če brskalnik čaka na odgovor uporabnika v pogovorno okno, ki ga vpraša, ali se želi pomakniti na nov zaslon.

Naslov

Spletne strani se zaženejo prek naslova URL. Primer:

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

Aplikacije platna lahko zaženete s spletno povezavo ali URI-jem aplikacije (ID aplikacije s predpono /providers/Microsoft.PowerApps/apps/). Če želite poiskati te vrednosti za aplikacijo:

Obiščite spletno mesto Power Apps.
V levem podoknu za krmarjenje izberite Aplikacije.
Izberite svojo aplikacijo.
V meniju na vrhu izberite Podrobnosti.
Izberete lahko tudi ... (Več ukazov) in nato Podrobnosti na spustnem seznamu.
Kopiraj Spletno povezavo.

Spletna povezava se lahko uporablja na katerikoli spletni strani in zažene aplikacijo delovnega območja. Uporablja se lahko tudi s funkcijo Launch. Primer:

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

Izvornih aplikacij v napravi ni mogoče zagnati neposredno. Na nekaterih platformah so lahko na voljo posredne možnosti, kot sta izvorna aplikacija, ki namesti shemo URL po meri ali se registrira v spletnem brskalniku in omogoči možnost za določena spletna mesta.

Parametri

Launch lahko posreduje parametre spletni strani ali aplikaciji platna. Parametre lahko vnesete na dva načina:

Seznam argumentov za pare imen in vrednosti. 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 } )
```
S tem obrazcem je lažje delati, saj je povezava med imenom in vrednostjo jasnejša. To je edini obrazec, ki podpira neobvezni argument LaunchTarget.

Naslov in parametri so kodirani v obliki URL, preden so posredovani in zamenjajo določene znake, ki niso alfanumerični, z % in šestnajstiškim številom, kot da je bila pri vsakem uporabljena funkcija EncodeUrl.

Ko zaženete spletno stran, lahko niz poizvedbe s parametri vključite na koncu naslova URL. Morebitni dodatni parametri, vneseni v funkcijo Launch, bodo dodani na konec niza poizvedbe. Nizi poizvedbe ne delujejo, ko zaženete aplikacijo delovnega območja.

Pri zagonu aplikacije na mobilni napravi, kjer se ta aplikacija že izvaja, parametri v delujoči aplikaciji ne bodo osveženi. Za osvežitev parametrov je potrebno ponovno nalaganje aplikacije.

Cilj

Uporabite argument LaunchTarget, da določite ciljno okno brskalnika, v katerem želite odpreti spletno stran ali aplikacijo. Uporabite eno od spodnjih vrednosti enumeratorja LaunchTarget ali vnesite ime okna po meri.

Oštevilčenje LaunchTarget	Opis
Novo	Spletna stran ali aplikacija se odpre v novem oknu ali zavihku.
Zamenjaj	Spletna stran ali aplikacija zamenja trenutno okno ali zavihek.
ime	Namesto oštevilčene vrednosti uporabite svoj besedilni niz in poimenujte okno ali zavihek. Jaz je le interno ime, ki ga uporablja samo funkcija Launch. Nima nobenega vpliva niti se ne ujema z nazivom okna, ki ga vidijo vaši uporabniki. Če okno ali zavihek z danim imenom že obstaja, bo njegova vsebina zamenjana. V nasprotnem primeru bo ustvarjeno novo okno ali zavihek. ime se ne sme začeti s podčrtajem »_«.

Novo je privzeti oštevilčenje pri izvajanju v spletnem brskalniku z Zamenjaj in imenom kot razpoložljive možnosti. V predvajalniku prenosne naprave je vrednost Novo privzeta za spletne strani, ki imajo ime kot razpoložljivo možnost; medtem ko bo trenutno aplikacijo s platnom vedno zamenjala druga aplikacija s platnom.

opomba,

Uporaba možnosti LaunchTarget s katero koli vrednostjo, ki ni vrednost Novo, v vdelanih scenarijih (na primer Power BI ali SharePoint) ni podprta in lahko povzroči nepričakovano vedenje. V prihodnosti se lahko to vedenje spremeni ali lahko povzroči napako.

Param

Funkcija Param pridobi parameter, ki je bil posredovan aplikaciji, ko je bila zagnana. Če poimenovani parameter ni bil posredovan, funkcije Param vrne prazno vrednost.

Pri zagonu aplikacije delovnega območja iz druge aplikacije delovnega območja uporabite argumente Parameter za funkcijo Launch. Imena in vrednosti parametrov bodo samodejno kodirani obliki URL.
Pri zagonu aplikacije delovnega območja s spletne strani, dodajte parametre v niz poizvedbe za spletno povezavo aplikacije delovnega območja. To vključuje dodajanje parametra &parametername=parametervalue ob predpostavki, da je niz poizvedbe že zagnan za tenantId. Če na primer dodate &First%20Name=Vicki&category=3, sta posredovana dva parametra: First Name z vrednostjo "Vicki" in category z vrednostjo "3" (vrsta vrednosti je besedilo). Ime in vrednost parametra morata biti kodirana v obliki URL, če vsebujeta presledke ali posebne znake, podobno kot pri uporabi funkcije EncodeURL.
Imena funkcije »Param« razlikujejo med velikimi in malimi črkami.
Imena in vrednosti funkcije »Param« bodo samodejno dekodirani iz oblike URL za uporabo v vaši aplikaciji.
Vrednosti parametrov se ne spremenijo, razen če se aplikacija znova naloži. Uporaba Launch na mobilni napravi, kjer se aplikacija že izvaja, ne osveži parametrov.
Tudi če parameter vsebuje številko, je vrsta, ki jo vrne funkcija Param, vedno besedilni niz. Pretvorba v druge vrste se zgodi samodejno, lahko pa uporabite izrecne pretvorbe, kot je funkcija Value, za izrecno pretvorbo v število.

opomba,

Za strani po meri sta edina parametra, ki ju stran sprejme: recordId in entityName.

Sintaksa

Zagon( Naslov [, ImeParametra1, VrednostParametra1 , ... ] )

Naslov – obvezno. Naslov spletne strani ali ID aplikacije, ki jo želite zagnati.
Imena parametrov – Izbirno. Ime parametra.
ParameterValues – Izbirno. Ustrezne vrednosti parametrov za prenos v aplikacijo ali na spletno stran.

Zagon( Naslov, { [ Imeparametra1: ParameterValue1, ... ] } [, LaunchTarget ] )

Naslov – obvezno. Naslov spletne strani ali ID aplikacije, ki jo želite zagnati.
Imena parametrov – Izbirno. Ime parametra.
ParameterValues – Izbirno. Ustrezne vrednosti parametrov za prenos v aplikacijo ali na spletno stran.
LaunchTarget – Izbirno. Vrednost enumeratorja LaunchTarget ali ime po meri.

Param( Imeparametra )

ParameterName - Zahtevano. Ime parametra, posredovanega aplikaciji.

Rezervirani parametri

Naslednje ključne besede so rezervirane (ne glede na velikost črk) za interno uporabo in se ne smejo uporabljati kot parameter po meri v funkciji Param():

amp%3Bauthmode
amp%3Benableonbehalfof
amp%3Bhidenavbar
amp%3Blocale
appmetadataversion
authmode
channeltype
cordovapath
correlationid
debug
delegatelaunchurl
delegatelaunchurl
disablepreviewredirect
embedderorigin
enableonbehalfof
groupid
hideappsplash
hidenavbar
nasvet
hostclienttype
hostmode
iframecontainerid
isfullscreen
ispreviewmode
loader
loaderType
območne nastavitve
location
packagekind
packageproperties
playerresourcespath
playersessionid
powerappslanguage
screencolor
sdkversion
mesto
skipappmetadata
skipiframecreation
skiplaunchappcache
vir
Izvorni čas
standaloneconsent
teamid
teamtype
tenantId
tema
uselocalpackagehostresources
userteamrole

Primeri

Enostavni primeri funkcije »Launch«

Iz aplikacije delovnega območja na spletno stran:

Formula	Description
Zaženi( "http://bing.com/search", "q", "Power Apps", "count", 1 )	Odpre spletno stran https://bing.com/search?q=Power%20Apps&count=1. Odpre se novo okno ali zavihek.
Zaženi( "http://bing.com/search", { q: "Power Apps", count: 1 } )	Enako kot v prejšnjih primerih, le da je uporabljen enakovreden zapis zapisa. Odpre se novo okno ali zavihek.
Zaženi( "http://bing.com/search", { q: "Power Apps", count: 1 }, LaunchTarget.Replace )	Enako kot v prejšnjih primerih, le da se trenutno okno ali zavihek nadomesti z rezultatom, če se izvaja v spletnem brskalniku.
Zaženi( "http://bing.com/search", { q: "Power Apps", count: 1 }, "Rezultati iskanja")	Enako kot v prejšnjem primeru. Ustvari ali zamenja se vsebina okna ali zavihka z imenom Search Results (Rezultati iskanja).

Iz aplikacije delovnega območja v aplikacijo delovnega območja

Po potrebi posodobite ID aplikacije, ime zaslona in številko zapisa.

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

S spletne strani v aplikacijo delovnega območja

Po potrebi posodobite ID aplikacije, ID najemnika, ime zaslona in številko zapisa.

<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>

Enostavni primeri funkcije »Param«

Zgornji enostavni primeri funkcije »Launch« za zagon aplikacije delovnega območja s spletne strani ali iz druge aplikacije delovnega območja prikažejo enostavne primere za funkcijo »Param«:

Formula	Opis	Rezultat
Param ("Krmarjenje")	Parameter Navigate je bil naveden ob zagonu aplikacije in je vrnjen.	»Second Screen«
Param ("Zapis")	Parameter Record je bil naveden ob zagonu aplikacije. Čeprav je bil posredovan funkciji Launch kot številka, je rezultat iz funkcije Param besedilni niz, ki ga je mogoče neizrecno ali izrecno pretvoriti v druge vrste.	»34«
Param( "Uporabnik")	Parameter User ni bil naveden. Vrnjena je prazna vrednost, ki jo je mogoče preskusiti s funkcijo IsBlank.	prazno

Primeri po korakih za funkciji »Launch« in »Param«

V spodnjih primerih je bila uporabljena postavitev za tablični računalnik Predstavitev izdelkov. Če želite ustvariti aplikacijo s to predlogo, sledite navodilom v članku o ustvarjanju aplikacije in izberite predlogo Predstavitev izdelkov. Uporabite lahko tudi svojo aplikacijo.

Primer – Launch

Obiščite spletno mesto Power Apps.
V levem podoknu za krmarjenje izberite Aplikacije.
Izberite aplikacijo in nato Uredi.
V meniju izberite Vstavljanje in nato Oznaka.
Premaknite oznako v spodnji desni del zaslona.
V podoknu z lastnostmi na desni strani za možnost Barva izberite bela, možnost Debelina obrobe pa nastavite na 1.
Na desni strani izberite lastnost Besedilo in vnesite besedilo Tablični računalniki Surface v novicah.
Na seznamu lastnosti zgoraj levo izberite OnSelect.
Vnesite formulo Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). Uporabite lahko tudi katerikoli drug URL, parameter in ključne besede po svojih željah.
Shranite in objavite aplikacijo.
Predvajajte aplikacijo.
Izberite oznako Surface tablets v novicah za začetek iskanja novic s ključnimi besedami Microsoft Surface tablets.

Nasvet

Za skalabilnost lahko ročno vnesene ključne besede v funkciji »Launch« zamenjate s spremenljivkami.

Primer – Param

Obiščite spletno mesto Power Apps.
V levem podoknu za krmarjenje izberite Aplikacije.
Izberite aplikacijo in nato Uredi.
V meniju izberite Vstavljanje in nato Oznaka.
Premaknite oznako v spodnji desni del zaslona.
Zgoraj levo izberite lastnost Besedilo za oznako.
Vnesite formulo Param("browser"). Uporabite lahko tudi drug parameter po svoji izbiri.
Shranite in objavite aplikacijo.
Kopirajte spletno povezavo za svojo aplikacijo iz rešitve Power Apps.
Odprite nov brskalnik.
Prilepite spletno povezavo aplikacije v brskalnik in na koncu dodajte &browser=Microsoft%20Edge.
Ko se aplikacija zažene, oznaka prikazuje posredovano vrednost parametra.
Zaprite predvajalnik aplikacij in uredite aplikacijo.
V drevesnem pogledu na levi strani izberite Aplikacija.
V zgornjem levem kotu izberite lastnost StartScreen .
Vnesite formulo kot If( Param("screen") = "techspecs", TechSpecs ).

Če funkcija v lastnosti StartScreen preveri, ali je parameter enak določeni vrednosti, v tem primeru vrednosti techspecs. In če se ujema, vrne kontrolnik zaslona TechSpecs v lastnost StartScreen .

opomba,

Zamenjajte ime kontrolnika TechSpecs v funkciji If z imenom kontrolnika zaslona v svoji aplikaciji, če ne uporabljate predloge aplikacije Predstavitev izdelka .
Shranite in objavite aplikacijo.
Odprite nov brskalnik.
Prilepite spletno povezavo aplikacije v brskalnik in na koncu dodajte &screen=techspecs.
Aplikacija se zažene neposredno z TechSpecs kot začetnim zaslonom.