De functies Launch en Param

Artikel
03/22/2024

Van toepassing op: Canvas-apps

Met deze functies start u een webpagina of canvas-app en krijgt u toegang tot startparameters.

Launch

Hiermee start u een webpagina of een canvas-app. De functie ondersteunt:

Adres (vereist), de URL van de webpagina of app-URI (app-id voorafgegaan door /providers/Microsoft.PowerApps/apps/) van de canvas-app.
Parameters (optioneel), benoemde waarden om door te geven aan de webpagina of canvas-app. In een canvas-app kunnen parameters worden gelezen met de functie Param.
Doel (optioneel), het browsertabblad waarin de webpagina of canvas-app moet worden gestart.

Launch kan alleen worden gebruikt in gedragsformules.

Adres

Webpagina's worden gestart via een URL-adres. Bijvoorbeeld:

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

U kunt canvas-apps starten met een webkoppeling of app-URI (app-id voorafgegaan door /providers/Microsoft.PowerApps/apps/). U kunt deze waarden voor een app als volgt vinden:

Ga naar Power Apps.
Selecteer Apps in het linkernavigatiedeelvenster.
Selecteer uw app.
Selecteer Details in het hoofdmenu.
U kunt ook ... (Meer opdrachten) selecteren en vervolgens Details selecteren in het vervolgkeuzemenu.
Kopieer de webkoppeling of app-id.

De webkoppeling kan op elke webpagina worden gebruikt en hiermee wordt de canvas-app gestart. De webkoppeling kan ook worden gebruikt in combinatie met de functie Launch.

De app-id kan worden gebruikt in combinatie met de functie Launch, maar dan moet hiervoor het voorvoegsel /providers/Microsoft.PowerApps/apps/ worden geplaatst. Bijvoorbeeld:

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

Systeemeigen apps op een apparaat kunnen niet rechtstreeks worden gestart. Er zijn mogelijk opties voor indirect starten beschikbaar op sommige platforms, zoals een systeemeigen app die een aangepast URL-schema installeert of zich registreert bij de webbrowser om een optie te bieden voor specifieke websites.

Parameters

Launch kan parameters doorgeven aan de webpagina of canvas-app. Parameters kunnen op twee verschillende manieren worden aangeboden:

Een argumentenlijst van naam-waardeparen. Bijvoorbeeld:

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

Een record met veldwaarden. Bijvoorbeeld:
```
Launch( "https://bing.com/search", { q: "Power Apps", count: 1 } )
```
Deze vorm kan gemakkelijker zijn om mee te werken omdat deze de koppeling tussen naam en waarde duidelijker maakt. Het is de enige vorm die het optionele argument LaunchTarget ondersteunt.

Het adres en de parameters worden URL-gecodeerd voordat ze worden doorgegeven om bepaalde niet-alfanumerieke tekens te vervangen door % en een hexadecimaal getal alsof voor het adres en de parameters de functie EncodeUrl is gebruikt.

Bij het starten van een webpagina kan een querytekenreeks van parameters worden toegevoegd na het URL-adres. Eventuele aanvullende parameters die worden opgegeven voor Launch, wordt toegevoegd aan het einde van de querytekenreeks. Querytekenreeksen werken niet bij het starten van een canvas-app.

Wanneer u een app start op een mobiel apparaat waarop die app al actief is, worden de parameters in de actieve app niet vernieuwd. Het opnieuw laden van de app is vereist om de parameters te vernieuwen.

Target

Gebruik het argument LaunchTarget om het doelbrowservenster op te geven waarin de webpagina of app moet worden geopend. Gebruik een van de volgende vaste-tekstwaarden voor LaunchTarget of geef een aangepaste vensternaam op.

LaunchTarget-opsomming	Beschrijving
New	De webpagina of app wordt geopend in een nieuw venster of tabblad.
Replace	De webpagina of app vervangt het huidige venster of tabblad.
name	Gebruik in plaats van de vaste-tekstwaarde uw eigen teksttekenreeks om het venster of tabblad een naam te geven. Self is een interne enige naam die alleen wordt gebruikt door de functie Launch. De naam die u opgeeft, komt niet overeen met de venstertitel die uw gebruikers te zien krijgen en heeft hier ook geen invloed op. Als er al een venster of tabblad met de opgegeven naam bestaat, wordt de inhoud vervangen. Als dat niet zo is, wordt er een nieuw venster of tabblad gemaakt. naam mag niet beginnen met het onderstrepingsteken "‑".

New is de standaardopsomming bij gebruik in een webbrowser met Replace en name als beschikbare opties. In een mobiele speler is Nieuw de standaardwaarde voor webpagina's met naam als een beschikbare optie; terwijl de huidige canvas-app altijd wordt vervangen door een andere canvas-app.

