Funktionerne Launch og Param

Gælder for: Lærredapps

Starter en webside eller en lærredapp og giver adgang til startparametre.

Launch

Starter en webside eller en lærredapp. Funktionen understøtter også:

  • Adresse (påkrævet), URL-adressen til websiden eller app-URI'et (app-id med præfikset /providers/Microsoft.PowerApps/apps/) for lærredappen.
  • Parameters (valgfrit), navngivne værdier, der skal overføres til websiden eller lærredappen. I en lærredapp kan parametre læses med funktionen Param.
  • Target (valgfrit), den fane i browseren, hvor websiden eller lærredappen skal startes.

Launch kan kun bruges i funktionsformler.

Adresse

Websider startes via en URL-adresse. Eksempel:

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

Du kan starte lærredapps med Weblink eller App-URI (app-id med præfikset /providers/Microsoft.PowerApps/apps/). Sådan finder du disse værdier for en app:

  1. Gå til Power Apps.

  2. Vælg Apps i venstre navigationsrude.

  3. Vælg din app.

  4. Vælg Detaljer i den øverste menu.
    Du kan også vælge ... (Flere kommandoer) og derefter Detaljer på rullemenuen.

    Indstillinger for appoplysninger.

  5. Kopiér weblink eller app-id.

    Appoplysninnger med weblink og app-id.

Weblink kan bruges på alle websider og vil starte lærredappen. Den kan også bruges sammen med funktionen Launch.

App-id'et kan bruges sammen med funktionen Launch, men skal have præfikset /providers/Microsoft.PowerApps/apps/. Eksempel:

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

Oprindelige apps på en enhed kan ikke startes direkte. Der kan være indirekte indstillinger tilgængelige på visse platforme, f.eks. en oprindelig app, når du installerer et brugerdefineret URL-adresseskema eller registrerer med webbrowseren for at give mulighed for at oprette en indstilling for bestemte websteder.

Parametre

Launchkan videresende parametre til websiden eller lærredappen. Parametre kan angives på to måder:

  • En argumentliste over navneværdipar. Eksempel:

    Launch( "https://bing.com/search", "q", "Power Apps", "count", 1 )
    
  • En post med feltværdier. Eksempel:

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

    Det kan være nemmere at arbejde med formularen, da tilknytningen mellem navn og værdi gøres tydeligere. Det er den eneste formular, der understøtter det valgfri argument LaunchTarget.

Adressen og parametrene er URL-adresser, der er kodet, før de overføres til erstatning af visse ikke-alfanumeriske tegn, %og et hexadecimalt tal, som om funktionen EncodeUrl er blevet brugt på hver.

Når en webside startes, kan der inkluderes en forespørgselsstreng med parametre i slutningen af URL-adressen. Eventuelle yderligere parametre, der angives til Launch, føjes til slutningen af forespørgselsstrengen. Forespørgselsstrenge fungerer ikke, når du starter en lærredapp.

Ved start af en app på en mobilenhed, hvor appen allerede kører, opdateres parametrene ikke i den kørende app. Appen skal indlæses på ny for at opdatere parametrene.

Target

Brug argumentet LaunchTarget til at angive det vindue i destinationsbrowseren, som websiden eller appen skal åbnes i. Brug en af følgende LaunchTarget-optællingsværdier, eller angiv et brugerdefineret vindue navn.

LaunchTarget enum Beskrivelse
New Websiden eller appen åbnes i et nyt vindue eller en ny fane.
Replace Websiden eller appen erstatter det aktuelle vindue eller den aktuelle fane.
name I stedet for at angive en optællingsværdi, skal du bruge din egen tekststreng til at navngive vinduet eller fanen. Self er et internt navn, der kun bruges af funktionen Launch. Den påvirker ikke og vil heller ikke matche titlen på det vindue, som brugerne kan se. Hvis der allerede findes et vindue eller en fane med det angivne navn, erstattes indholdet af dets indhold. Ellers oprettes der et nyt vindue eller en ny fane. name må ikke begynde med understregningstegnet "_".

New er standardfastteksten, når du kører i en webbrowser med Replace og Navn som tilgængelige indstillinger. I en mobilafspiller er New standard for websider med navn som en tilgængelig mulighed, mens den aktuelle lærredapp altid vil blive erstattet af en anden lærredapp.

