Launch ja Param funktsioonid

Kehtib: Lõuendirakendused

Käivitab veebilehe või lõuendi rakenduse ja pakub juurdepääsu käivitamise parameetritele.

Launch

Käivitab veebilehe või lõuendirakenduse. Funktsioon toetab järgmist.

Aadress (nõutav), lõuendirakenduse veebilehe URL.
Parameetrid (valikuline), nimega väärtused, mida veebilehele või lõuendirakendusse edastada. Lõuendirakenduses saab parameetreid lugeda funktsiooni abil Param .
Target (valikuline), brauseri vahekaart, kus veebileht või lõuendirakendus käivitada.

Launch saab kasutada ainult käitumisvalemites.

Märkus.

Kui valemit Launch kasutatakse Power Appsi avamiseks ja rakendus pole lõppkasutajale nähtav, on soovitatav kontrollida, kas rakendus on brauseri hüpikakende blokeerija poolt blokeeritud või kas brauser ootab kasutaja vastust dialoogiboksile, mis küsib, kas ta soovib liikuda uuele kuvale.
Ainult https: URI-sid toetatakse Launch PowerBI Power Appsi visuaalrakenduses.

Aadress

Veebilehti käivitatakse URL-i aadressi kaudu. Näiteks:

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

Lõuendirakendusi saate käivitada veebilingi või rakenduse URI-ga (rakenduse ID eesliide). /providers/Microsoft.PowerApps/apps/ Rakenduse nende väärtuste leidmiseks tehke järgmist.

Avage Power Apps.
Valige vasakpoolsel navigeerimispaanil suvand Rakendused.
Valige oma rakendus
Valige ülemisest menüüst Üksikasjad.
Võite valida ... (Rohkem käske) ja seejärel valida Üksikasjad rippmenüüst.
Kopeerige veebilink.

Veebilinki saab kasutada mis tahes veebilehel ja see käivitab rakenduse lõuend. Seda saab kasutada ka funktsiooniga Launch . Näiteks:

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

Seadme kohalikke rakendusi ei saa otse käivitada. Mõnel platvormil võib olla kaudseid võimalusi, nagu omarakendus, mis installib kohandatud URL-i süsteemi registreerib veebibrauseriga, et pakkuda teatud veebisaitidele võialust.

Parameetrid

Launch võivad edastada veebilehele või lõuendirakendusele parameetreid. Parameetrite lisamiseks on kaks võimalust:

Nime väärtuse paaride argumentide loend. Näiteks:

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

Väljaväärtuste kirje. Näiteks:
```
Launch( "https://bing.com/search", { q: "Power Apps", count: 1 } )
```
Selle vormiga võib olla hõlpsam töötada, kuna see muudab seose nime ja väärtuse vahel selgemaks. See on ainus vorm, mis toetab valikulist LaunchTarget argumenti.

Aadress ja parameetrid on URL-i, mis on kodeeritud enne nende edastamist, et asendada teatud mitte tähe- ja numbrimärke % ja kuueteistkümnendsüsteemis arvuga, nagu oleks kasutatud EncodeUrl funktsiooni.

Veebilehe käivitamisel võib URL-i aadressi lõppu lisada päringustringi. Täiendavad parameetrid Launch lisatakse päringustringi lõppu. Rakenduse lõuend käivitamisel ei tööta päringustringid.

Rakenduse käivitamisel mobiilseadmes, kus see rakendus juba töötab, ei värskendata parameetreid töötavas rakenduses. Parameetrite värskendamiseks on vajalik rakenduse uuesti laadimine.

Sihtkeel

Kasutage LaunchTarget argumenti, et määrata veebilehe või rakenduse avamiseks soovitud brauseri akent. Kasutage ühte järgmistest LaunchTarget loetelu väärtustest või sisestage kohandatud akna nimi.

LaunchTargeti loetelu	Kirjeldus
Uus	Veebileht või rakendus avatakse uues aknas või vahekaardil.
Asendama	Veebileht või rakendus asendab praeguse akna või vahekaardi.
Nimi	Loendiväärtuse asemel kasutage akna või vahekaardi nimetamiseks oma tekstistringi. Ise on ainult sisemine nimi, mida Launch kasutab ainult funktsioon. See ei mõjuta akna pealkirja ega ühti sellega, mida kasutajad näevad. Kui antud nimega aken või vahekaart on juba olemas, siis selle sisu asendatakse. Vastasel juhul luuakse uus aken või vahekaart. nimi ei saa alata allkriipsuga "_".

Uus on vaike loend, kui töötate veebibrauseris, kus saadaolevateks suvanditeks on käsk Asenda ja nimi . Mobiilimängijas New on vaikimisi veebilehtedel, mille nimi on saadaolev suvand, kuigi praegune lõuendirakendus asendatakse alati mõne muu lõuendirakendusega.

Märkus.

