Launch és Param függvények

A következőkre vonatkozik: Vászonalapú alkalmazások

Elindít egy weblapot vagy egy vászonalaú alkalmazást, és hozzáférést biztosít az indítási paraméterekhez.

Launch

Megnyit egy weblapot vagy egy vászonalapú alkalmazást. A függvény a következőket támogatja:

Address (required), a vászonalapú alkalmazás weboldalának URL-címe.
Paraméterek (nem kötelező), elnevezett értékek, amelyeket át kell adni a weboldalnak vagy a vászonalapú alkalmazásnak. A vászonalapú alkalmazásokban a paraméterek a függvénnyel Param olvashatók.
Cél (opcionális), a böngészőlap, amelyen elindíthatja a weboldalt vagy a vászonalapú alkalmazást.

Launch csak viselkedésképletekben használható.

Feljegyzés

Ha a Képlet a Launch Power Apps megnyitására szolgál, és az alkalmazás nem látható a végfelhasználó számára, javasoljuk, hogy ellenőrizze, hogy az alkalmazást letiltotta-e a böngésző előugró ablakának blokkolója, vagy hogy a böngésző megvárja-e a felhasználó válaszát egy párbeszédpanelre, amely megkérdezi, hogy szeretne-e új képernyőre navigálni.
Csak https: Az URI-k támogatottak a Power BI Power Apps-vizualizációjában való használat Launch esetén.

Cím

A weblapok URL-cím segítségével indíthatók el. Például:

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

A vászonalapú alkalmazásokat webes hivatkozással vagy alkalmazás URI-val (alkalmazásazonosítóval, /providers/Microsoft.PowerApps/apps/előtaggal) indíthatja el. Az alkalmazások értékeinek megkeresése:

Ugrás: Power Apps.
Válassza a bal navigációs ablaktáblán az Alkalmazások elemet.
Válassza ki az alkalmazását
Válassza a Részletek lehetőséget a felső menüből.
A "... (További parancsok) is használható alkalmazáshoz, majd válassza a Részletek lehetőséget a legördülő menüből.
Webes hivatkozás másolása.

A Webhivatkozás bármely weblapon használható, és a vászonalapú alkalmazást is elindítja. A függvényhez Launch is használható. Például:

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

Az eszközön lévő natív alkalmazások nem indíthatók el közvetlenül. Előfordulhat, hogy bizonyos platformokon rendelkezésre állnak közvetett lehetőségek, például egy egyéni URL-séma telepítése, vagy regisztráció a webböngészőben, ami lehetőséget biztosít az adott weboldalakhoz.

Paraméterek

Launch paramétereket adhat át a weblapnak vagy a vászonalkalmazásnak. A paraméterek kétféleképpen módon adhatók meg:

Névértékpárok argumentumlistája. Például:

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

Mezőértékek rekordja. Például:
```
Launch( "https://bing.com/search", { q: "Power Apps", count: 1 } )
```
Ez az űrlap könnyebben használható, mivel a név és az érték között világosabb társítást teszi lehetővé. Ez az egyetlen olyan űrlap, amely támogatja a nem kötelező LaunchTarget argumentumot.

A cím és a paraméterek az URL-kódoltak az átadást megelőzően, hogy bizonyos nem alfanumerikus karaktereket % és hexadecimális számokra cseréljenek, mintha az EncodeUrl függvényt használták volna mindegyiken.

Weblapok indításakor az URL-cím végén egy paraméterekből álló lekérdezési karakterlánc is szerepelhet. A megadott további paraméterek Launch a lekérdezési sztring végéhez lesznek hozzáadva. A lekérdezési karakterláncok nem működnek a vászonalapú alkalmazások indításakor.

Ha olyan mobileszközön indít el egy alkalmazást, amelyen az alkalmazás már fut, a paraméterek nem frissülnek a futó alkalmazásban. A paraméterek frissítéséhez újra be kell tölteni az alkalmazást.

Target

A LaunchTarget argumentummal adhatja meg a cél böngészőablakot, amelyben megnyitja a weblapot vagy az alkalmazást. Használja a következő LaunchTarget felsorolási értékek egyikét, vagy adja meg az egyéni ablak nevét.

