Launch ir Param funkcijos

Taikoma: drobės programoms

Paleidžia tinklalapį arba drobės programą ir suteikia prieigą prie paleidimo parametrų.

Launch

Paleidžia tinklalapį arba drobės programą. Funkcija palaiko tolesnius elementus.

Adresas (būtinas), drobės taikomosios programos tinklalapio URL.
Parametrai (pasirinktinai), pavadintos reikšmės, kurias reikia perduoti į tinklalapį arba drobės programą. Drobės programoje parametrus galima skaityti su Param funkcija.
Target (pasirinktinai), naršyklės skirtukas, kuriame galima paleisti tinklalapį arba drobės programą.

Launch galima naudoti tik veikimo būdo formulėse.

Pastaba.

Launch Jei formulė naudojama "Power Apps" atidaryti, o programos galutinis vartotojas nemato, rekomenduojama patikrinti, ar programą blokuoja naršyklės iššokančių langų blokavimo programa, arba ar naršyklė laukia vartotojo atsakymo į dialogo langą, kuriame klausiama, ar vartotojas nori pereiti į naują ekraną.
Tik https: URI palaikomi naudojant Launch "PowerBI" "Power Apps Visual".

Adresas

Tinklalapiai paleidžiami naudojant URL adresą. Pavyzdys.

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

Galite paleisti drobės programas naudodami žiniatinklio susieti arba programos URI( programos ID priešdėlis su /providers/Microsoft.PowerApps/apps/). Norėdami rasti šias programos reikšmes, atlikite tolesnius veiksmus.

Eikite į Power Apps.
Kairiojoje naršymo srityje pasirinkite Programos.
Pasirinkite savo programą.
Viršutiniame meniu pasirinkite Išsami informacija.
Taip pat galite viršutiniame išplečiamajame meniu pasirinkti ... (Daugiau komandų), tada – Išsami informacija.
Kopijuoti žiniatinklio susieti.

Žiniatinklio saitą galima naudoti bet kuriame tinklalapyje ir jis paleis drobės programą. Jį taip pat galima naudoti su Launch funkcija. Pavyzdys.

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

Savųjų įrenginio programų tiesiogiai paleisti negalima. Kai kuriose platformose gali būti netiesioginių parinkčių, pvz., savosios programos gali įdiegti pasirinktinę URL schemą arba užsiregistruoti žiniatinklio naršyklėje, kad atsirastų parinktis konkrečioms žiniatinklio svetainėms.

Parametrai

Launch gali perduoti parametrus į tinklalapio arba drobės programėlę. Parametrus galima pateikti tolesniais dviem būdais.

Argumentų sąrašas su pavadinimų reikšmių poromis. Pavyzdys.

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

Laukų reikšmių įrašas. Pavyzdys.
```
Launch( "https://bing.com/search", { q: "Power Apps", count: 1 } )
```
Šią formą naudoti gali būti lengviau, nes ji aiškiau susieja pavadinimą ir reikšmę. Tai yra vienintelė forma, kuri palaiko pasirenkamąjį argumentą LaunchTarget.

Adresas ir parametrai užkoduojami URL adresu ir perduodami, kad tam tikrus ne raidinius / skaitinius simbolius pakeistų simboliu % ir šešioliktainiu skaičiumi, lyg su abiem šiais elementais būtų panaudota funkcija EncodeUrl.

Paleidžiant tinklalapį, URL adreso pabaigoje galima įtraukti parametrų užklausos eilutę. Visi papildomi pateikti Launch parametrai bus įtraukti į užklausos eilutės pabaigą. Paleidžiant drobės programą, užklausos eilutės neveikia.

Paleidus programą mobiliajame įrenginyje, kuriame ta programa jau veikia, parametrai veikiančioje programoje nebus atnaujinami. Norint atnaujinti parametrus, reikia iš naujo įkelti programą.

Target

Naudodami argumentą LaunchTarget, galite nurodyti paskirties naršyklės langą, kuriame atidarysite tinklalapį arba programą. Naudokite vieną iš toliau nurodytų LaunchTarget išvardijimo reikšmių arba nurodykite pasirinktinį lango pavadinimą.