Bemærk

  • Brug af en LaunchTarget med en anden værdi end New i integrerede scenarier (f.eks. Power BI eller SharePoint) understøttes ikke og kan resultere i uventet funktionsmåde. I fremtiden kan denne funktionsmåde blive ændret, eller det kan medføre en fejl.

Param

Med funktionen Param hentes en parameter, der blev sendt til appen, da den blev startet. Hvis den navngivne parameter ikke blev sendt, returnerer Paramtom.

  • Når du starter en lærredapp fra en anden lærredapp, skal du bruge Parameter-argumenterne til funktionen Launch. Parameternavne og -værdier vil automatisk blive kodet med URL-adressekoder.
  • Når du starter en lærredapp fra en webside, skal du føje parametre til forespørgselsstrengen for weblinket til lærredappen. Det indebærer, at &parametername=parametervalue tilføjes, da det antages, at forespørgselsstrengen er allerede startet for tenantId. Hvis du tilføjer, &First%20Name=Vicki&category=3 overføres f.eks. to parametre: First Name med værdien "Vicki" og category med værdien "3" (værditype er tekst). Parameternavnet og -værdien skal være URL-adressekodet, hvis de indeholder mellemrum eller specialtegn, hvilket svarer til brugen af funktionen EncodeURL.
  • Der skelnes mellem store og små bogstaver i parameternavne.
  • Parameternavne og -værdier opdateres automatisk med en URL-adressekode, der kan bruges i appen.
  • Parameterværdier bliver ikke ændret, medmindre appen indlæses igen. Hvis du bruger Start på en mobilenhed, hvor appen allerede kører, bliver parametrene ikke opdateret.
  • Selv om parameteren indeholder et tal, vil den type, der returneres af Param, altid være en tekststreng. Konvertering til andre typer sker automatisk eller bruger eksplicitte konverteringer, f.eks. funktionen Value til at konvertere eksplicit til et tal.

Bemærk

Til brugerdefinerede sider er de eneste parametre, der accepteres af siden: recordId og entityName.

Syntaks

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

  • Address – påkrævet. Adressen på en webside eller id'et for en app, der skal startes.
  • ParameterName(s) – valgfri. Parameternavn.
  • ParameterValue(s) – valgfri. Tilsvarende parameterværdier, der skal sendes til appen eller websiden.

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

  • Address – påkrævet. Adressen på en webside eller id'et for en app, der skal startes.
  • ParameterName(s) – valgfri. Parameternavn.
  • ParameterValue(s) – valgfri. Tilsvarende parameterværdier, der skal sendes til appen eller websiden.
  • LaunchTarget – valgfrit. En LaunchTarget-optællingsværdi eller et brugerdefineret navn.

Param( ParameterName )

  • ParameterName – påkrævet. Navnet på den parameter, der blev sendt til appen.

Reserverede parametre

Følgende nøgleord er reserveret (uanset store og små bogstaver) til intern brug og skal ikke bruges som en brugerdefineret 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
  • placering
  • packagekind
  • packageproperties
  • playerresourcespath
  • playersessionid
  • powerappslanguage
  • screencolor
  • sdkversion
  • websted
  • skipappmetadata
  • skipiframecreation
  • skiplaunchappcache
  • source
  • sourcetime
  • standaloneconsent
  • teamid
  • teamtype
  • tenantId
  • tema
  • uselocalpackagehostresources
  • userteamrole

Eksempler

Enkel start

Fra en lærredapp til en webside:

Formula Description
Launch( "http://bing.com/search",
"q", "Power Apps", "count", 1 )
Åbner websiden https://bing.com/search?q=Power%20Apps&count=1. Der åbnes et nyt vindue eller en ny fane.
Launch( "http://bing.com/search",
{ q: "Power Apps", count: 1 } )
Det samme som de foregående eksempler, der anvender den tilsvarende postnotation. Der åbnes et nyt vindue eller en ny fane.
Launch( "http://bing.com/search",
{ q: "Power Apps", count: 1 },
LaunchTarget.Replace )
De samme som de foregående eksempler, og det aktuelle vindue eller den samme fane erstattes med resultatet, hvis det køres i en webbrowser.
Launch( "http://bing.com/search",
{ q: "Power Apps", count: 1 },
"Søgeresultater" )
Det samme som i forrige eksempel, så du kan oprette eller erstatte indholdet i vinduet eller under fanen med navnet Søgeresultater.

