Indítási és Param funkciók

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:

• Cím (kötelező), a vászonalapú alkalmazás weboldalának URL-címe vagy alkalmazás URI-ja (előtaggal ellátott /providers/Microsoft.PowerApps/apps/ alkalmazásazonosító).
• Paraméterek (nem kötelező), a nevezett értékek, amelyek átadhatók a weblapnak vagy a vászonalapú alkalmazásnak. A vászonalapú alkalmazásban a paraméterek a Param függvénnyel olvashatók.
• Cél (nem kötelező), a böngészőlap, amelyen elindítja a weblapot vagy a vászonalapú alkalmazást.

A Launch függvény csak műveleti képletekben használható.

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, előtaggal ) /providers/Microsoft.PowerApps/apps/ indíthatja el. Az alkalmazások értékeinek megkeresése:

1. Ugrás: Power Apps.

2. Válassza a bal navigációs ablaktáblán az Alkalmazások elemet.

3. Válassza ki az alkalmazását

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

   

5. Másolja a Webhivatkozást vagy az Alkalmazásazonosítót.

   

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

Az Alkalmazásazonosító használható a Launch függvénnyel, de /providers/Microsoft.PowerApps/apps/ előtaggal kell rendelkeznie. Például:

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

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

A Launch átadhatja a paramétereket a weblapnak vagy a vászonalapú alkalmazá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 Launch függvényhez magadott további paraméterek a lekérdezési karakterlánc végéhez kerülnek. 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.

A webes böngészőben történő futtatáskor a New az alapértelmezett felsorolás, ahol a Replace és a name választható lehetőségként használható. 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.

Param

A Param függvény egy olyan paramétert kérdez le, amely az alkalmazás indításakor lett átadva az alkalmazásnak. Ha az elnevezett paraméter nem lett átadva, a Paramüres értéket ad vissza.

• Ha egy vászonalapú alkalmazást egy másik vászonalapú alkalmazásból indít el, akkor a Paraméter argumentumait használja 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.
• A Param nevekben meg vannak különböztetve a kis- és nagybetűk.
• A Param nevek és értékek automatikusan URL-dekódolva lesznek az alkalmazásban való használathoz.
• A paraméterértékek csak akkor változnak, ha az alkalmazást újra betöltik. Az Indítás használata olyan mobileszközön, amelyen az alkalmazás már fut, nem frissíti a paramétereket.
• Ha a paraméter tartalmaz egy számot, a Param által visszaadott típus akkor is mindig szöveges karakterlánc 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.

Szintaxis

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

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

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

• Address – Kötelező. A betöltendő weblap címe vagy az elindítandó alkalmazás azonosítója.
• ParameterName(s) – Nem kötelező. Paraméter neve.
• ParameterValue(s) – 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

Az alábbi kulcsszavak belső használatra vannak lefoglalva (az esettől függetlenül), és nem szabad egyéni paraméterként használni 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
• locale
• hely
• packagekind
• packageproperties
• playerresourcespath
• playersessionid
• powerappslanguage
• screencolor
• sdkversion
• hely
• skipappmetadata
• skipiframecreation
• skiplaunchappcache
• source
• Forrásidő
• standaloneconsent
• teamid
• teamtype
• tenantId
• téma
• uselocalpackagehostresources
• userteamrole

Példák

Egyszerű indítás

Vászonalapú alkalmazásból weboldalra:

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

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

Részletes példák a Launch és Param függvényekre

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

1. Ugrás: Power Apps.

2. Válassza a bal navigációs ablaktáblán az Alkalmazások elemet.

3. Válassza ki az alkalmazását, és válassza a Szerkesztés lehetőséget.

4. Válassza ki a Beszúrás lehetőséget a menüből, majd válassza a Címke lehetőséget.

5. Mozgassa a címkét a képernyő jobb alsó sarkába.

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

7. Válassza ki a Szöveg tulajdonságot a jobb oldalon, és írja be a szöveget: Surface táblagépek a hírekben.

8. A bal felső sarokban tulajdonságlistában az OnSelect lehetőséget.

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

   

10. Alkalmazás mentése és közzététele.

11. Az alkalmazás indítása.

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

Példa – Param

1. Ugrás: Power Apps.

2. Válassza a bal navigációs ablaktáblán az Alkalmazások elemet.

3. Válassza ki az alkalmazását, és válassza a Szerkesztés lehetőséget.

4. Válassza ki a Beszúrás lehetőséget a menüből, majd válassza a Címke lehetőséget.

5. Mozgassa a címkét a képernyő jobb alsó sarkába.

6. Jelöljön ki egy Szöveg tulajdonságot a címkéhez bal felső részen.

7. Adja meg a képletet a következőként: Param("browser"). Másik választott paramétert is használhat.

   

8. Alkalmazás mentése és közzététele.

9. Másolja a webhivatkozást az alkalmazáshoz a Power Apps-szolgáltatáshoz.

10. Nyisson meg egy új böngészőt.

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

    

12. Amikor az alkalmazás elindul, a címke mutatja az átadott paraméterértértéket.

    

13. Zárja be az alkalmazáslejátszót, és szerkessze az alkalmazást.

14. Válassza az Alkalmazás lehetőséget a Fanézetből a bal oldali navigációs felületen.

15. Válassza a StartScreen tulajdonságot a bal felső sarokban.

16. 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 atechnikai specifikációkkal. Ha pedig egyezik, visszaadja a TechSpecs képernyővezérlőt aStartScreen 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 aProduct Showcase alkalmazássablont.

17. Alkalmazás mentése és közzététele.

18. Nyisson meg egy új böngészőt.

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

    

20. Az alkalmazás közvetlenül elindul a TechSpecs kezdőképernyővel .

Kapcsolódó információk

Vászonalapú alkalmazás képletreferencia