Paleidimo ir Param funkcijos

Straipsnis
10/16/2024

Taikoma: drobės programoms

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

Paleisti

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 parametrai gali būti skaitomi naudojant funkciją Param.
Target (pasirinktinai), naršyklės skirtukas, kuriame galima paleisti tinklalapį arba drobės programą.

Paleidimą galima naudoti tik elgesio formulėse.

Pastaba.

Jei norint atidaryti Power Apps naudojama paleidimo formulė, o galutinis vartotojas nemato programos, rekomenduojama patikrinti, ar programą užblokavo naršyklės iššokančių langų blokavimo programa, ar naršyklė laukia, kol vartotojas atsakymas į dialogo langą, kuriame klausiama, ar jis nori pereiti į naują ekraną.

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 funkcija Launch. 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

Paleidimas gali perduoti parametrus tinklalapiui arba drobės programai. Parametrus galima pateikti tolesniais dviem būdais.

Argumentų sąrašas su pavadinimų reikšmių poromis. Pavyzdžiui:

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

Laukų reikšmių įrašas. Pavyzdžiui:
```
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ę. Bet kokie papildomi parametrai, pateikti funkcijai Launch, bus įtraukti užklausos eilutės pabaigoje. 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	Vietoje išvardijimo reikšmės langą arba skirtuką pavadinkite savo teksto eilute. Savo yra tik vidinis pavadinimas, kurį naudoja tik funkcija Launch. 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 gauna parametrą, į programą perduotą ją paleidžiant. Jei pavadintas parametras nebuvo perduotas, Param pateikia tuščią reikšmę.

Drobės programą paleisdami iš kitos drobės programos, naudokite funkcijos Launch Parameter argumentus. 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 tenantId užklausos eilutė jau pradėta, įtraukiama &parametername=parametervalue. 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.
Iš Param pavadinimų ir reikšmių bus automatiškai iškoduotas URL, kad jį būtų galima naudoti jūsų programoje.
Parametrų reikšmės nesikeičia, nebent programa įkeliama iš naujo. Naudojant "Launch " mobiliajame įrenginyje, kuriame programa jau veikia, parametrai neatnaujinami.
Net jei parametro reikšmė yra skaičius, Param pateiktas 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

Toliau nurodyti raktažodžiai yra rezervuoti (nepriklausomai nuo atvejo) vidiniam naudojimui ir neturi būti naudojami kaip funkcijos Param() pasirinktinis parametras:

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

Pavyzdžiai

Paprastoji Launch

Iš drobės programos į tinklalapį:

Formulė	Aprašą
Paleidimas( "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.
Paleidimas( "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.
Paleidimas( "http://bing.com/search", { q: "Power Apps", count: 1 }, LaunchTarget.Replace )	Taip pat, kaip ankstesniuose pavyzdžiuose, dabartinį langą arba skirtuką pakeičiant rezultatu (jei naudojama žiniatinklio naršyklė).
Paleidimas( "http://bing.com/search", { q: "Power Apps", count: 1 }, "Search Results" )	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>

Paprastoji Param

Paprastuose pirmiau pateiktuose paleidimo pavyzdžiuose, kuriuos taikant drobės programa paleidžiama iš tinklalapio arba iš kitos drobės programos, parodyti paprasti funkcijos Param pavyzdžiai:

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

Nuoseklūs Launch ir Param pavyzdžiai

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 etiketę "Surface" planšetiniai kompiuteriai naujienose , kad paleistumėte naujienų paiešką naudodami raktinius žodžius Microsoft "Surface" planšetiniai kompiuteriai.

Arbatpinigiai

Norėdami keisti mastelį, rankiniu būdu funkcijoje Launch įvestus raktažodžius galite pakeisti kintamaisiais.

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