Funkcije Launch in Param

Članek
03/22/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 ali URI aplikacije (ID aplikacije s predpono /providers/Microsoft.PowerApps/apps/) aplikacije platna.
Parametri (neobvezno); poimenovane vrednosti, ki jih želite vnesti na spletno stran ali v aplikacijo delovnega območja. V aplikaciji delovnega območja je parametre mogoče brati s funkcijo Param.
Cilj (neobvezno); zavihek brskalnika, v katerem zaženete spletno stran ali aplikacijo delovnega območja.

Funkcija Launch se lahko uporabi samo v formulah za delovanje.

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.
Kopirajte Spletno povezavo ali ID aplikacije.

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

ID aplikacije se lahko uporablja s funkcijo Launch, vendar mora imeti predpono /providers/Microsoft.PowerApps/apps/. Na primer:

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

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

Funkcija Launch lahko posreduje parametre na spletno stran ali v aplikacijo s platnom. 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
New	Spletna stran ali aplikacija se odpre v novem oknu ali zavihku.
Replace	Spletna stran ali aplikacija zamenja trenutno okno ali zavihek.
name	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 more začeti s podčrtajem »_«.

New je privzet enumerator, če funkcijo, ki ima Replace in name kot razpoložljivi možnosti, uporabljate v spletnem brskalniku. 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

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

Address – obvezno. Naslov spletne strani ali ID aplikacije, ki jo želite zagnati.
ParameterName(s) – izbirno. Ime parametra.
ParameterValue(s) – izbirno. Ustrezne vrednosti parametrov za prenos v aplikacijo ali na spletno stran.

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

Address – obvezno. Naslov spletne strani ali ID aplikacije, ki jo želite zagnati.
ParameterName(s) – izbirno. Ime parametra.
ParameterValue(s) – izbirno. Ustrezne vrednosti parametrov za prenos v aplikacijo ali na spletno stran.
LaunchTarget – izbirno. Vrednost enumeratorja LaunchTarget ali ime po meri.

Param( ParameterName )

ParameterName – obvezno. 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
Launch( "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.
Launch( "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.
Launch( "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.
Launch( "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( "Navigate" )	Parameter Navigate je bil naveden ob zagonu aplikacije in je vrnjen.	»Second Screen«
Param( "Record" )	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( "User" )	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 Tablični računalniki Surface v novicah za začetek iskanja novic s ključnimi besedami Tablični računalniki Microsoft Surface.

Napitnina

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 neposredno zažene z TechSpecs kot začetnim zaslonom.