Funkce Launch a Param v Power Apps

Článek
07/06/2022
7 min ke čtení

Spouští webovou stránku nebo aplikaci plátna a poskytuje přístup ke spouštěcím parametrům.

Launch

Spustí webovou stránku nebo aplikaci plátna. Funkce podporuje:

Adresa (povinné), adresa URL webové stránky nebo ID aplikace aplikace plátna.
Parametry (volitelné), pojmenované hodnoty pro předání webové stránce nebo aplikaci plátna. V aplikaci plátna lze parametry číst pomocí funkce Param.
Cíl (volitelné), karta prohlížeče, na které se spustí webová stránka nebo aplikace plátna.

Funkce Launch se dá použít jenom ve vzorcích chování.

Adresa

Webové stránky jsou spouštěny prostřednictvím adresy URL. Příklad:

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

Aplikace plátna můžete spouštět pomocí webového odkazu nebo ID aplikace. Vyhledání těchto hodnot pro aplikaci:

Přejděte na Power Apps.
V levém navigačním podokně vyberte položku Aplikace.
Vyberte aplikaci.
Vyberte Podrobnosti z horní nabídky.
Můžete také vybrat ... (Další příkazy) pro aplikaci a poté vyberte Podrobnosti z rozevírací nabídky.
Zkopírujte webový odkaz nebo ID aplikace.

Webový odkaz lze použít na jakékoli webové stránce a spustí aplikaci plátna. Lze jej také použít s funkcí Launch.

ID aplikace lze použít s funkcí Launch, ale musí se použít předpona /providers/Microsoft.PowerApps/apps/. Příklad:

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

Nativní aplikace v zařízení nelze spustit přímo. Na některých platformách mohou být k dispozici nepřímé možnosti, například nativní aplikace, která instaluje vlastní schéma URL nebo se registruje pomocí webového prohlížeče a nabízí možnost konkrétním webům.

Parametry

Funkce Launch může předat parametry webové stránce nebo aplikaci plátna. Parametry lze zadat dvěma způsoby:

Seznam argumentů s dvojicemi název/hodnota. Příklad:

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

Záznam hodnot polí. Příklad:
```
Launch( "http://bing.com/search", { q: "Power Apps", count: 1 } )
```
S tímto formulářem může být snazší pracovat, protože lépe znázorňuje asociace mezi názvem a hodnotou. Je to jediný formulář, který podporuje volitelný argument LaunchTarget.

Adresa a parametry jsou kódovány jako URL před jejich předáním, kdy jsou určité nealfanumerické znaky nahrazeny znakem % a hexadecimálním číslem, jako by u nich byla použita funkce EncodeUrl.

Při spuštění webové stránky lze na konec adresy URL připojit řetězec dotazu s parametry. Jakékoli další parametry zadané do funkce Launch jsou přidány na konec řetězce dotazu. Řetězce dotazů při spuštění aplikace plátna nefungují.

Cíl

Použijte argument LaunchTarget pro určení cílového okna prohlížeče, ve kterém se má webová stránka nebo aplikace otevřít. Použijte jednu z následujících hodnot výčtu LaunchTarget nebo zadejte vlastní název okna.

Výčet LaunchTarget	Popis
New	Webová stránka nebo aplikace se otevře v novém okně nebo na nové kartě.
Replace	Webová stránka nebo aplikace nahradí aktuální okno nebo kartu.
name	Místo hodnoty výčtu použijte vlastní textový řetězec jako název okna nebo karty. Self je pouze interní název, který používá pouze funkce Launch. Nemá to žádný dopad ani neodpovídá názvu okna, které uživatelé uvidí. Pokud okno nebo karta se zadaným názvem již existuje, jeho obsah bude nahrazen. Jinak se vytvoří nové okno nebo karta. Název nesmí začínat znakem podtržítka „_“.

New je výchozí výčet při spuštění ve webovém prohlížeči s Replace a název jako dostupnými možnostmi. V mobilním přehrávači New je výchozí pro webové stránky s název jako dostupnou možností, zatímco aktuální aplikace plátna bude vždy nahrazena jinou aplikací plátna.

Poznámka

Používání LaunchTarget s jinou hodnotou než New ve vložených scénářích (například Power BI nebo SharePoint) není podporováno a může mít za následek neočekávané chování. V budoucnu se toto chování může změnit nebo může způsobit chybu.

