Palaišanas un Param funkcijas

Raksts
03/22/2024

Attiecas uz: Audekla programmām

Palaiž tīmekļa lapu vai pamatnes programmu un nodrošina piekļuvi palaišanas parametriem.

Palaist

Palaiž tīmekļa lapu vai pamatnes programmu. Šī funkcija atbalsta:

Adrese (obligāts), audekla programmas tīmekļa lapas vietrādis URL vai lietotnes URI (lietotnes ID ar prefiksu /providers/Microsoft.PowerApps/apps/).
Parametri (neobligāti), nosauktās vērtības, kas jānosūta uz tīmekļa lapu vai kanvas programmu. Pamatnes programmā parametrus var lasīt, izmantojot funkciju Param.
Mērķis (neobligāti), pārlūkprogrammas cilne, kurā palaist tīmekļa lapu vai pamatnes programmu.

Palaist var izmantot tikai uzvedības formulās.

Adrese

Tīmekļa lapas tiek palaistas, izmantojot URL adresi. Piemēram:

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

Varat palaist audekla lietotnes ar tīmekļa saiti vai lietotnes URI (lietotnes ID, kas prefiksēts ar/providers/Microsoft.PowerApps/apps/). Lai atrastu šādas programmas vērtības:

Dodieties uz Power Apps.
Kreisās puses navigācijas rūtī atlasiet Programmas.
Atlasīt savu programmu.
Augšējā izvēlnē atlasiet Detalizēta informācija.
Programmai varat arī atlasīt ... (Vairāk komandu) un pēc tam nolaižamajā izvēlnē atlasīt Detalizēta informācija.
Kopējiet Tīmekļa saiti vai Programmas ID.

Tīmekļa saiti var izmantot jebkurā tīmekļa lapā, un tā palaidīs pamatnes programmu. To var izmantot arī ar funkciju Launch.

Programmas ID var izmantot ar funkciju Launch, taču tās nosaukumam jāsākas ar /providers/Microsoft.PowerApps/apps/. Piemērs.

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

Iebūvētās programmas ierīcē nevar palaist tieši. Dažās platformās var būt pieejamas netiešas opcijas, piemēram, iebūvēta programma, kas instalē pielāgotu URL shēmu vai reģistrējas tīmekļa pārlūkā, lai piedāvātu noteiktu vietņu opciju.

Parametri

Launch var nodot parametrus tīmekļa lapai vai pamatnes programmai. Parametrus var nodrošināt divos veidos:

Nosaukuma vērtību pāru argumentu saraksts. Piemērs.

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

Lauka vērtību ieraksts. Piemērs.
```
Launch( "https://bing.com/search", { q: "Power Apps", count: 1 } )
```
Ar šo veidlapu var būt vieglāk strādāt, jo tā veido skaidrāku saistību starp nosaukumu un vērtību. Tā ir vienīgā veidlapa, kas atbalsta neobligāto argumentu LaunchTarget.

Adrese un parametri ir kodēti ar URL, pirms tos padod, lai aizstātu noteiktas neburtciparu rakstzīmes ar % un heksadecimālu skaitli tā, it kā šī EncodeUrl funkcija būtu pielietota katram.

Palaižot tīmekļa lapu, URL adreses beigās var iekļaut parametru vaicājumu virkni. Visi papildu parametri, kas tiek nodrošināti funkcijai Launch, tiks pievienoti vaicājuma virknes beigās. Vaicājumu virknes nedarbojas, palaižot pamatnes programmu.

Palaižot lietojumprogrammu mobilajā ierīcē, kurā šī programma jau darbojas, parametri palaistajā programmā netiks atsvaidzināti. Lai atsvaidzinātu parametrus, ir nepieciešama programmas atkārtota ielāde.

Mērķis

Izmantojiet argumentu LaunchTarget, lai konkretizētu mērķa pārlūka logu, kurā atvērt tīmekļa lapu vai programmu. Izmantojiet vienu no tālāk minētajām LaunchTarget uzskaitījuma vērtībām vai nodrošiniet pielāgotu loga nosaukumu.

LaunchTarget uzskaitījums	Apraksts
New	Tīmekļa lapa vai programma tiek atvērta jaunā logā vai cilnē.
Replace	Tīmekļa lapa vai programma aizstāj pašreizējo logu vai cilni.
nosaukums	Uzskaitījuma vērtības vietā izmantojiet paši savu teksta virkni, lai nosauktu logu vai cilni. Self ir tikai iekšējs nosaukums, ko izmanto vienīgi funkcija Launch. Tam nav ietekmes uz loga, kuru jūsu lietotāji skatīs, nosaukumu, un tas arī tam neatbildīs. Ja logs vai cilne ar norādīto nosaukumu jau pastāv, tās saturs tiks aizstāts. Pretējā gadījumā tiek izveidots jauns logs vai cilne. nosaukumu nevar sākt ar apakšsvītru "_".