Notitie

Gebruik van een LaunchTarget met een andere waarde dan Nieuw in ingebedde scenario's (bijvoorbeeld Power BI of SharePoint) wordt niet ondersteund en kan leiden tot onverwacht gedrag. In de toekomst kan dit gedrag veranderen of een fout veroorzaken.

Param

De functie Param haalt een parameter op die aan de app is doorgegeven toen deze werd gestart. Als de benoemde parameter niet is doorgegeven, retourneert Param een lege waarde.

Start u een canvas-app vanuit een andere canvas-app, gebruik dan de parameterargumenten voor de functie Launch. Parameternamen en -waarden worden automatisch URL-gecodeerd.
Start u een canvas-app vanaf een webpagina, voeg dan parameters toe aan de querytekenreeks van de webkoppeling van de canvas-app. Dit omvat het toevoegen van &parametername=parametervalue, ervan uitgaande dat de querytekenreeks al is gestart voor de tenantId. Als u bijvoorbeeld &First%20Name=Vicki&category=3 toevoegt, worden er twee parameters doorgeven: First Name met de waarde "Vicki" en category met de waarde "3" (waardetype is tekst). De parameternaam en -waarde moeten URL-gecodeerd worden als ze spaties of speciale tekens bevatten, wat vergelijkbaar is met het gebruik van de functie EncodeURL.
Parameternamen zijn hoofdlettergevoelig.
Parameternamen en -waarden worden automatisch URL-gedecodeerd voor gebruik in uw app.
Parameterwaarden veranderen niet tenzij de app opnieuw wordt geladen. Als u Start gebruikt op een mobiel apparaat waarop de app al actief is, worden de parameters niet vernieuwd.
Zelfs als de parameter een getal bevat, is het type dat wordt geretourneerd door Param, altijd een teksttekenreeks. Conversie naar andere typen vindt automatisch plaats, maar er kunnen ook expliciete conversies worden gebruikt, zoals de functie Value waarmee een type expliciet kan worden geconverteerd naar een getal.

Notitie

Voor aangepaste pagina's zijn de enige parameters die door de pagina worden geaccepteerd: recordId en EntityName.

Syntaxis

Launch( Adres [, Parameternaam1, Parameterwaarde1, ... ] )

Address: vereist. Het adres van een webpagina of de id van een app die moet worden geopend.
ParameterName(s): optioneel. Parameternaam.
ParameterValue(s): optioneel. Corresponderende parameterwaarden om aan de app of webpagina door te geven.

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

Address: vereist. Het adres van een webpagina of de id van een app die moet worden geopend.
ParameterName(s): optioneel. Parameternaam.
ParameterValue(s): optioneel. Corresponderende parameterwaarden om aan de app of webpagina door te geven.
LaunchTarget: optioneel. Geef als LaunchTarget een vaste-tekstwaarde of aangepaste naam op.

Param( Parameternaam )

ParameterName: vereist. De naam van de parameter die aan de app is doorgegeven.

Gereserveerde parameters

De volgende trefwoorden (ongeacht hoofdlettergebruik) zijn gereserveerd voor intern gebruik en mogen niet worden gebruikt als een aangepaste parameter in de functie Param():

amp%3Bauthmode
amp%3Benableonbehalfof
amp%3Bhidenavbar
amp%3Blocale
appmetadataversion
authmode
channeltype
cordovapath
correlationid
foutopsporing
delegatelaunchurl
delegatelaunchurl
disablepreviewredirect
embedderorigin
enableonbehalfof
groupid
hideappsplash
hidenavbar
hint
hostclienttype
hostmode
iframecontainerid
isfullscreen
ispreviewmode
loader
loaderType
locale
locatie
packagekind
packageproperties
playerresourcespath
playersessionid
powerappslanguage
screencolor
sdkversion
site
skipappmetadata
skipiframecreation
skiplaunchappcache
source
sourcetime
standaloneconsent
teamid
teamtype
tenantId
theme
uselocalpackagehostresources
userteamrole

Voorbeelden

Eenvoudige Launch

Vanuit een canvas-app naar een webpagina:

Formule	Omschrijving
Launch( "http://bing.com/search", "q", "Power Apps", "count", 1 )	Hiermee wordt de webpagina https://bing.com/search?q=Power%20Apps&count=1 geopend. Er wordt een nieuw venster of tabblad geopend.
Launch( "http://bing.com/search", { q: "Power Apps", count: 1 } )	Hetzelfde als in de vorige voorbeelden met de gelijkwaardige recordnotatie. Er wordt een nieuw venster of tabblad geopend.
Launch( "http://bing.com/search", { q: "Power Apps", count: 1 }, LaunchTarget.Replace )	Hetzelfde als de vorige voorbeelden, waarbij het huidige venster of tabblad wordt vervangen door het resultaat bij uitvoering in een webbrowser.
Launch( "http://bing.com/search", { q: "Power Apps", count: 1 }, "Search Results" )	Hetzelfde als het vorige voorbeeld, waarbij de inhoud van het venster of tabblad met de naam Zoekresultaten wordt gemaakt of vervangen.