Param

Funkce Param načte parametr předaný aplikaci při jejím spuštění. Pokud uvedený parametr nebyl předán, funkce Param vrátí prázdnou hodnotu.

Při spouštění aplikace plátna z jiné aplikace plátna použijte argumenty Parametr ve funkci Launch. Názvy parametrů a hodnoty budou automaticky kódovány pomocí URL.
Při spouštění aplikace plátna z webové stránky přidejte parametry do řetězce dotazu webového odkazu aplikace plátna. To zahrnuje přidání &parametername=parametervalue za předpokladu, že řetězec dotazů již byl spuštěn pro tenantId. Například přidáním &First%20Name=Vicki&category=3 budou předány dva parametry: First Name s hodnotou "Vicki" a category s hodnotou "3" (typ hodnoty je text). Název a hodnota parametru musí být kódována pomocí URL, pokud obsahují mezery nebo speciální znaky, podobně jako při použití funkce EncodeURL.
U názvů funkce Param se rozlišují velká a malá písmena.
Názvy a hodnoty parametrů budou automaticky dekódovány pomocí URL pro použití ve vaší aplikaci.
I když parametr obsahuje číslo, typ vrácený funkcí Param bude vždy textový řetězec. K převodu na jiné typy dojde automaticky nebo se použijí explicitní konverze, jako je funkce Value pro explicitní převedení na číslo.

Syntaxe

Launch( Adresa [, NázevParametru1, HodnotaParametru1, ... ] )

Adresa – povinný argument. Adresa webové stránky nebo ID aplikace, která se má spustit.
NázvyParametrů – volitelné. Název parametru.
HodnotyParametrů – volitelné. Odpovídající hodnoty parametrů, které se mají předat aplikaci nebo webové stránce.

Launch( Adresa, { [ NázevParametru1: HodnotaParametru1, ... ] } [, LaunchTarget ] )

Adresa – povinný argument. Adresa webové stránky nebo ID aplikace, která se má spustit.
NázvyParametrů – volitelné. Název parametru.
HodnotyParametrů – volitelné. Odpovídající hodnoty parametrů, které se mají předat aplikaci nebo webové stránce.
LaunchTarget – volitelné. Hodnota výčtu LaunchTarget nebo vlastní název.

Param( NázevParametru )

NázevParametru – povinný argument. Název parametru předaného aplikaci.

Vyhrazené parametry

Následující klíčová slova jsou vyhrazena pro interní použití a neměla by se používat jako vlastní parametr ve funkci Param():

amp%3Bauthmode

amp%3Benableonbehalfof

amp%3Bhidenavbar

amp%3Blocale

appmetadataversion

authmode

channeltype

correlationid

delegatelaunchurl

disablepreviewredirect

embedderorigin

enableonbehalfof

groupid

hideappsplash

hidenavbar

hint

hostclienttype

hostmode

iframecontainerid

isfullscreen

ispreviewmode

národní prostředí

packageproperties

screencolor

sdkversion

Web služby

skipappmetadata

skipiframecreation

skiplaunchappcache

zdroj

standaloneconsent

teamid

teamtype

tenantId

motiv

userteamrole

Příklady

Jednoduché spuštění

Z aplikace plátna na webovou stránku:

Vzorec	Popis
Launch( "http://bing.com/search", "q", "Power Apps", "count", 1 )	Otevře se webová stránka http://bing.com/search?q=Power%20Apps&count=1. Otevře se nové okno nebo karta.
Launch( "http://bing.com/search", { q: "Power Apps", count: 1 } )	Stejně jako v předchozích příkladech používajících ekvivalentní zápis záznamu. Otevře se nové okno nebo karta.
Launch( "http://bing.com/search", { q: "Power Apps", count: 1 }, LaunchTarget.Replace )	Stejně jako v předchozích příkladech nahradí aktuální okno nebo kartu výsledkem, pokud běží ve webovém prohlížeči.
Launch( "http://bing.com/search", { q: "Power Apps", count: 1 }, "Výsledky vyhledávání" )	Stejně jako v předchozím příkladu vytvoří nebo nahradí obsah karty nebo okna s názvem Výsledky vyhledávání.

Z aplikace plátna do aplikace plátna