New ir noklusējuma uzskaitījums, kad tas tiek palaists tīmekļa pārlūkprogrammā ar Replace un name kā pieejamām opcijām. Mobilajā atskaņotājā Jauns ir noklusējuma iestatījums tīmekļa lapām, ar nosaukt kā pieejamo opciju, bet pašreizējā pamatnes programma vienmēr tiks aizstāta ar citu pamatnes programmu.

Note

Izmantojot LaunchTarget ar jebkuru vērtību, kas nav Jauns iegultos scenārijos (piemēram, Power BI vai SharePoint), netiek atbalstīta, un var izraisīt neparedzētu darbību. Turpmāk šī darbība var mainīties vai radīt kļūdu.

Param

Funkcija Param izgūst parametru, kas tika nodots programmai tās palaišanas laikā. Ja nosauktais parametrs nav padots, Param atgriež tukšu.

Palaižot pamatnes programmu no citas pamatnes programmas, izmantojiet Parametra argumentus funkcijai Launch. Parametru nosaukumi un vērtības tiek automātiski kodēti ar URL.
Kad tīmekļa lapā palaižat pamatnes programmu, pievienojiet parametrus vaicājuma virknei - pamatnes programmas tīmekļa saitē. Tas ietver &parametername=parametervalue pievienošanu, pieņemot, ka vaicājuma virkne jau ir uzsākta tenantId. Piemēram, pievienojot &First%20Name=Vicki&category=3, tiktu padoti divi parametri: First Name ar vērtību "Vicki" un category ar vērtību "3" (vērības veids ir teksts). Parametra nosaukumam un vērtībai jābūt kodētai ar URL, ja tajos ir tukšumzīmes vai speciālās rakstzīmes, līdzīgi kā izmantojot funkciju EncodeURL.
Param nosaukumi ir reģistrjutīgi.
Param nosaukumus un vērtības automātiski dekodēs ar URL lietošanai jūsu programmā.
Parametru vērtības nemainās, ja vien programma netiek atkārtoti ielādēta. Izmantojot palaišanu mobilajā ierīcē, kurā programma jau darbojas, parametri netiek atsvaidzināti.
Pat tad, ja parametram ir skaitlis, pēc Param atgrieztais skaitlis vienmēr būs teksta virkne. Konvertēšana uz citiem veidiem notiek automātiski vai izmanto tiešu konvertēšanu, piemēram funkciju Value, lai skaidri pārvērstu par skaitli.

Piezīmes

Pielāgotām lapām vienīgie lapā akceptētie parametri ir: recordId un entityName.

Sintakse

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

Adrese – Obligāti. Tīmekļa lapas adrese vai palaižamās programmas ID.
ParameterName(s) – Neobligāti. Parametra nosaukums.
ParameterValue(s) – Neobligāti. Atbilstošās parametra vērtības, kuras nodot programmai vai tīmekļa lapai.

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

Adrese – Obligāti. Tīmekļa lapas adrese vai palaižamās programmas ID.
ParameterName(s) – Neobligāti. Parametra nosaukums.
ParameterValue(s) – Neobligāti. Atbilstošās parametra vērtības, kuras nodot programmai vai tīmekļa lapai.
LaunchTarget – Neobligāti. LaunchTarget uzskaitījuma vērtība vai pielāgots nosaukums.

Param( ParameterName )

ParameterName — Obligāti. Programmai padotā parametra nosaukums.

Rezervētie parametri

Šie atslēgvārdi ir rezervēti (neatkarīgi no pieteikuma) iekšējai lietošanai, un tos nevajadzētu izmantot kā pielāgotu parametru funkcijā Param():

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
lokalizācija
atrašanās vieta
packagekind
packageproperties
playerresourcespath
playersessionid
powerappslanguage
screencolor
sdkversion
vietne
skipappmetadata
skipiframecreation
skiplaunchappcache
avots
Avota laiks
standaloneconsent
teamid
teamtype
tenantId
dizains
uselocalpackagehostresources
userteamrole

Piemēri

Vienkārša palaišana

No pamatnes programmas uz tīmekļa lapu:

Formula	Apraksts
Launch( "http://bing.com/search", "q", "Power Apps", "count", 1 )	Atver tīmekļa lapu https://bing.com/search?q=Power%20Apps& skaits=1. Tiek atvērts jauns logs vai cilne.
Launch( "http://bing.com/search", { q: "Power Apps", count: 1 } )	Tāds pats kā iepriekšējos piemēros, izmantojot līdzvērtīgu ieraksta apzīmējumu. Tiek atvērts jauns logs vai cilne.
Launch( "http://bing.com/search", { q: "Power Apps", count: 1 }, LaunchTarget.Replace )	Tāds pats, kā iepriekšējos piemēros aizstājot pašreizējo logu vai cilni ar rezultātu, ja ir palaists tīmekļa pārlūkā.
Launch( "http://bing.com/search", { q: "Power Apps", count: 1 }, "Meklēšanas rezultāti" )	Tāds pats, kā iepriekšējā piemērā, izveidojot vai aizstājot loga vai cilnes ar nosaukumu Meklēšanas rezultāti saturu.

