Funktionerne Launch og Param

Artikel
10/16/2024

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

Address (required), URL-adressen til lærredappens webside.
Parametre (valgfrit), navngivne værdier, der skal overføres til websiden eller lærredappen. I en lærredapp kan parametre læses med funktionen Param.
Mål (valgfrit), den browserfane, hvor websiden eller lærredappen skal startes.

Launch kan kun bruges i funktionsformler.

Bemærk

Hvis startformularen bruges til at åbne Power Apps, og appen ikke er synlig for slutbrugeren, anbefales det, at du kontrollerer, om appen er blokeret af en pop-up-blokerer i browseren, eller om browseren venter på brugerens svar i en dialogboks, hvor de bliver spurgt, om de vil navigere til et nyt skærmbillede.

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:

Gå til Power Apps.
Vælg Apps i venstre navigationsrude.
Vælg din app.
Vælg Detaljer i den øverste menu.
Du kan også vælge ... (Flere kommandoer) og derefter Detaljer på rullemenuen.
Kopiér weblinket.

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

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

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

Launch kan overføre 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
Ny	Websiden eller appen åbnes i et nyt vindue eller en ny fane.
Erstatte	Websiden eller appen erstatter det aktuelle vindue eller den aktuelle fane.
Navn	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. Navnet må ikke begynde med understregningstegnet "_".

Ny er standard-enum, når du kører i en webbrowser med Erstat og navn som tilgængelige muligheder. 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 Param tom.

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(Adresse[,Parameternavn1,Parameterværdi1 ,... ] )

Adresse – Påkrævet. Adressen på en webside eller id'et for en app, der skal startes.
Parameternavne – Valgfrit. Parameternavn.
ParameterValues – Valgfrit. Tilsvarende parameterværdier, der skal sendes til appen eller websiden.

Launch(Adresse,[Parameternavn1: Parameterværdi1, ... ] { } [, LaunchTarget ] )

Adresse – Påkrævet. Adressen på en webside eller id'et for en app, der skal startes.
Parameternavne – Valgfrit. Parameternavn.
ParameterValues – Valgfrit. Tilsvarende parameterværdier, der skal sendes til appen eller websiden.
LaunchTarget – Valgfrit. En LaunchTarget-optællingsværdi eller et brugerdefineret navn.

Param( Parameternavn )

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( "Naviger" )	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( "Bruger" )	Parameteren User blev ikke angivet. Der returneres en tom værdi, som kan testes med funktionen IsBlank.	hvid

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

Gå til Power Apps.
Vælg Apps i venstre navigationsrude.
Vælg din app, og vælg derefter Rediger.
Vælg Indsæt fra menuen, og vælg derefter Etiket.
Flyt etiketten til nederste højre hjørne på skærmen.
Fra ruden Egenskaber på højre side, skal du vælge Farve som hvid og angive Kanttykkelse ved 1.
Vælg egenskaben Text i højre side, og skriv teksten som Surface-tabletter i nyhederne.
Vælg OnSelect fra egenskabsliste øverst til venstre.
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.
Gem og publicer appen.
Afspil appen.
Vælg mærkat Surface-tablets i nyheder for at starte nyhedssøgning med nøgleord Microsoft Surface-tablets.

Tip

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

Eksempel – Param

Gå til Power Apps.
Vælg Apps i venstre navigationsrude.
Vælg din app, og vælg derefter Rediger.
Vælg Indsæt fra menuen, og vælg derefter Etiket.
Flyt etiketten til nederste højre hjørne på skærmen.
Vælg egenskaben Text for etiketten fra øverste venstre hjørne.
Angiv formlen som Param("browser"). Du kan også bruge en anden parameter efter eget valg.
Gem og publicer appen.
Kopiér weblink til din app fra Power Apps.
Åbn en ny browser.
Indsæt appens weblink i browseren, og tilføj &browser=Microsoft%20Edge i slutningen.
Når appen startes, viser etiketten den overførte parameterværdi.
Luk app-afspilleren, og rediger appen.
Vælg App i trævisningen på venstre navigationspanel.
Vælg egenskaben StartScreen øverst til venstre.
Angiv formlen som If( Param("screen") = "techspecs", TechSpecs ).

If-funktionen 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.
Gem og publicer appen.
Åbn en ny browser.
Indsæt appens weblink i browseren, og tilføj &screen=techspecs i slutningen.
Appen starter direkte med TechSpecs som startskærm.