LaunchTarget išvardijimas	Aprašo
Naujas	Tinklalapis arba programa atidaromi naujame lange arba skirtuke.
Pakeisti	Tinklalapis arba programa pakeičia dabartinį langą arba skirtuką.
vardas, pavadinimas	Vietoj išvardijimas reikšmės naudokite savo teksto eilutę, kad pavadintumėte langą arba skirtuką. "Self " yra tik vidinis pavadinimas, kurį Launch naudoja tik funkcija. Jis neturi jokio poveikio lango, kurį mato jūsų vartotojai, pavadinimui, ir jo neatitiks. Jei langas arba skirtukas nurodytu pavadinimu jau yra, jo turinys bus pakeistas. Priešingu atveju bus sukurtas naujas langas arba skirtukas. vardas negali prasidėti pabraukimo simboliu "_".

Naujas yra numatytasis išvardijimas, kai veikia žiniatinklio naršyklėje su parinktimis Pakeisti ir pavadinti kaip galimas. Mobiliame grotuve Naujas yra nustatytasis žiniaitnklio puslapiams su pavadinimu kaip prieinama parinktimi; tuo tarpu, esama drobės programa visuomet bus pakeičiama kita drobės programa.

Pastaba.

Naudojant LaunchTarget su bet kuria, o ne Nauja verte įterptuose scenarijuose (pavyzdžiui, „Power BI“ arba SharePoint) yra nepalaikomas ir gali baigtis nelaukiamu elgesiu. Ateityje tokia elgsena gali pasikeisti ar sukelti klaidą.

Param

Funkcija Param nuskaito parametrą, perduotą programai, kai jis buvo paleistas. Jei įvardytasis parametras nebuvo perduotas, Param pateikia tuščią.

Paleisdami drobės programą iš kitos drobės programos, naudokite funkcijos parametro argumentus Launch . Parametrų pavadinimai ir reikšmės bus automatiškai užkoduoti URL adresu.
Drobės programą paleisdami iš tinklalapio, parametrus įtraukite į drobės programos žiniatinklio saito užklausos eilutę. Darant prielaidą, kad &parametername=parametervalue užklausos eilutė jau pradėta, įtraukiama tenantId. Pavyzdžiui, įtraukus &First%20Name=Vicki&category=3, būtų perduoti du parametrai: First Name, kurio reikšmė – "Vicki", ir category, kurio reikšmė – "3" (reikšmės tipas yra tekstas). Jei parametro pavadinime ir reikšmėje yra tarpų ar specialiųjų simbolių, jie turi būti užkoduoti URL adresu, panašiai, kaip naudojant funkciją EncodeURL.
Param pavadinimuose skiriamos didžiosios ir mažosios raidės.
Param pavadinimai ir reikšmės bus automatiškai dekoduojami, kad būtų naudojami jūsų taikomojoje programoje.
Parametrų reikšmės nesikeičia, nebent programa įkeliama iš naujo. Naudojant Launch mobiliajame įrenginyje, kuriame programa jau veikia, parametrai neatnaujinami.
Net jei parametre yra skaičius, grąžintas Param tipas visada bus teksto eilutė. Konvertavimas į kitus tipus vyks automatiškai arba bus naudojamas aiškus konvertavimas, pvz., aiškiai konvertuojama į skaičių naudojant funkciją Value.

Pastaba.

Pasirinktiniuose puslapiuose vieninteliai parametrai, kuriuos priima puslapis, yra šie: recordId ir entityName.

Sintaksė

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

Adresas – būtina. Paleistino tinklalapio adresas arba paleistinos programos ID.
ParameterNames – neprivaloma. Parametro pavadinimas.
ParameterValues – neprivaloma. Atitinkamos parametrų reikšmės, kurias reikia perduoti programai arba tinklalapiui.

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

Adresas – būtina. Paleistino tinklalapio adresas arba paleistinos programos ID.
ParameterNames – neprivaloma. Parametro pavadinimas.
ParameterValues – neprivaloma. Atitinkamos parametrų reikšmės, kurias reikia perduoti programai arba tinklalapiui.
LaunchTarget – neprivaloma. LaunchTarget išvardijimo reikšmė arba pasirinktinis pavadinimas.

