Функције покретања и парам-а

Чланак
03/22/2024

Важи за: Цанвас апликације

Покреће веб-страницу или апликацију са подлогом и пружа приступ параметрима за покретање.

Покретање

Покреће веб-страницу или апликацију подлоге. Функција подржава:

Адреса (обавезно ), УРЛ адреса Веб странице апликације подлоге за цртање.
Parameters (опционално), именоване вредности које се прослеђују на веб-страницу или у апликацију са подлогом. У апликацији са подлогом, параметри се могу очитати помоћу функције Param.
Target (опционално), картица прегледача на којој се покреће веб-страница или апликација са подлогом.

Launch се може користити само у формулама понашања.

Белешка

Ако се формула "Покрени" користи за отварање Power Apps , а апликација није видљива крајњем кориснику, препоручује се да проверите да ли је апликација блокирана од стране блокатора искачућих прозора прегледача или прегледач чека одговор корисника у дијалогу који поставља питање да ли желе да се крећу до новог екрана.

Адресу

веб-странице се покрећу путем URL адресе. На пример:

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

Апликације подлоге за цртање можете да покренете помоћу Wеб линка или Апп УРИ (ИД апликације са којима је префиксиран /providers/Microsoft.PowerApps/apps/). Да бисте пронашли ове вредности за апликацију:

Иди на Power Apps.
Изаберите Апликације у левом окну за навигацију.
Изаберите апликацију.
Изаберите Детаљи из горњег менија.
Такође можете да изаберете ... (Још команди), а затим изаберите Детаљи у падајућем менију.
Копирај Wеб везу.

Веб-веза се може користити на било којој веб-страници и покренуће апликацију са подлогом. Такође се може користити са функцијом Launch. На пример:

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

Матичне апликације на уређају не могу се директно покренути. На неким платформама могу бити индиректне опције, попут матичне апликације која инсталира прилагођену URL шему, или се региструју помоћу веб-прегледача како би се понудила опција за одређене веб-локације.

Параметри

Launch може да проследи параметре на веб-страницу или на апликацију са подлогом. Параметри се могу креирати на два начина:

Листа аргумената парова вредности имена. На пример:
```
Launch( "https://bing.com/search", "q", "Power Apps", "count", 1 )
```
Запис вредности поља. На пример:
```
Launch( "https://bing.com/search", { q: "Power Apps", count: 1 } )
```
Овај образац може бити лакши за рад, јер чини повезивање између имена и вредности јаснијим. То је једини облик који подржава опционални аргумент LaunchTarget.

Адреса и параметри се кодирају пре него што се проследе како би се заменили одређени неалфанумерички знакови са % и хексадецималним бројем, као да је на сваком од њих коришћена функција EncodeUrl.

Приликом покретања веб-странице, ниска упита са параметрима може бити укључени на крају URL адресе. Било који додатни параметри у функцији Launch биће додати на крају низа упита. Низови упита не раде приликом покретања апликације са подлогом.

Приликом покретања апликације на мобилном уређају где је та апликација већ покренута, параметри неће бити освежени у покренутој апликацији. Потребно је поновно учитавање апликације да би параметри били освежени.

Циљ

Користите аргумент LaunchTarget да бисте одредили прозор циљаног прегледача у којем треба да отворите веб-страницу или апликацију. Користите једну од следећих нумеричких вредност LaunchTarget или наведите назив прилагођеног прозора.

Нумерички параметар LaunchTarget	Опис
New	веб-страница или апликација отвара се у новом прозору или на новој картици.
Replace	веб-страница или апликација мења тренутни прозор или картицу.
name	Уместо нумеричке вредности, користите свој текстуални низ за назив прозора или картице. Self је само интерно име које користи само функција Launch. Она не утиче нити ће се подударати са насловом прозора који ваши корисници виде. Ако прозор или картица са датим именом већ постоји, њихов садржај ће бити замењен. У супротном, креираће се нови прозор или картица. име не може да почиње доњом цртом „_“.