Vanuit een canvas-app naar een canvas-app:

Werk indien nodig de app-id, de schermnaam en het recordnummer bij.

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

Vanaf een webpagina naar een canvas-app:

Werk indien nodig de app-id, de schermnaam en het recordnummer bij.

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

Eenvoudige Param

In de voorbeelden van het eenvoudig starten met de functie Launch van een canvas-app vanaf een webpagina of vanuit een andere canvas-app vindt u eenvoudige voorbeelden van de functie Param:

Formule	Beschrijving	Resultaat
Param( "Navigate" )	De parameter Navigate is opgegeven bij het starten van de app en wordt geretourneerd.	"Second Screen"
Param( "Record" )	De parameter Record is opgegeven bij het starten van de app. Ook al werd deze parameter als een nummer doorgegeven aan de functie Launch, het resultaat van Param zal een teksttekenreeks zijn die impliciet of expliciet kan worden geconverteerd naar andere typen.	"34"
Param( "User" )	De parameter User is niet opgegeven. Er is lege waarde geretourneerd die kan worden getest met de functie IsBlank.	leeg

Stapsgewijze voorbeelden voor Launch en Param

De indelingssjabloon voor tablets Product Showcase is gebruikt voor de volgende voorbeelden. Als u een app wilt maken met deze sjabloon, volgt u de stappen uit het artikel een app maken en selecteert u de sjabloon Product Showcase. U kunt ook uw eigen app gebruiken.

Voorbeeld - Launch

Ga naar Power Apps.
Selecteer Apps in het linkernavigatiedeelvenster.
Selecteer uw app en selecteer vervolgens Edit.
Selecteer Insert in het menu en selecteer Label.
Verplaats het label naar de rechterbenedenhoek van het scherm.
Selecteer in het eigenschappenvenster aan de rechterzijde Kleur in op wit en stel Randdikte in op 1.
Selecteer de eigenschap Text aan de rechterzijde en voer tekst in, zoals Surface-tablets in het nieuws.
Selecteer in de eigenschappenlijst linksboven de optie OnSelect.
Voer een formule in, zoals Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). U kunt ook elke gewenste andere URL en parameter gebruiken en andere trefwoorden invoeren.
Sla de app op en publiceer deze.
Speel de app af.
Selecteer het label Surface-tablets in het nieuws om de nieuwszoekopdracht te starten met de trefwoorden Microsoft Surface-tablets.

Fooi

Voor schaalbaarheid kunt u de handmatig ingevoerde trefwoorden in de functie Launch vervangen door variabelen.

Voorbeeld - Param

Ga naar Power Apps.
Selecteer Apps in het linkernavigatiedeelvenster.
Selecteer uw app en selecteer vervolgens Edit.
Selecteer Insert in het menu en selecteer Label.
Verplaats het label naar de rechterbenedenhoek van het scherm.
Selecteer linksboven de eigenschap Text voor het label.
Voer een formule in, zoals Param("browser"). U kunt ook elke gewenste andere parameter gebruiken.
Sla de app op en publiceer deze.
Kopieer de webkoppeling voor uw app vanuit Power Apps.
Open een nieuwe browser.
Plak de webkoppeling van de app in de browser en voeg &browser=Microsoft%20Edge toe aan het eind.
Wanneer uw app wordt gestart, wordt op het label de parameterwaarde weergegeven die is doorgegeven.
Sluit de app-speler en bewerk de app.
Selecteer App in de structuurweergave in het linkernavigatiedeelvenster.
Selecteer de eigenschap StartScreen linksboven.
Voer de formule in als If( Param("screen") = "techspecs", TechSpecs ).

De functie If in de eigenschap StartScreen controleert of de parameter gelijk is aan een bepaalde waarde, in dit geval de waarde techspecs. En als deze overeenkomt, wordt het besturingselement van het scherm TechSpecs weer ingesteld op de eigenschap StartScreen.

Notitie

Vervang de naam TechSpecs in de functie If door de naam van een schermbesturingselement in uw eigen app als u de app-sjabloon Product Showcase niet gebruikt.
Sla de app op en publiceer deze.
Open een nieuwe browser.
Plak de webkoppeling van de app in de browser en voeg &screen=techspecs toe aan het eind.
De app start direct met TechSpecs als het startscherm.