Launch un Param funkcijas

Attiecas uz: Audekla programmām

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

Launch

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

Adrese (nepieciešams), audekla programmas tīmekļa lapas vietrādis URL.
Parametri (neobligāti), nosauktas vērtības, kas jānodod tīmekļa lapai vai audekla programmai. Audekla programmā parametrus var nolasīt, Param izmantojot šo funkciju.
Target (optional), pārlūkprogrammas cilne, kurā palaist tīmekļa lapu vai audekla programmu.

Launch Var izmantot tikai uzvedības formulās.

Piezīmes

Ja Launch formula tiek izmantota, lai atvērtu Power Apps, un programma nav redzama lietotājam, ieteicams pārbaudīt, vai programmu bloķē pārlūkprogrammas uznirstošo logu bloķētājs vai arī pārlūkprogramma gaida lietotāja atbildi uz dialoglodziņu, kurā tiek jautāts, vai lietotājs vēlas naviģēt uz jaunu ekrānu.
Tikai https: URI tiek atbalstīti, lietojot Launch Power Apps vizuālajā programmā PowerBI.

Adrese

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

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

Varat palaist audekla programmas ar Web saistīt vai App 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ēt Web saistīt.

Tīmekļa saiti var izmantot jebkurā tīmekļa lapā, un tā palaidīs pamatnes programmu. To var izmantot arī ar Launch šo funkciju. Piemēram:

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

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 audekla programmai. Parametrus var nodrošināt divos veidos:

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

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

Lauka vērtību ieraksts. Piemēram:
```
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 Launch norādīti, 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
Jauns	Tīmekļa lapa vai programma tiek atvērta jaunā logā vai cilnē.
Aizstāt	Tīmekļa lapa vai programma aizstāj pašreizējo logu vai cilni.
vārds	Uzskaitījuma vērtības vietā izmantojiet savu teksta virkni, lai nosauktu logu vai cilni. Self ir tikai iekšējs nosaukums, ko izmanto tikai 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. vārds nevar sākties ar pasvītrojuma rakstzīmi "_".

Jauns ir noklusējuma uzskaitījums, kas tiek palaists tīmekļa pārlūkprogrammā ar opcijām Aizstāt un nosaukumu kā pieejamajā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.

Piezīmes

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, kad tā tika palaita. Ja nosauktais parametrs netika nodots, Param atgriežas tukšs.

Palaižot audekla programmu no citas audekla programmas, izmantojiet funkcijas argumentus ParametrsLaunch. 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 nosaukumi un vērtības tiks automātiski dekodēti URL izmantošanai jūsu lietotnē.
Parametru vērtības nemainās, ja vien programma netiek atkārtoti ielādēta. Izmantojot Launch mobilo ierīci, kurā lietotne jau darbojas, parametri netiek atsvaidzināti.
Pat ja parametrā ir skaitlis, atgrieztais Param tips 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āts. Tīmekļa lapas adrese vai palaižamās programmas ID.
Parametru nosaukumi - pēc izvēles. Parametra nosaukums.
Parametru_vērtības – pēc izvēles. Atbilstošās parametra vērtības, kuras nodot programmai vai tīmekļa lapai.

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

Adrese – Obligāts. Tīmekļa lapas adrese vai palaižamās programmas ID.
Parametru nosaukumi - pēc izvēles. Parametra nosaukums.
Parametru_vērtības – pēc izvēles. Atbilstošās parametra vērtības, kuras nodot programmai vai tīmekļa lapai.
LaunchTarget - pēc izvēles. LaunchTarget uzskaitījuma vērtība vai pielāgots nosaukums.

Param( Parametra nosaukums )

ParametrsNosaukums - nepieciešams. Programmai padotā parametra nosaukums.

Rezervētie parametri

Tālāk norādītie atslēgvārdi ir rezervēti (neatkarīgi no reģistra) iekšējai lietošanai, un tos nedrīkst izmantot kā pielāgotu parametru Param funkcijā ():

amp%3Bauthmode
amp%3Benableonbehalfof
amp%3Bhidenavbar
amp%3Blocale
appmetadataversion
authmode
channeltype
cordovapath
correlationid
atkļūdot
delegatelaunchurl
delegatelaunchurl
disablepreviewredirect
embedderorigin
enableonbehalfof
groupid
hideappsplash
hidenavbar
ieteikums
hostclienttype
hostmode
iframecontainerid
isfullscreen
ispreviewmode
loader
loaderType
lokalizācija
atrašanās vieta
packagekind
packageproperties
playerresourcespath
playersessionid
powerappslanguage
screencolor
sdkversion
vieta
skipappmetadata
skipiframecreation
skiplaunchappcache
avots
Avota laiks
standaloneconsent
teamid
teamtype
tenantId
tēma
uselocalpackagehostresources
userteamrole

Piemēri

Vienkāršs Launch

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", skaits: 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", skaits: 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", skaits: 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šs Param

Iepriekš minētie vienkāršie palaišanas piemēri, lai palaistu audekla programmu no tīmekļa lapas vai citas audekla programmas , parāda vienkāršus funkciju piemērus Param :

Formula	Apraksts	Rezultāts
Param( "Navigēt" )	Parametrs Naviģēt tika nodrošināts, kad programma tika palaista, un tas tiek atgriezts.	"Otrais ekrāns"
Param( "Ieraksts")	Parametrs Ieraksts tika nodrošināts, kad programma tika palaista, un tas tiek atgriezts. Pat ja tas tika nodots funkcijai Launch kā skaitlis, rezultāts būs Param teksta virkne, kuru var netieši vai netieši pārvērst citos tipos.	"34"
Param("Lietotājs")	Lietotāja parametrs netika nodrošināts. Tiek atgriezta tukša vērtība, ko var testēt ar funkciju IsBlank.	Tukša

Soli pa solim Launch piemēri 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- Launch

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

Mērogojamības labad varat aizstāt manuāli ievadītos atslēgvārdus funkcijā Launch 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 nosaukumuTechSpecs 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.

Skatiet arī:

Pamatnes programmas formulas atsauce

Atsauksmes

Vai šī lapa palīdzēja?

Last updated on 2025-10-10

Kopīgot, izmantojot

Launch un Param funkcijas

Launch

Adrese

Parametri

Mērķis

Param

Sintakse

Rezervētie parametri

Piemēri

Vienkāršs Launch

No pamatnes programmas uz tīmekļa lapu:

No pamatnes programmas uz pamatnes programmu

No tīmekļa lapas uz pamatnes programmu

Vienkāršs Param

Soli pa solim Launch piemēri un Param

Piemērs- Launch

Piemērs- Param

Skatiet arī:

Atsauksmes

Papildu resursi