Kui kasutate LaunchTarget väärtuseks muud kui New ei toetata lisatud stsenaariume (nt Power BI või SharePoint) ja tulemuseks võib olla ootamatu käitumine. Edaspidi võib see käitumine muutuda või põhjustada tõrke.

Param

Funktsioon Param toob rakendusele käivitamisel edastatud parameetri. Kui nimega parameetrit ei edastatud, Param tagastab väärtuse tühi.

Lõuendirakenduse käivitamisel mõnest muust lõuendirakendusest kasutage funktsiooni argumente LaunchParameeter. Parameetri nimed ja väärtused kodeeritakse automaatselt URL-i.
Kui käivitate veebilehel lõuendi rakenduse, lisage parameetrid päringustringile lõuendirakenduse veebilingis. See hõlmab &parametername=parametervalue lisamist, eeldades, et päringustringi on juba käivitatud tenantId jaoks. Näiteks &First%20Name=Vicki&category=3 lisamine edastaks kaks parameetrit: First Name väärtusega "Vicki" ja category väärtusega "3" (väärtuse tüüp on tekst). Parameetri nimi ja väärtus peavad olema URL kodeeritud, kui need sisaldavad tühikuid või erimärke, mis on sarnane funktsiooni EncodeURL kastamisele.
Param nimed on tõstutundlikud.
Param nimed ja väärtused dekodeeritakse teie rakenduses kasutamiseks automaatselt URL-i dekodeerituna.
Parameetrite väärtused ei muutu, välja arvatud juhul, kui rakendus laaditakse uuesti. Kui kasutate Launch mobiilsideseadet, kus rakendus juba töötab, ei värskendata parameetreid.
Isegi kui parameeter sisaldab arvu, on tagastatav Param tüüp alati tekstistring. Teisendused muudele tüüpidele toimuvad automaatselt või kasutavad teatud täpseid konversioone, näiteks Value funktsiooni, et teisendada täpselt arvuks.

Märkus.

Kohandatud lehtede puhulon ainsad parameetrid, mida leht aktsepteerib: recordId ja entityName.

Süntaks

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

Aadress – nõutav. Veebisaidi aadress või rakenduse ID käivitamiseks.
ParameterNames – valikuline. Parameetri nimi.
ParameterValues – valikuline. Vastavad parameetri väärtused, et edastada rakendusele või veebilehele.

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

Aadress – nõutav. Veebisaidi aadress või rakenduse ID käivitamiseks.
ParameterNames – valikuline. Parameetri nimi.
ParameterValues – valikuline. Vastavad parameetri väärtused, et edastada rakendusele või veebilehele.
LaunchTarget - valikuline. LaunchTarget loetelu väärtus või kohandatud nimi.

Param( ParameterName )

ParameterName - nõutav. Rakendusele edastatud parameetri nimi.

Reserveeritud parameetrid

Järgmised märksõnad on reserveeritud (sõltumata juhtumist) sisekasutuseks ja neid ei tohiks funktsioonis Param() kasutada kohandatud parameetrina:

amp%3Bauthmode
amp%3Benableonbehalfof
amp%3Bhidenavbar
amp%3Blocale
appmetadataversion
authmode
channeltype
cordovapath
correlationid
siluma
delegatelaunchurl
delegatelaunchurl
disablepreviewredirect
embedderorigin
enableonbehalfof
groupid
hideappsplash
hidenavbar
vihje
hostclienttype
hostmode
iframecontainerid
isfullscreen
ispreviewmode
laadija
loaderType
lokaat
asukoht
packagekind
packageproperties
playerresourcespath
playersessionid
powerappslanguage
screencolor
sdkversion
sait
skipappmetadata
skipiframecreation
skiplaunchappcache
allikas
allikaaeg
standaloneconsent
teamid
teamtype
tenantId
teema
uselocalpackagehostresources
userteamrole

Näited

Lihtne Launch

Lõuendirakendusest veebilehele:

Valem	Kirjeldus
Launch( "http://bing.com/search", "q", "Power Apps", "count", 1 )	Avab veebilehe https://bing.com/search?q=Power%20Apps& arv=1. Avatakse uus aken või vahekaart.
Launch( "http://bing.com/search", { q: "Power Apps", count: 1 } )	Samad, mis varasemates näidetes, kasutades samasugust kirje vormingut. Avatakse uus aken või vahekaart.
Launch( "http://bing.com/search", { q: "Power Apps", arv: 1 }, LaunchTarget.Replace )	Samad, mis eelmistel näidetel, asendades praeguse akna või vahekaardi tulemiga, kui töötate veebibrauseris.
Launch( "http://bing.com/search", { q: "Power Apps", arv: 1 }, "Otsingutulemused" )	Sama, mis eelmises näites, mis loob või asendab akna või vahekaardi nimega Otsingutulemid.

Lõuendirakendusest lõuendirakendusse

Värskendage rakenduse ID-d, varjunime ja kirje numbrit vastavalt vajadusele.

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