Podle potřeby aktualizujte ID aplikace, název obrazovky a číslo záznamu.

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

Z webové aplikace do aplikace plátna

Podle potřeby aktualizujte ID aplikace, ID klienta, název obrazovky a číslo záznamu.

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

Jednoduché příklady funkce Param

Jednoduché příklady spuštění aplikace plátna z webové stránky nebo z jiné aplikace plátna znázorňují jednoduché příklady funkce Param:

Vzorec	Popis	Výsledek
Param( "Navigace" )	Parametr Navigace byl zadán při spuštění aplikace a je vrácen.	"Druhá obrazovka"
Param( "Záznam" )	Parametr Záznam byl zadán při spuštění aplikace. I když byl předán jako číslo do funkce Launch, výsledek funkce Param bude textový řetězec, který lze implicitně nebo explicitně převést na jiné typy.	"34"
Param( "Uživatel" )	Parametr Uživatel nebyl poskytnut. Je vrácena prázdná hodnota, kterou lze testovat pomocí funkce IsBlank.	prázdná hodnota

Příklady krok za krokem pro funkce Launch a Param

Šablona rozložení tabletu Product Showcase byla použita v následujících příkladech. Chcete-li vytvořit aplikaci s touto šablonou, postupujte podle kroků v článku o vytvoření aplikace a vyberte šablonu Product Showcase. Můžete také použít vlastní aplikaci.

Příklad – Launch

Přejděte na Power Apps.
V levém navigačním podokně vyberte položku Aplikace.
Vyberte vaši aplikaci a potom vyberte položku Upravit.
Z nabídky vyberte možnost Vložit a vyberte položku Popisek.
Přesuňte popisek do pravé dolní části obrazovky.
V podokně vlastností na pravé straně vyberte Barva jako bílá a nastavte Tloušťka ohraničení na 1.
Vyberte Text z pravé strany a zadejte text jako Novinky ze světa tabletů Surface.
V seznamu vlastností vlevo nahoře vyberte OnSelect.
Zadejte vzorec jako Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). Můžete také použít jakoukoli jinou adresu URL, parametr a klíčová slova dle svého výběru.
Uložte a publikujte aplikaci.
Přehrajte aplikaci.
Výběrem popisku Novinky ze světa tabletů Surface zahajte vyhledávání novinek pomocí klíčových slov Tablety Microsoft Surface.

Tip

Pro škálovatelnost můžete ručně zadaná klíčová slova ve funkci Launch nahradit proměnnými.

Příklad – Param

Přejděte na Power Apps.
V levém navigačním podokně vyberte položku Aplikace.
Vyberte vaši aplikaci a potom vyberte položku Upravit.
Z nabídky vyberte možnost Vložit a vyberte položku Popisek.
Přesuňte popisek do pravé dolní části obrazovky.
Vyberte vlastnost Text pro popisek vlevo nahoře.
Zadejte vzorec jako Param("browser"). Můžete také použít jiný parametr podle vašeho výběru.
Uložte a publikujte aplikaci.
Zkopírujte webový odkaz pro vaši aplikaci z Power Apps.
Otevřete nový prohlížeč.
Vložte webový odkaz aplikace prohlížeče a na konec připojte &browser=Microsoft%20Edge.
Po spuštění aplikace se na popisku zobrazí předaná hodnota parametru.
Zavřete přehrávač aplikací a upravte aplikaci.
Vyberte Aplikace ze stromového zobrazení v levé navigaci.
Vyberte vlastnost OnStart vlevo nahoře.
Zadejte vzorec jako If(Param("screen")="techspecs",Navigate(TechSpecs,Fade)).

Funkce If ve vlastnosti OnStart zkontroluje, zda se parametr rovná určité hodnotě, v tomto případě hodnotě techspecs. A pokud se shoduje, aplikace přejde na obrazovku TechSpecs.

Poznámka

Nahraďte zobrazovaný název TechSpecs ve funkci Navigate názvem obrazovky ve vaší vlastní aplikaci, pokud nepoužíváte šablonu aplikace Product Showcase.
Uložte a publikujte aplikaci.
Otevřete nový prohlížeč.
Vložte webový odkaz aplikace prohlížeče a na konec připojte &screen=techspecs.
Aplikace se spouští přímo s TechSpecs nebo obrazovkou zadanou ve funkci Navigate.