LaunchTarget felsorolás	Adatfolyam leírása
Új	A weblap vagy az alkalmazás új ablakban vagy lapon nyílik meg.
Helyettesít	A weblap vagy az alkalmazás lecseréli az aktuális ablakot vagy lapot.
név	Enumerálási érték helyett használja a saját szöveges sztringet az ablak vagy a lap elnevezéséhez . Az Önnév csak belső név, amelyet csak a Launch függvény használ. A felhasználó által megtekintett ablak címének nincs hatása, és nem is felel meg annak. Ha a megadott nevű ablak vagy lap már létezik, akkor a program felülírja a tartalmát. Ellenkező esetben új ablak vagy lap jön létre. A név nem kezdődhet aláhúzásjellel "_".

Az Új az alapértelmezett felsorolás, ha webböngészőben fut a Csereésnév mint elérhető beállításokkal. A mobillejátszóban az Új az alapértelmezett a névvel, mint rendelkezésre álló opcióval rendelkező weboldalakhoz, míg az aktuális vászonalapú alkalmazást mindig egy másik vászonalapú alkalmazás váltja fel.

Feljegyzés

A beágyazott helyzetekben (például Power BI vagy SharePoint) az Új elemtől eltérő értékkel rendelkező LaunchTarget használata nem támogatott, és előfordulhat, hogy nem várt viselkedést eredményez. A jövőben ez a viselkedés megváltozhat vagy hibát okozhat.

Param

A Param függvény lekéri az alkalmazásnak átadott paramétert az indításkor. Ha a névvel ellátott paraméter nem lett átadva, Paramüres értéket ad vissza.

Ha vászonalapú alkalmazást indít el egy másik vászonalapú alkalmazásból, használja a Paraméter argumentumokat a Launch függvényhez. A paraméterek nevi és értékei automatikusan URL-kódolva lesznek.
Egy vászonalapú alkalmazás webhelyről történő indításakor adja hozzá a paramétereket a lekérdezési sztringhez a vászonalapú alkalmazás webhivatkozásába. Ez magában foglalja a &parametername=parametervalue hozzáadását feltételezve, hogy a lekérdezési karakterláncot már megkezdte a tenantId esetében. Például a &First%20Name=Vicki&category=3 hozzáadása két paramétert fog átadni: First Name, "Vicki" értékkel és category, "3" értékkel (az érték típusa szöveg). A paraméter nevének és értékének URL-kódolásúnak kell lennie, ha szóközöket vagy különleges karaktereket tartalmaznak, hasonlóan az EncodeURL függvény használatához.
Param a nevek megkülönböztetik a kis- és nagybetűket.
Param a rendszer automatikusan dekódolja a neveket és értékeket az alkalmazásban való használatra.
A paraméterértékek csak akkor változnak, ha az alkalmazást újra betöltik. Ha olyan mobileszközön használja Launch , amelyen az alkalmazás már fut, nem frissíti a paramétereket.
Még akkor is, ha a paraméter tartalmaz egy számot, a visszaadott Param típus mindig szöveges sztring lesz. Az egyéb típusokra való áttérés automatikusan megtörténik, vagy olyan explicit konverziókat használatával, mint például az Value függvény, hogy explicit módon egy adott számra lehessen átalakítani.

Feljegyzés

Egyéni oldalak esetén az oldal csak a következő paramétereket fogadja el: recordId és entityName.

Szintaxis

Launch( Cím [, ParameterName1, ParameterValue1, ... ] )

Cím – Kötelező. A betöltendő weblap címe vagy az elindítandó alkalmazás azonosítója.
ParameterNames – Nem kötelező. Paraméter neve.
ParameterValues – Nem kötelező. Az alkalmazásnak vagy a weblapnak átadandó, megfelelő paraméterértékek.

Launch( Cím, { [ ParameterName1: ParameterValue1, ... ] } [, LaunchTarget ] )

