Funktionerna Launch och Param

Artikel
10/16/2024

Gäller för: Arbetsyteappar

Startar en webbsida eller en arbetysteapp och tillhandahåller åtkomst till parametrar för start.

Launch

Startar webbsida eller en arbetsyteapp. Funktionen stöder:

Adress (obligatoriskt), URL:en till webbsidan för arbetsyteappen.
Parametrar (valfritt), namngivna värden som ska skickas till webbsidan eller arbetsyteappen. I en arbetsyteapp kan parametrar läsas med funktionen Param.
Mål (valfritt), den webbläsarflik där webbsidan eller arbetsyteappen ska startas.

Launch kan endast användas i beteendeformler.

Obs

Om lanseringsformelen används för att öppna Power Apps och appen inte visas för slutanvändaren bör du kontrollera om appen blockeras av en popup-blockerare i webbläsaren eller om webbläsaren väntar på användarens svar i en dialogruta där du får frågan om användaren vill navigera till en ny skärm.

Address

Webbsidor startas via en URL-adress. Till exempel:

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

Du kan starta arbetsyteappar med webblänk eller app-URI (app-ID med prefixet /providers/Microsoft.PowerApps/apps/). Så här hittar du värdena för ett program:

Gå till Power Apps.
Välj Program i det vänstra navigeringsfönstret.
Välj programmet.
Välj Detaljer i den övre menyn.
Du kan också välja ... (Fler kommandon) och sedan Detaljer från listrutan.
Kopiera Webblänken.

Webblänken kan användas på alla webbsidor och då öppnas arbetsyteappen. Den kan också användas med funktionen Launch. Till exempel:

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

Det går inte att starta inbyggda program på en enhet direkt. Det kan finnas indirekta alternativ tillgängliga för vissa plattformar, t.ex. ett inbyggt program som installerar ett anpassat URL-schema eller registrering i webbläsaren för att erbjuda ett alternativ för specifika webbplatser.

Parameters

Launch kan skicka parametrar till webbsidan eller arbetsyteappen. Parametrar kan tillhandahållas på två sätt:

En argumentlista med namnvärdepar. Till exempel:

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

En post med fältvärden. Till exempel:
```
Launch( "https://bing.com/search", { q: "Power Apps", count: 1 } )
```
Det här formuläret kan vara lättare att arbeta med eftersom det innebär att associationen mellan namn och värde blir tydligare. Det är det enda formulär som stöder det valfria argumentet LaunchTarget.

Adressen och parametrarna är URL-kodade innan de skickas för att ersätta vissa icke-alfanumeriska tecken med % och ett hexadecimalt tal som om funktionen EncodeUrl har använts för varje.

När du startar en webbsida kan en frågesträng med parametrar inkluderas i slutet av URL-adressen. Eventuella ytterligare parametrar som ska startas läggs till i slutet av frågesträngen. Frågesträngar fungerar inte när du startar en arbetsyteapp.

När du startar en app på en mobil enhet där appen redan körs uppdateras inte parametrarna i den körande appen. Det krävs en uppdatering av appen för att parametrarna ska uppdateras.

Maål

Använd argumentet LaunchTarget för att ange det målwebbläsarfönster som webbsidan eller programmet ska öppnas i. Använd ett av följande uppräkningsvärden för LaunchTarget eller ange ett anpassat fönster namn.

LaunchTarget enum	Beskrivning
Ny	Webbsidan eller programmet öppnas i ett nytt fönster eller på en ny flik.
Ersätta	Webbsidan eller programmet ersätter nuvvarande fönster eller flik.
Namn	I stället för ett uppräkningsvärde använder du en egen textsträng för fönstret namn eller fliken. själv är ett internt namn som endast används av funktionen Launch. Den inte har någon inverkan på eller stämmer inte överens med namnet på fönstret som användarna ser. Om det redan finns ett fönster eller en flik med det angivna namnet ersätts dess innehåll. Annars skapas ett nytt fönster eller en ny flik. Namnet får inte börja med understreckstecknet "_".

