Funktionerna Launch och Param

Gäller: 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-adressen till webbsidan eller app-URI (app-ID med prefixet /providers/Microsoft.PowerApps/apps/) för arbetsyteappen.
  • Parametrar (valfritt), namngivna värden som skickas till webbsida eller arbetsyteapp. I en arbetsyteapp kan parametrar läsas med funktionen Param.
  • Mål (valfritt), den webbläsare som används för att starta programmet för webbsidan eller arbetsyteapp.

Launch kan bara användas i beteendeformler.

Adress

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:

  1. Gå till Power Apps.

  2. Välj Program i det vänstra navigeringsfönstret.

  3. Välj programmet.

  4. Välj Detaljer i den övre menyn.
    Du kan också välja ... (Fler kommandon) och sedan Detaljer från listrutan.

    Alternativ för appinformation.

  5. Kopiera webblänk eller App-ID.

    Appinformation med webblänk och app-ID.

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

Program-ID kan användas med funktionen Launch men måste föregås av /providers/Microsoft.PowerApps/apps/. Till exempel:

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

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 webbsida 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
New Webbsidan eller programmet öppnas i ett nytt fönster eller på en ny flik.
Replace 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. namn får inte börja med understrykningstecknet "_".

New är standarduppräkningen när du kör i en webbläsare med Replace och name 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ängenarbetsteappen 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( Address [, ParameterName1, ParameterValue1, ... ] )

  • Address – Krävs. Adressen till en webbsida eller ID:t för ett program som ska startas.
  • ParameterName(s) – Valfritt. Parameternamn.
  • ParameterValue(s) – Valfritt. Motsvarande parametervärden som ska överföras till programmet eller webbsidan.

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

  • Address – Krävs. Adressen till en webbsida eller ID:t för ett program som ska startas.
  • ParameterName(s) – Valfritt. Parameternamn.
  • ParameterValue(s) – 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 – Krävs. 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
Launch( "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.
Launch( "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.
Launch( "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.
Launch( "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( "Navigate" ) Parametern Navigera angavs när programmet startades och returnerades. "Andra skärmen"
Param( "Record" ) 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( "User" ) 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

  1. Gå till Power Apps.

  2. Välj Program i det vänstra navigeringsfönstret.

  3. Välj program och välj redigera.

  4. Välj Infoga från menyn och välj sedan Etikett.

  5. Flytta etiketten längst ned till höger på skärmen.

  6. Från fönstret Egenskaper till höger väljer du Färg som vit och anger Tjocklek på kantlinje till 1.

  7. Välj egenskapen Text från höger och ange text som Surface-surfplattor i nyheter.

  8. Från egenskapslistan till vänster överst väljer du OnSelect.

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

    Startexempel.

  10. Spara och publicera programmet.

  11. Kör programmet.

  12. Välj etikett Surface-surfplattor i nyheter för att starta sökning efter nyheter med nyckelord på Microsoft Surface-surfplattor.

Dricks

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

Exempel – Param

  1. Gå till Power Apps.

  2. Välj Program i det vänstra navigeringsfönstret.

  3. Välj program och välj redigera.

  4. Välj Infoga från menyn och välj sedan Etikett.

  5. Flytta etiketten längst ned till höger på skärmen.

  6. Välj egenskapen Text för etiketten från övre vänstra hörnet.

  7. Ange formeln som Param("browser"). Du kan också använda en annan parameter som du väljer.

    Parameterexempel.

  8. Spara och publicera programmet.

  9. Kopiera webblänk för appen från Power Apps.

  10. Öppna en ny webbläsare.

  11. Klistra in appwebblänken i webbläsaren och lägg till &browser=Microsoft%20Edge i slutet.

    Webbadress.

  12. När programmet startas visas det angivna parametervärdet i etiketten.

    Etiketten Parameterexempel.

  13. Stäng appspelaren och redigera programmet.

  14. Välj App i trädvyn i det vänstra navigeringsfönstret.

  15. Markera egenskapen StartScreen överst till vänster.

  16. Ange formeln som If( Param("screen") = "techspecs", TechSpecs ).

    Parameterexempel för navigering.

    If-funktionen i egenskapen StartScreen 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.

  17. Spara och publicera programmet.

  18. Öppna en ny webbläsare.

  19. Klistra in appwebblänken i webbläsaren och lägg till &screen=techspecs i slutet.

    Webbadress för TechSpecs-skärm.

  20. Appen lanseras direkt med TechSpecs som startskärm.

Se även

Formelreferens för arbetsyteapp