Veebilehest lõuendirakendusse:

Uuendage rakenduse ID-d, rentniku ID-d ja kirje numbrit vastavalt vajadusele.

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

Lihtne Param

Lihtsa käivitamise näited veebilehelt või mõnest muust lõuendirakendusest lõuendirakenduse käivitamiseks on lihtsad näited funktsiooni kohtaParam.

Valem	Kirjeldus	Tulem
Param( "Navigeeri" )	Parameeter Navigate esitati rakenduse käivitamisel ja tagastamisel.	"Teine ekraan"
Param( "Record" )	Parameeter Kirje esitati rakenduse käivitamisel ja tagastamisel. Kuigi see edastati funktsioonile Launch arvuna, on tulemiks Param tekstistring, mida saab kaudselt või konkreetselt teisendada teist tüüpi tekstiks.	"34"
Param( "Kasutaja" )	Kasutaja parameetrit ei esitatud. Väärtus tühi ja seda saab kontrollida funktsiooniga IsBlank.	tühi

Üksikasjalikud näited LaunchParam

Product Showcase tahvelarvuti paigutuse malli kasutati järgmistes näidetes. Selle malliga rakenduse loomiseks järgige juhiseid rakenduse loomise artiklist ja valige rakenduse Toote presentatsioon mall. Samuti saate oma rakendust kasutada.

Näide- Launch

Avage Power Apps.
Valige vasakpoolsel navigeerimispaanil suvand Rakendused.
Valige oma rakendus ja seejärel valige Redigeeri.
Valige menüü käsk Sisesta ja seejärel valige Silt.
Viige silt ekraani paremasse allserva.
Parempoolsel paanil Atribuudid valige Värvi väärtuseks Valge ja seadke Raami paksuse väärtuseks 1.
Valige atribuut Tekst parempoolses servas ja sisestage tekst Surface tablets in news.
Valige vasakus loendis atribuut OnSelect.
Sisestage valem kui Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). Saate kasutada ka enda valitud mis tahes muud URL-i, parameetrit ja võtmesõnu.
Rakenduse salvestamine ja avaldamine.
Mängige rakendusega
Valige silt Surface'i tahvelarvutid uudistes, et käivitada uudiste otsing märksõnadega Microsoft Surface tahvelarvutid.

Jootraha

Skaleeritavuse huvides saate käsitsi sisestatud märksõnad asendada funktsiooni muutujategaLaunch.

Näide- Param

Avage Power Apps.
Valige vasakpoolsel navigeerimispaanil suvand Rakendused.
Valige oma rakendus ja seejärel valige Redigeeri.
Valige menüü käsk Sisesta ja seejärel valige Silt.
Viige silt ekraani paremasse allserva.
Valige Tekst atribuut sildi jaoks ülevalt vasakult.
Sisestage valem kui Param("browser"). Saate kasutada ka enda valitud erinevaid parameetreid.
Rakenduse salvestamine ja avaldamine.
Kopeerige oma rakenduse veebilink rakendusest Power Apps.
Avage uus brauser.
Kleepige rakenduse veebilink brauserisse ja lisage &browser=Microsoft%20Edge lõppu.
Kui teie rakendus käivitub, kuvatakse sildil edastatud parameetri väärtus.
Sulgege rakendusemängija ja redigeerige rakendust.
Valige Rakendus vasakpoolsel navigeerimisel rakendusest Tree View.
Valige vasakus ülanurgas atribuut StartScreen .
Sisestage valem nimega If( Param("screen") = "techspecs", TechSpecs ).

Atribuudi StartScreen funktsioon If kontrollib, kas parameeter võrdub teatud väärtusega (antud juhul väärtus techspecs). Ja kui see ühtib, tagastab TechSpecsi ekraani juhtelemendi atribuudile StartScreen .

Märkus.

Asendage TechSpecsi juhtelemendi nimi funktsioonis If oma rakenduse ekraani juhtelemendi nimega, kui te ei kasuta rakenduse Product Showcase malli.
Rakenduse salvestamine ja avaldamine.
Avage uus brauser.
Kleepige rakenduse veebilink brauserisse ja lisage &screen=techspecs lõppu.
Rakendus käivitub otse TechSpecsiga avaekraanina .

Vaata ka

Lõuendirakenduse valemiviide

Tagasiside

Kas sellest lehest oli abi?

Last updated on 2025-10-10

Jagamisviis:

Launch ja Param funktsioonid

Launch

Aadress

Parameetrid

Sihtkeel

Param

Süntaks

Reserveeritud parameetrid

Näited

Lihtne Launch

Lõuendirakendusest veebilehele:

Lõuendirakendusest lõuendirakendusse

Veebilehest lõuendirakendusse:

Lihtne Param

Üksikasjalikud näited LaunchParam

Näide- Launch

Näide- Param

Vaata ka

Tagasiside

Lisaressursid