Cím – Kötelező. A betöltendő weblap címe vagy az elindítandó alkalmazás azonosítója.
ParameterNames – Nem kötelező. Paraméter neve.
ParameterValues – Nem kötelező. Az alkalmazásnak vagy a weblapnak átadandó, megfelelő paraméterértékek.
LaunchTarget – Nem kötelező. A LaunchTarget felsorolási érték vagy egyéni név.

Param( ParameterName )

ParameterName - Kötelező. Az alkalmazásnak átadott paraméter neve.

Fenntartott paraméterek

A következő kulcsszavak (esettől függetlenül) belső használatra vannak fenntartva, és nem használhatók egyéni paraméterként a Param() függvényben:

amp%3Bauthmode
amp%3Benableonbehalfof
amp%3Bhidenavbar
amp%3Blocale
appmetadataversion
authmode
channeltype
cordovapath
correlationid
hibakeresés
delegatelaunchurl
delegatelaunchurl
disablepreviewredirect
embedderorigin
enableonbehalfof
groupid
hideappsplash
hidenavbar
végrehajtási módosító
hostclienttype
hostmode
iframecontainerid
isfullscreen
ispreviewmode
loader
loaderType
területi beállítás
hely
packagekind
packageproperties
playerresourcespath
playersessionid
powerappslanguage
screencolor
sdkversion
hely
skipappmetadata
skipiframecreation
skiplaunchappcache
adatforrás
Forrásidő
standaloneconsent
teamid
teamtype
tenantId
téma
uselocalpackagehostresources
userteamrole

Példák

Egyszerű Launch

Vászonalapú alkalmazásból weboldalra:

Képlet	Adatfolyam leírása
Launch( "http://bing.com/search"; "q", "Power Apps", "count", 1 )	Megnyitja a weboldalt https://bing.com/search?q=Power%20Apps& darab=1. Új ablak vagy lap nyílik meg.
Launch( "http://bing.com/search"; { q: "Power Apps", count: 1 } )	Ugyanaz, mint az előző példákban az egyenértékű bejegyzés-jelöléssel használatával. Új ablak vagy lap nyílik meg.
Launch( "http://bing.com/search"; { q: "Power Apps", count: 1 }, LaunchTarget.Replace )	Ugyanaz, mint az előző példák, az aktuális ablak vagy lap lecserélése az eredményre, ha böngészőben fut.
Launch( "http://bing.com/search"; { q: "Power Apps", count: 1 }, „Keresési eredmények” )	Ugyanaz, mint az előző példában, a Keresési eredmények nevű ablak vagy lap tartalmának létrehozása vagy cseréje.

Vászonalapú alkalmazásból vászonalapú alkalmazásba

Módosítsa az alkalmazásazonosítót, a képernyő nevét és a bejegyzés számát a megfelelő módon.

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

Weboldalól vászonalapú alkalmazásba

Módosítsa az alkalmazásazonosítót, a bérlőazonosítót a képernyő nevét és a bejegyzés számát a megfelelő módon.

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

Egyszerű Param

A fenti egyszerű indítási példák a vászonalapú alkalmazás weblapról vagy egy másik vászonalapú alkalmazásból való elindításához egyszerű példákat mutatnak a függvényre Param :

Képlet	Adatfolyam leírása	Eredmény
Param( "Navigálás" )	A Navigálás paramétert az alkalmazás elindításakor megadták, és a rendszer visszaküldi.	„Második képernyő”
Param( "Rekord" )	A Rekord paramétert az alkalmazás elindításakor megadták, és a rendszer visszaküldi. Annak ellenére, hogy a függvény számként Launch lett átadva, az eredmény Param egy szöveges sztring lesz, amely implicit módon vagy explicit módon konvertálható más típusokra.	"34"
Param( "Felhasználó" )	A Felhasználó paraméter nem volt megadva. A rendszer egy üres értéket ad vissza, amelyet az IsBlank függvénnyel lehet tesztelni.	üres

Példák lépésről lépésre a következőhöz Launch : Param

A következő példában a Termékbemutató sablont használtuk. Ha ehhez a sablonhoz szeretne létrehozni egy alkalmazást, hajtsa végre az alkalmazás létrehozása cikk lépéseit, és válassza ki a Termékbemutató sablont. Saját alkalmazását is használhatja.