Param( ParameterName )

ParameterName - būtina. Programai perduodamo parametro pavadinimas.

Rezervuoti parametrai

Šie raktažodžiai rezervuoti (neatsižvelgiant į atvejus) vidiniam naudojimui ir neturėtų būti naudojami kaip pasirinktinis parametras funkcijoje Param():

amp%3Bauthmode
amp%3Benableonbehalfof
amp%3Bhidenavbar
amp%3Blocale
appmetadataversion
authmode
channeltype
cordovapath
correlationid
derinti
delegatelaunchurl
delegatelaunchurl
disablepreviewredirect
embedderorigin
enableonbehalfof
groupid
hideappsplash
hidenavbar
nurodymas
hostclienttype
hostmode
iframecontainerid
isfullscreen
ispreviewmode
loader
loaderType
lokalė
vieta
packagekind
packageproperties
playerresourcespath
playersessionid
powerappslanguage
screencolor
sdkversion
puslapis
skipappmetadata
skipiframecreation
skiplaunchappcache
šaltinis
šaltinio laikas
standaloneconsent
teamid
teamtype
tenantId
tema
uselocalpackagehostresources
userteamrole

Pavyzdžiai

Paprastas Launch

Iš drobės programos į tinklalapį:

Formulė	Aprašo
Launch( "http://bing.com/search", "q", "Power Apps", "count", 1 )	Atidaro tinklalapį https://bing.com/search?q=Power%20Apps& skaičius=1. Atidaromas naujas langas arba skirtukas.
Launch( "http://bing.com/search", { q: "Power Apps", count: 1 } )	Taip pat, kaip ankstesniuose pavyzdžiuose, naudojant lygiavertį įrašų žymėjimą. Atidaromas naujas langas arba skirtukas.
Launch( "http://bing.com/search", { q: "Power Apps", skaičius: 1 }, LaunchTarget.Replace )	Taip pat, kaip ankstesniuose pavyzdžiuose, dabartinį langą arba skirtuką pakeičiant rezultatu (jei naudojama žiniatinklio naršyklė).
Launch( "http://bing.com/search", { q: "Power Apps", skaičius: 1 }, "Ieškos rezultatai" )	Taip pat, kaip ankstesniame pavyzdyje, sukuriant arba pakeičiant lango arba skirtuko, pavadinto Ieškos rezultatai, turinį.

Iš drobės programos į drobės programą

Atitinkamai atnaujinkite programos ID, ekrano pavadinimą ir įrašo numerį.

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

Iš tinklalapio į drobės programą

Atitinkamai atnaujinkite programos ID, nuomotojo ID, ekrano pavadinimą ir įrašo numerį.

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

Paprastas Param

Anksčiau pateikti paprasti paleidimo pavyzdžiai, kaip paleisti drobės programą iš tinklalapio arba iš kitos drobės taikomosios programos , pateikia paprastus funkcijos pavyzdžius Param :

Formulė	Aprašo	Rezultatas
Param( Naršyti )	Parametras Navigate buvo pateiktas paleidus programą ir jis pateikiamas.	„Antras ekranas“
Param( "Įrašas" )	Parametras Record buvo pateiktas paleidus programą. Nors jis buvo perduotas kaip skaičius funkcijai Launch , rezultatas bus Param teksto eilutė, kurią galima netiesiogiai arba tiesiogiai konvertuoti į kitus tipus.	„34“
Param( "Vartotojas" )	Parametras User nebuvo nurodytas. Pateikiama tuščia reikšmė, kurią galima išbandyti naudojant funkciją IsBlank.	Tuščią

Išsamūs pavyzdžiai, skirti Launch ir Param

Tolesniuose pavyzdžiuose buvo panaudotas planšetinio kompiuterio maketo šablonas Produktų demonstravimas. Jei norėti sukurti programą naudodami šį šabloną, atlikite veiksmus, aprašytus straipsnyje apie programos sukūrimą, ir pasirinkite šabloną Produktų demonstravimas. Taip pat galite naudoti savo programą.