No pamatnes programmas uz pamatnes programmu

Pēc nepieciešamības atjauniniet programmas ID, segvārdu un ieraksta numuru.

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

No tīmekļa lapas uz pamatnes programmu

Pēc nepieciešamības atjauniniet programmas ID, nomnieka ID, segvārdu un ieraksta numuru.

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

Vienkārša Param

Vienkāršas palaišanas paraugi augstāk, lai palaistu pamatnes programmu no tīmekļa lapas vai no citas pamatnes programmas, parāda vienkāršu paraugus Param funkcijai:

Formula	Apraksts	Rezultāts
Param( "Navigate" )	Parametrs Naviģēt tika nodrošināts, kad programma tika palaista, un tas tiek atgriezts.	"Otrais ekrāns"
Param( "Record" )	Parametrs Ieraksts tika nodrošināts, kad programma tika palaista, un tas tiek atgriezts. Lai gan to funkcijai Launch nodeva kā skaitli, rezultāts no Param būs teksta virkne ko var tieši vai netieši konvertēt uz citiem veidiem.	"34"
Param( "User" )	Lietotāja parametrs netika nodrošināts. Tiek atgriezta tukša vērtība, ko var testēt ar funkciju IsBlank.	tukšs

Soli pa solim piemēri funkcijām Launch un Param

Šajos piemēros ir izmantota planšetdatora izkārtojuma veidne Preču vitrīna. Lai izveidotu programmu ar šo veidni, izpildiet darbības, kas aprakstītas rakstā programmas izveide un atlasiet veidni Preču vitrīna. Varat arī izmantot paši savu programmu.

Piemērs - Palaišana

Dodieties uz Power Apps.
Kreisās puses navigācijas rūtī atlasiet Programmas.
Atlasiet savu programmu un pēc tam atlasiet Rediģēt.
Izvēlnē atlasiet Ievietot un pēc tam atlasiet Etiķete.
Pārvietojiet etiķeti uz ekrāna apakšējo labo pusi.
Rekvizītu rūtī, kas atrodas labajā pusē, atlasiet Krāsu kā balta un iestatiet Apmales biezumu uz 1.
Atlasiet rekvizītu Teksts no labās puses un ievadiet tekstu, kā Surface planšetes jaunumos.
Rekvizītu sarakstā augšējā kreisajā pusē atlasiet OnSelect.
Ievadiet formulu kā Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). Varat arī izvēlēties jebkuru citu URL, parametru un atslēgvārdus.
Saglabājiet programmu un to publicējiet.
Palaidiet programmu.
Atlasiet etiķeti Surface planšetes jaunumos, lai uzsāktu ziņu meklēšanu ar atslēgvārdiem Microsoft Surface planšetes.

Padoms

Lai nodrošinātu mērogojamību, varat aizstāt Launch funkcijā manuāli ievadītos atslēgvārdus ar mainīgajiem.

Piemērs - Param

Dodieties uz Power Apps.
Kreisās puses navigācijas rūtī atlasiet Programmas.
Atlasiet savu programmu un pēc tam atlasiet Rediģēt.
Izvēlnē atlasiet Ievietot un pēc tam atlasiet Etiķete.
Pārvietojiet etiķeti uz ekrāna apakšējo labo pusi.
Atlasiet etiķetes rekvizītu Teksts no augšējās kreisās puses.
Ievadiet formulu kā Param("browser"). Varat arī izmantot citu parametru pēc izvēles.
Saglabājiet programmu un to publicējiet.
Kopējiet tīmekļa saiti savai programmai no Power Apps.
Atveriet jaunu pārlūku.
Ielīmējiet programmas tīmekļa saiti pārlūkprogrammā un beigās pievienojiet &browser=Microsoft%20Edge.
Kad tiek palaista programma, etiķete parāda nodoto parametra vērtību.
Aizveriet programmas atskaņotāju un rediģējiet programmu.
Kreisajā navigācijā koka skatā atlasiet Programma no koka skata kreisās puses navigācijā.
Augšējā kreisajā stūrī atlasiet rekvizītu StartScreen .
Ievadiet formulu kā If( Param("screen") = "techspecs", TechSpecs ).

Ja funkcija StartScreen rekvizītā pārbauda, vai parametrs ir vienāds ar noteiktu vērtību, šajā gadījumā vērtību techspecs. Un, ja tā atbilst, atgriež TechSpecs ekrāna vadīklu uz rekvizītu StartScreen .

Piezīmes

Aizstājiet funkcijas If vadīklas nosaukumu TechSpecs ar ekrāna vadīklas nosaukumu savā programmā, ja neizmantojat programmas veidni Produktu skates .
Saglabājiet programmu un to publicējiet.
Atveriet jaunu pārlūku.
Ielīmējiet programmas tīmekļa saiti pārlūkprogrammā un beigās pievienojiet &screen=techspecs.
Lietotne tiek palaista tieši ar TechSpecs kā sākuma ekrānu.