Fra en lærredapp til en lærredapp:

Opdater app-id, skærmnavn og postnummer efter behov.

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

Fra en webside til en lærredapp

Opdater app-id, lejer-id, skærmnavn og 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>

Simpel Param

Simple starteksempler ovenfor for at starte lærredappen fra en webside eller fra en anden lærredapp viser simple eksempler for funktionen Param:

Formel Beskrivelse Resultat
Param( "Navigate" ) Parameteren Navigate blev angivet, da appen blev startet, og den blev returneret. "Andet skærmbillede"
Param( "Record" ) Parameteren Record blev angivet, da appen blev startet. Selvom det blev overført som et tal til funktionen Launch, vil resultatet fra Param være en tekststreng, der implicit eller eksplicit kan konverteres til andre typer. "34"
Param( "User" ) Parameteren User blev ikke angivet. Der returneres en tom værdi, som kan testes med funktionen IsBlank. blank

Trinvise eksempler på Launch og Param

Layoutskabelonen for tabletten Product Showcase blev brugt til følgende eksempler. Hvis du vil oprette en app med denne skabelon, skal du følge trinnene i artiklen Opret en app og vælge skabelonen Product Showcase. Du kan også bruge din egen app.

Eksempel - Launch

  1. Gå til Power Apps.

  2. Vælg Apps i venstre navigationsrude.

  3. Vælg din app, og vælg derefter Rediger.

  4. Vælg Indsæt fra menuen, og vælg derefter Etiket.

  5. Flyt etiketten til nederste højre hjørne på skærmen.

  6. Fra ruden Egenskaber på højre side, skal du vælge Farve som hvid og angive Kanttykkelse ved 1.

  7. Vælg egenskaben Text i højre side, og skriv teksten som Surface-tabletter i nyhederne.

  8. Vælg OnSelect fra egenskabsliste øverst til venstre.

  9. Angiv formlen som Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). Du kan også bruge enhver anden URL-adresseparameter og nøgleord.

    Eksempel på Launch.

  10. Gem og publicer appen.

  11. Afspil appen.

  12. Vælg etiketter Surface-tabletter i nyhederne for at starte nyhedssøgning med nøgleord til Microsoft Surface-tabletter.

Tip

Du kan opnå skalerbarhed ved at erstatte de manuelt angivne nøgleord i startfunktion med variabler .

Eksempel – Param

  1. Gå til Power Apps.

  2. Vælg Apps i venstre navigationsrude.

  3. Vælg din app, og vælg derefter Rediger.

  4. Vælg Indsæt fra menuen, og vælg derefter Etiket.

  5. Flyt etiketten til nederste højre hjørne på skærmen.

  6. Vælg egenskaben Text for etiketten fra øverste venstre hjørne.

  7. Angiv formlen som Param("browser"). Du kan også bruge en anden parameter efter eget valg.

    Eksempel på Param.

  8. Gem og publicer appen.

  9. Kopiér weblink til din app fra Power Apps.

  10. Åbn en ny browser.

  11. Indsæt appens weblink i browseren, og tilføj &browser=Microsoft%20Edge i slutningen.

    Webadresse.

  12. Når appen startes, viser etiketten den overførte parameterværdi.

    Eksempel på Param-etiket.

  13. Luk app-afspilleren, og rediger appen.

  14. Vælg App i trævisningen på venstre navigationspanel.

  15. Vælg egenskaben StartScreen øverst til venstre.

  16. Angiv formlen som If( Param("screen") = "techspecs", TechSpecs ).

    Eksempel på Param til navigation.

    If function i egenskaben StartScreen kontrollerer, om parameteren er lig med en bestemt værdi, i dette tilfælde værdien techspecs. Og hvis det stemmer overens, returnerer techspecs-skærmkontrolelementet til egenskaben StartScreen .

    Bemærk

    Erstat kontrolelementnavnet TechSpecs i funktionen If, hvor navnet på en skærm er valgt i din egen app, hvis du ikke bruger app-skabelonen Product Showcase.

  17. Gem og publicer appen.

  18. Åbn en ny browser.

  19. Indsæt appens weblink i browseren, og tilføj &screen=techspecs i slutningen.

    Webadresse til TechSpecs-skærm.

  20. Appen starter direkte med TechSpecs som startskærm.

Se også

Formelreference til lærredapp