New је подразумевано набрајање када се покреће у веб-прегледачу са доступним опцијама Replace и name. У плејеру за мобилне уређаје,Ново је подразумевано за веб-странице са једином доступном опцијом назив; док ће тренутну апликацију са подлогом увек заменити друга апликација са подлогом.

Белешка

Коришћење функције LaunchTarget са било којом вредношћу осим Ново у уграђеним сценаријима (на пример, Power BI или SharePoint) није подржано и може довести до неочекиваног понашања. У будућности се такво понашање може променити или узроковати грешку.

Param

Функција Param преузима параметар који је прослеђен апликацији приликом покретања. Ако именовани параметар није прослеђен, Param враћа празно.

Када покрећете апликацију са подлогом из друге апликације са подлогом, користите аргументе Параметар у функцији Launch. Називи и вредности параметара аутоматски ће се кодирати путем URL адресе.
Када покрећете апликацију са подлогом са веб-странице, додајте параметре у ниску упита у веб-везу апликације са подлогом. Ово укључује додавање &parametername=parametervalue, под претпоставком да је низ упита већ покренут за tenantId. На пример, додавањем &First%20Name=Vicki&category=3 прошла би два параметра: First Name са вредности од "Vicki" и category са вредности од "3" (тип вредности је текст). Назив и вредност параметра морају бити кодирани URL ако садрже размаке или посебне знакове, слично употреби функције EncodeURL.
Param имена разликују велика и мала слова.
Param имена и вредности аутоматски се декодирају за употребу у вашој апликацији.
Вредности параметара се не мењају уколико се апликација поново не учита. Коришћење функције " Покрени" на мобилном уређају на којем је апликација већ покренута не освежава параметре.
Чак и ако параметар садржи број, тип који враћа Param увек ће бити текстуални низ. Конверзија у друге врсте ће се аутоматски догодити или користити експлицитне конверзије, као што је функција Value за експлицитно претварање у број.

Белешка

За прилагођене странице , једини параметри које је страница прихватила су: ИД записа и име ентитета.

Синтакса

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

Address – Обавезно. Адреса веб-странице или ID апликације за покретање.
ParameterName(s) – Опционално. Назив параметра.
ParameterValue(s) – Опционално. Одговарајуће вредности параметара које треба пренети на апликацију или веб-страницу.

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

Address – Обавезно. Адреса веб-странице или ID апликације за покретање.
ParameterName(s) – Опционално. Назив параметра.
ParameterValue(s) – Опционално. Одговарајуће вредности параметара које треба пренети на апликацију или веб-страницу.
LaunchTarget – Опционално. Нумеричка вредност LaunchTarget или обичај име.

Param( ParameterName )

ParameterName – Обавезно. Назив параметра је прешао на апликацију.

Резервисани параметри

Следеће кључне речи су резервисане (без обзира на величину слова) за интерну употребу и не би требало да се користе као прилагођени параметар у функцији 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
locale
локација
packagekind
packageproperties
playerresourcespath
playersessionid
powerappslanguage
screencolor
sdkversion
site
skipappmetadata
skipiframecreation
skiplaunchappcache
извор
изворно време
standaloneconsent
teamid
teamtype
tenantId
theme
uselocalpackagehostresources
userteamrole

Примери

Једноставно покретање

Креирање апликације са подлогом, до веб-странице

Формула	Опис
Launch( "http://bing.com/search", "q", "Power Apps", "count", 1 )	Отвара Wеб страницу https://bing.com/search?q=Power%20Apps& цоунт=1. Отвара се нови прозор или картица.
Launch( "http://bing.com/search", { q: "Power Apps", count: 1 } )	Исто као у претходним примерима користећи еквивалентну ноту записа. Отвара се нови прозор или картица.
Launch( "http://bing.com/search", { q: "Power Apps", count: 1 }, LaunchTarget.Replace )	Исто као у претходним примерима, заменићемо тренутни прозор или картицу резултатом ако се покреће у веб-прегледачу.
Launch( "http://bing.com/search", { q: "Power Apps", count: 1 }, "Резултати претраге" )	Исто као у претходном примеру, креирање или замена садржаја прозора или картице под називом Резултати претраге.