Nytt är standarduppräkningen när du kör i en webbläsare med Ersätt och namn som tillgängliga alternativ. I en mobilspelare Ny är standard för webbsidor med namn som ett tillgängligt alternativ, medan den aktuella arbetsytan alltid ersätts av en annan arbetsyteapp.

Kommentar

Användning av en LaunchTarget med ett annat värde än Ny i inbäddade scenarier (t.ex. Power BI eller SharePoint) stöds inte och kan resultera i oväntat beteende. I framtiden kan problemet ändras eller orsaka ett fel.

Param

Funktionen Param hämtar en parameter som överfördes till programmet när den startades. Om den namngivna parametern inte överfördes returnerar Param ett blank värde.

När du startar en arbetsyteapp från en annan arbetsyteapp bör du använda argumenten Parameter till funktionen Launch. Parameternamn och -värden blir automatiskt URL-kodade.
När du startar en arbetsyteapp från en webbsida lägger du till parametrar i frågesträngen på arbetsteappen webblänk. Detta inbegriper att lägga till &parametername=parametervalue antagande om att frågesträngen redan har startats för tenantId. Om du till exempel lägger till &First%20Name=Vicki&category=3 skickas två parametrar: First Name med värdet "Vicki" och category med värdet "3" (värdetyp är text). Parameternamnet och värdet måste vara URL-kodat om de innehåller blanksteg eller specialtecken, ungefär som med hjälp av funktionen EncodeURL.
Param-namn är skiftlägeskänsliga.
Param-namn och -värden blir automatiskt URL-avkodade för användning i programmet.
Parametervärden ändras inte om inte appen läss in på nytt. Om Starta på en mobil enhet där appen redan körs uppdaterar inte parametrarna.
Även om parametern innehåller ett nummer är typen som returneras av Param alltid en textsträng. Konvertering till andra typer görs automatiskt eller använder explicita konverteringar som till exempel funktionen Value för att konvertera direkt till ett tal.

Kommentar

För anpassade sidor är de enda parametrar som accepteras av sidan: recordId och entityName.

Syntax

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

Adress – obligatoriskt. Adressen till en webbsida eller ID:t för ett program som ska startas.
ParameterNames – Valfritt. Parameternamn.
ParameterValues – Valfritt. Motsvarande parametervärden som ska överföras till programmet eller webbsidan.

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

Adress – obligatoriskt. Adressen till en webbsida eller ID:t för ett program som ska startas.
ParameterNames – Valfritt. Parameternamn.
ParameterValues – Valfritt. Motsvarande parametervärden som ska överföras till programmet eller webbsidan.
LaunchTarget – Valfritt. Ett uppräkningsvärde för LaunchTarget eller ett anpassat namn.

Param( ParameterName )

ParameterName – Obligatoriskt. Namnet på parametern som överförts till programmet.

Reserverade parametrar

Följande nyckelord är reserverade (oavsett ärende) för intern användning och ska inte användas som en anpassad parameter i Param()-funktionen:

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

Exempel

Enkel start

Från en arbetsyteapp till en webbsida:

Formel	Beskrivning
Starta( "http://bing.com/search", "q", "Power Apps", "count", 1 )	Öppnar webbsidan https://bing.com/search?q=Power%20Apps&count=1. Ett nytt fönster eller en ny flik öppnas.
Starta( "http://bing.com/search", { q: "Power Apps", count: 1 } )	Samma som i föregående exempel med motsvarande postformat. Ett nytt fönster eller en ny flik öppnas.
Starta( "http://bing.com/search", { q: "Power Apps", count: 1 }, LaunchTarget.Replace )	Samma som i föregående exempel och ersätter det aktuella fönstret eller fliken med resultatet om du kör i en webbläsare.
Starta( "http://bing.com/search", { q: "Power Apps", count: 1 }, "Search Results" )	Samma som i föregående exempel, genom att skapa eller ersätta innehållet i fönstret eller fliken med namnet Sökresultat.

