Funkce Launch a Param

Článek
03/22/2024

Platí pro: aplikace plátna

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 identifikátor URI aplikace (ID aplikace s předponou /providers/Microsoft.PowerApps/apps/) 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 Identifikátoru URI aplikace (ID aplikace s předponou /providers/Microsoft.PowerApps/apps/). Vyhledání těchto hodnot pro aplikaci:

Umožňuje přejít 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( "https://bing.com/search", "q", "Power Apps", "count", 1 )

Záznam hodnot polí. Příklad:
```
Launch( "https://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í.

Při spouštění aplikace na mobilním zařízení, kde je tato aplikace již spuštěna, se parametry ve spuštěné aplikaci neobnoví. Pro obnovení parametrů je vyžadováno opětovné načtení aplikace.

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. name 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.
Hodnoty parametrů se nezmění, dokud aplikaci znovu nenačtete. Použití Spustit na mobilním zařízení, kde je aplikace již spuštěna, neaktualizuje parametry.
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.

Poznámka:

Pro vlastní stránky jsou jediné parametry, které stránka přijímá: recordId a entityName.

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í (nezávisle na pádu) a neměla by se používat jako vlastní parametr ve funkci Param():

amp%3Bauthmode
amp%3Benableonbehalfof
amp%3Bhidenavbar
amp%3Blocale
appmetadataversion
authmode
channeltype
cordovapath
correlationid
ladění
delegatelaunchurl
delegatelaunchurl
disablepreviewredirect
embedderorigin
enableonbehalfof
groupid
hideappsplash
hidenavbar
hint
hostclienttype
hostmode
iframecontainerid
isfullscreen
ispreviewmode
loader
loaderType
locale
location
packagekind
packageproperties
playerresourcespath
playersessionid
powerappslanguage
screencolor
sdkversion
web
skipappmetadata
skipiframecreation
skiplaunchappcache
zdroj
sourcetime
standaloneconsent
teamid
teamtype
tenantId
motiv
uselocalpackagehostresources
userteamrole

Příklady

Jednoduché spuštění

Z aplikace plátna na webovou stránku:

Vzorec	Description
Launch( "http://bing.com/search", "q", "Power Apps", "count", 1 )	Otevře se webová stránka https://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 }, "Search Results" )	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/e/YOUR-APP-ENVIRONMENT-ID/a/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( "Navigate" )	Parametr Navigace byl zadán při spuštění aplikace a je vrácen.	"Druhá obrazovka"
Param( "Record" )	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( "User" )	Parametr Uživatel nebyl poskytnut. Je vrácena prázdná hodnota, kterou lze testovat pomocí funkce IsBlank.	prázdný

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

Umožňuje přejít 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.

Zpropitné

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

Příklad – Param

Umožňuje přejít 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 StartScreen vlevo nahoře.
Zadejte vzorec jako If( Param("screen") = "techspecs", TechSpecs ).

Funkce If ve vlastnosti StartScreen zkontroluje, zda se parametr rovná určité hodnotě, v tomto případě hodnotě techspecs. A pokud se shoduje, vrátí ovládací prvek obrazovky TechSpecs do vlastnosti StartScreen.

Poznámka:

Nahraďte název ovládacího prvku TechSpecs ve funkci If názvem ovládacího prvku 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 pomocí TechSpecs jako úvodní obrazovka.