Креирање апликације са подлогом

Ажурирајте ID апликације, име екрана и број записа по потреби.

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

Креирање веб-странице до апликације са подлогом

Ажурирајте ID апликације, ID закупца, име екрана и број записа по потреби.

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

Једноставни Param

Једноставни примери изнад за покретање апликације са подлогом са веб-странице или из друге апликације са подлогом показују једноставне примере за функцију Param:

Формула	Опис	Резултат
Param( "Navigate" )	Параметар Navigate је дат када је апликација покренута и враћа се.	"Други екран"
Param( "Record" )	Параметар Record је дат када је апликација покренута. Иако је овај број прослеђен као број у функцију Launch, резултат из функције Param ће бити текстуални низ који се може имплицитно или експлицитно претворити у друге типове.	"34"
Param( "User" )	Параметар User није наведен. Враћа се вредност празно која се може тестирати са функцијом IsBlank.	blank

Поступни примери за функције Launch и Param

Предложак распореда таблета Излог производа коришћен је за следеће примере. Да бисте креирали апликацију са овим предлошком, следите кораке из чланка креирање апликације и изаберите предложак Излог производа. Такође можете да користите сопствену апликацију.

Пример – Launch

Иди на Power Apps.
Изаберите Апликације у левом окну за навигацију.
Изаберите апликацију, а затим изаберите Уреди.
Изаберите Уметни у менију, а затим изаберите Ознака.
Преместите ознаку доле десно на екрану.
У окну са својствима на десној страни, изаберите Боја као бела и подесите Дебљина ивице као 1.
Изаберите својство Текст с десне стране и унесите текст као Surface таблети у вестима.
На листи својства у горњем левом углу, изаберите OnSelect.
Унесите формулу као Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). Можете користити и било које друге URL адресу, параметар и кључне речи по вашем избору.
Сачувајте и објавите апликацију.
Покретање апликације.
Изаберите ознаку Surface таблети у вестима за покретање вести са кључним речима Microsoft Surface таблети.

Савет

Ради скалабилности, можете да замените ручно унете кључне речи у функцији Launch помоћу променљивих.

Пример – Param

Иди на Power Apps.
Изаберите Апликације у левом окну за навигацију.
Изаберите апликацију, а затим изаберите Уреди.
Изаберите Уметни у менију, а затим изаберите Ознака.
Преместите ознаку доле десно на екрану.
Изаберите својство Текст за ознаку горе лево.
Унесите формулу као Param("browser"). Можете користити различити параметар по вашем избору.
Сачувајте и објавите апликацију.
Копирајте веб-везу за вашу апликацију у Power Apps.
Отворите у новом прегледачу.
Налепите везу веб-апликације у прегледач и додајте &browser=Microsoft%20Edge на крају.
Када се ваша апликација покрене, ознака приказује пренесену вредност параметра.
Затворите плејер апликације и уредите је.
Изаберите Апликација у приказу стабла на левој навигацији.
Са горње леве стране изаберите својство СтартСцреен .
Унесите формулу као If( Param("screen") = "techspecs", TechSpecs ).

Ако функција у својству СтартСцреен проверава да ли је параметар једнак одређеној вредности, у овом случају техови вредности. Ако се подудара, враћа ТецхСпецс контролу екрана у својство СтартСцреен .

Белешка

Замените име контроле ТецхСпецс у функцији "Ако " именом контроле екрана у сопственој апликацији ако не користите предложак апликације "Излог производа ".
Сачувајте и објавите апликацију.
Отворите у новом прегледачу.
Налепите везу веб-апликације у прегледач и додајте &screen=techspecs на крају.
Апликација се директно покреће са ТецхСпецс као почетним екраном.