Från en arbetsyteapp till en arbetsyteapp

Uppdatera program-ID, skärmnamn och postnummer efter behov.

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

Från en webbsida till en arbetsyteapp

Uppdatera program-ID, skärmnamn och postnummer efter behov.

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

Enkel param

Enkla startexempel ovan för att starta arbetsyteappar från webbsida eller från en annan arbetsyteapp visar enkla exempel för funktionen Param:

Formel	Beskrivning	Resultat
Param( "Navigera" )	Parametern Navigera angavs när programmet startades och returnerades.	"Andra skärmen"
Param( "Spela in" )	Parametern Post angavs när programmet startades. Även om det skickades som ett tal till funktionen Launch kommer resultatet från Param att vara en textsträng som implicit eller uttryckligen kan konverteras till andra typer.	"34"
Param( "Användare" )	Parametern Användare angavs inte. Ett tomt värde returneras som kan testas med funktionen IsBlank.	blank

Steg för steg-exempel för Launch och Param

Mallen för surfplattans layout Product Showcase användes för följande exempel. Skapa ett program med den här mallen genom att följa stegen i artikeln skapa ett program artikel och välj mallen Product Showcase. Du kan även använda din egen app.

Exempel – Launch

Gå till Power Apps.
Välj Program i det vänstra navigeringsfönstret.
Välj program och välj redigera.
Välj Infoga från menyn och välj sedan Etikett.
Flytta etiketten längst ned till höger på skärmen.
Från fönstret Egenskaper till höger väljer du Färg som vit och anger Tjocklek på kantlinje till 1.
Välj egenskapen Text från höger och ange text som Surface-surfplattor i nyheter.
Från egenskapslistan till vänster överst väljer du OnSelect.
Ange formeln som Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). Du kan också använda valfri annan URL, parameter och nyckelord.
Spara och publicera programmet.
Kör programmet.
Välj etikett Surface-surfplattor i nyheter för att starta nyhetssökning med nyckelord Microsoft Surface-surfplattor.

Tips!

För skalbarhet kan du ersätta de manuellt angivna nyckelorden i funktionen Launch med variabler.

Exempel – Param

Gå till Power Apps.
Välj Program i det vänstra navigeringsfönstret.
Välj program och välj redigera.
Välj Infoga från menyn och välj sedan Etikett.
Flytta etiketten längst ned till höger på skärmen.
Välj egenskapen Text för etiketten från övre vänstra hörnet.
Ange formeln som Param("browser"). Du kan också använda en annan parameter som du väljer.
Spara och publicera programmet.
Kopiera webblänk för appen från Power Apps.
Öppna en ny webbläsare.
Klistra in appwebblänken i webbläsaren och lägg till &browser=Microsoft%20Edge i slutet.
När programmet startas visas det angivna parametervärdet i etiketten.
Stäng appspelaren och redigera programmet.
Välj App i trädvyn i det vänstra navigeringsfönstret.
Markera egenskapen StartScreen överst till vänster.
Ange formeln som If( Param("screen") = "techspecs", TechSpecs ).

If-funktionen i StartScreen-egenskapen kontrollerar om parametern är lika med ett visst värde, i det här fallet värdet techspecs. Om den matchar returnerar skärmkontrollen TechSpecs till egenskapen StartScreen.

Kommentar

Ersätt kontrollnamnet TechSpecs i funktionen If med namnet på en skärmkontrollen i din egen app om du inte använder appmallen Produktvisning.
Spara och publicera programmet.
Öppna en ny webbläsare.
Klistra in appwebblänken i webbläsaren och lägg till &screen=techspecs i slutet.
Appen lanseras direkt med TechSpecs som startskärm.