Pavyzdys- Launch

Eikite į Power Apps.
Kairiojoje naršymo srityje pasirinkite Programos.
Pasirinkite savo programą, tada – Redaguoti.
Meniu pasirinkite Įterpti, tada – Žyma.
Žymą perkelkite į apatinę dešiniąją ekrano dalį.
Dešinėje esančioje ypatybių srityje pasirinkite ypatybės Color reikšmę balta, o kraštinės storį nustatykite kaip 1.
Dešinėje pasirinkite ypatybę Text ir įveskite tekstą „Surface“ planšetiniai kompiuteriai naujienose.
Viršutinėje kairiojoje dalyje esančiame ypatybių sąraše pasirinkite OnSelect.
Įveskite formulę kaip Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). Taip pat galite naudoti bet kurį kitą pasirinktą URL, parametrą ir raktažodžius.
Įrašykite ir publikuokite programą.
Paleiskite programą.
Pasirinkite žymą „Surface“ planšetiniai kompiuteriai naujienose, kad paleistumėte naujienų iešką naudodami raktažodžius Microsoft Surface planšetiniai kompiuteriai.

Arbatpinigiai

Mastelio keitimo tikslais galite pakeisti rankiniu būdu įvestus raktažodžius funkcijoje Launchkintamaisiais.

Pavyzdys- Param

Eikite į Power Apps.
Kairiojoje naršymo srityje pasirinkite Programos.
Pasirinkite savo programą, tada – Redaguoti.
Meniu pasirinkite Įterpti, tada – Žyma.
Žymą perkelkite į apatinę dešiniąją ekrano dalį.
Viršutinėje kairiojoje dalyje pasirinkite žymos ypatybę Text.
Įveskite formulę kaip Param("browser"). Taip pat galite naudoti kitą savo pasirinktą parametrą.
Įrašykite ir publikuokite programą.
Iš „Power Apps“ nukopijuokite savo programos žiniatinklio saitą.
Atidarykite naują naršyklę.
Naršyklėje įklijuokite programos žiniatinklio saitą ir pabaigoje pridėkite &browser=Microsoft%20Edge.
Paleidus programą žymoje rodoma perduota parametro reikšmė.
Uždarykite programos leistuvą ir redaguokite programą.
Kairiojoje naršymo srityje esančiame medžio rodinyje pasirinkite Programa.
pasirinkti StartScreen ypatybę viršutiniame kairiajame kampe.
Įveskite formulę kaip If( Param("screen") = "techspecs", TechSpecs ).

Jei "StartScreen " ypatybės funkcija tikrina, ar parametras lygus tam tikrai reikšmei, šiuo atveju reikšmės techspecs. O jei sutampa, grąžina "TechSpecs " ekrano valdiklį į "StartScreen " ypatybę.

Pastaba.

Jei nenaudojate produkto demonstravimo programos šablono, pakeiskite "TechSpecs" valdiklio pavadinimą funkcijoje If į ekrano valdiklio pavadinimą savo programoje.
Įrašykite ir publikuokite programą.
Atidarykite naują naršyklę.
Naršyklėje įklijuokite programos žiniatinklio saitą ir pabaigoje pridėkite &screen=techspecs.
Programa tiesiogiai paleidžiama naudojant "TechSpecs" kaip pradžios ekraną.

Taip pat žr.

Drobės programos formulės nuoroda

Atsiliepimus

Ar šis puslapis buvo naudingas?

Last updated on 2025-10-10

Dalintis per

Launch ir Param funkcijos

Launch

Adresas

Parametrai

Target

Param

Sintaksė

Rezervuoti parametrai

Pavyzdžiai

Paprastas Launch

Iš drobės programos į tinklalapį:

Iš drobės programos į drobės programą

Iš tinklalapio į drobės programą

Paprastas Param

Išsamūs pavyzdžiai, skirti Launch ir Param

Pavyzdys- Launch

Pavyzdys- Param

Taip pat žr.

Atsiliepimus

Papildomi ištekliai