Példa- Launch

Ugrás: Power Apps.
Válassza a bal navigációs ablaktáblán az Alkalmazások elemet.
Válassza ki az alkalmazását, és válassza a Szerkesztés lehetőséget.
Válassza ki a Beszúrás lehetőséget a menüből, majd válassza a Címke lehetőséget.
Mozgassa a címkét a képernyő jobb alsó sarkába.
A jobb oldalon található tulajdonságok ablaktáblában válassza a Színhez a fehér elemet, és állítsa be a Keret vastagságát1 értékre.
Válassza ki a Szöveg tulajdonságot a jobb oldalon, és írja be a szöveget: Surface táblagépek a hírekben.
A bal felső sarokban tulajdonságlistában az OnSelect lehetőséget.
Adja meg a képletet a következőként: Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). Bármilyen más URL-címet, paramétert vagy kulcsszót is használhat.
Alkalmazás mentése és közzététele.
Az alkalmazás indítása.
Válassza ki a Surface táblagépek hírekben címkét , hogy indítsa elindítsa a hírek keresését a Microsoft Surface táblagépek kulcsszavakkal.

Tipp.

A méretezhetőség érdekében a függvényben Launch manuálisan megadott kulcsszavakat változókra cserélheti.

Példa- Param

Ugrás: Power Apps.
Válassza a bal navigációs ablaktáblán az Alkalmazások elemet.
Válassza ki az alkalmazását, és válassza a Szerkesztés lehetőséget.
Válassza ki a Beszúrás lehetőséget a menüből, majd válassza a Címke lehetőséget.
Mozgassa a címkét a képernyő jobb alsó sarkába.
Jelöljön ki egy Szöveg tulajdonságot a címkéhez bal felső részen.
Adja meg a képletet a következőként: Param("browser"). Másik választott paramétert is használhat.
Alkalmazás mentése és közzététele.
Másolja a webhivatkozást az alkalmazáshoz a Power Apps-szolgáltatáshoz.
Nyisson meg egy új böngészőt.
Illessze be az alkalmazás webhivatkozását a böngészőbe, és fűzze a végéhez a &browser=Microsoft%20Edge kifejezést.
Amikor az alkalmazás elindul, a címke mutatja az átadott paraméterértértéket.
Zárja be az alkalmazáslejátszót, és szerkessze az alkalmazást.
Válassza az Alkalmazás lehetőséget a Fanézetből a bal oldali navigációs felületen.
Válassza a StartScreen tulajdonságot a bal felső sarokban.
Adja meg a képletet If( Param("screen") = "techspecs", TechSpecs ).

Ha függvény a StartScreen tulajdonságban ellenőrzi, hogy a paraméter egyenlő-e egy bizonyos értékkel, ebben az esetben a technikai specifikációkkal. Ha pedig egyezik, visszaadja a TechSpecs képernyővezérlőt a StartScreen tulajdonságnak.

Feljegyzés

Cserélje le a TechSpecs vezérlő nevét az If függvényben a saját alkalmazásában lévő képernyővezérlő nevére, ha nem használja a Product Showcase alkalmazássablont.
Alkalmazás mentése és közzététele.
Nyisson meg egy új böngészőt.
Illessze be az alkalmazás webhivatkozását a böngészőbe, és fűzze a végéhez a &screen=techspecs kifejezést.
Az alkalmazás közvetlenül elindul a TechSpecs kezdőképernyővel .

Kapcsolódó információk

Vászonalapú alkalmazás képleteinek referenciája

Visszacsatolás

Hasznos volt ez az oldal?

Last updated on 2025-10-10

Megosztás:

Launch és Param függvények

Launch

Cím

Paraméterek

Target

Param

Szintaxis

Fenntartott paraméterek

Példák

Egyszerű Launch

Vászonalapú alkalmazásból weboldalra:

Vászonalapú alkalmazásból vászonalapú alkalmazásba

Weboldalól vászonalapú alkalmazásba

Egyszerű Param

Példák lépésről lépésre a következőhöz Launch : Param

Példa- Launch

Példa- Param

Kapcsolódó információk

Visszacsatolás

További források