Funkciji »Launch« in »Param« v rešitvi Power Apps

Članek
06/02/2022
3 min za branje

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 ID aplikacije delovnega območja.
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. Na primer:

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

Aplikacije delovnega območja lahko zaženete s spletno povezavo ali ID-jem aplikacije. Č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 delovnega območja. Parametre lahko vnesete na dva načina:

Seznam argumentov za pare imen in vrednosti. Na primer:

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

Zapis vrednosti polja. Na primer:
```
Launch( "http://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.

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.

Enumerator 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 enumerirane vrednosti uporabite svoj besedilni niz in poimenujte okno ali zavihek. Jaz je 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.
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.

Sintaksa

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

Address – obvezno. Naslov spletne strani ali ID aplikacije, ki jo želite zagnati.
ParameterName(s) – neobvezno. Ime parametra.
ParameterValue(s) – neobvezno. 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) – neobvezno. Ime parametra.
ParameterValue(s) – neobvezno. Ustrezne vrednosti parametrov za prenos v aplikacijo ali na spletno stran.
LaunchTarget – neobvezno. Vrednost enumeratorja LaunchTarget ali ime po meri.

Param( ParameterName )

ParameterName – obvezno. Ime parametra, posredovanega aplikaciji.

Rezervirani parametri

Naslednje ključne besede so rezervirane za interno uporabo in se ne smejo uporabljati kot parameter po meri v param() funkcija:

amp%3 Bauthmode

amp%3 Benableonbehalfof

amp%3 Bhidenavbar

amp%3 Blocale

appmetadataversion

Način avtorizacije

Vrsta kanala

correlationid

delegatelaunchurl

disablepreviewredirect

embedderorigin

Omogočiti v imenu

groupid

hideappsplash

hidenavbar

nasvet

hostclienttype

Način gostitelja

iframecontainerid

Je celozaslonski

Je način predogleda

območne nastavitve

Lastnosti paketa

Barva zaslona

sdkversion

mesto

skipappmetadata

skipiframecreation

skiplaunchappcache

vir

Samostojno soglasje

teamid

Tip ekipe

tenantId

tema

Vloga uporabniške ekipe

Primeri

Enostavni primeri funkcije »Launch«

Iz aplikacije delovnega območja na spletno stran:

Formula	Opis
Launch( "http://bing.com/search", "q", "Power Apps", "count", 1 )	Odpre spletno stran http://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 }, "Search Results" )	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/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.

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.
Zgoraj levo izberite lastnost OnStart.
Vnesite formulo If(Param("screen")="techspecs",Navigate(TechSpecs,Fade)).

Če funkcija v lastnosti OnStart preveri, ali je parameter enak določeni vrednosti, v tem primeru vrednosti techspecs. In če se ujema, aplikacija odpre zaslon TechSpecs.

Opomba

Če ne uporabljate predloge aplikacije Predstavitev izdelkov, zamenjajte ime zaslona TechSpecs v funkciji »Navigate« z imenom zaslona v svoji aplikaciji.
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 zaslonom TechSpecs ali zaslonom, ki ste ga vnesli v funkcijo »Navigate«.