Лаунцх и Парам функције

Чланак
10/16/2024

Односи се на: Цанвас апликације

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

Покретање

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

Адреса (обавезно ), УРЛ веб странице апликације платна.
Параметри (опционо), назване вредности које ће проћи на веб страницу или апликацију платна. У апликацији са подлогом, параметри се могу очитати помоћу функције Param.
Таргет (опционо), картица претраживача у којој се покрене веб страница или апликација платна.

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

Белешка

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

Адресу

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

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

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

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

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

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

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

Параметри

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

Листа аргумената парова вредности имена. На пример:
```
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	Опис
Нови	веб-страница или апликација отвара се у новом прозору или на новој картици.
Замени	веб-страница или апликација мења тренутни прозор или картицу.
Име	Уместо нумеричке вредности, користите свој текстуални низ за назив прозора или картице. Self је само интерно име које користи само функција Launch. Она не утиче нити ће се подударати са насловом прозора који ваши корисници виде. Ако прозор или картица са датим именом већ постоји, њихов садржај ће бити замењен. У супротном, креираће се нови прозор или картица. име не може да почне са знаком подвлаке "_".

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

Белешка

Коришћење функције 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 за експлицитно претварање у број.

Белешка

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

Синтакса

Лаунцх (Аддресс [, ParameterName1,ParameterValue1 , ... ] )

Адреса – Обавезно. Адреса веб-странице или ID апликације за покретање.
ПараметерНамес – Опционо. Назив параметра.
ПараметерВалуес – Опционо. Одговарајуће вредности параметара које треба пренети на апликацију или веб-страницу.

Лаунцх ( Адреса , { [ ParameterName1 : ParameterValue1, ... ] } [, ЛаунцхТаргет ] )

Адреса – Обавезно. Адреса веб-странице или ID апликације за покретање.
ПараметерНамес – Опционо. Назив параметра.
ПараметерВалуес – Опционо. Одговарајуће вредности параметара које треба пренети на апликацију или веб-страницу.
ЛаунцхТаргет – Опционо. Нумеричка вредност LaunchTarget или обичај име.

Парам( ПараметерНаме )

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

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

Следеће кључне речи су резервисане (без обзира на величину слова) за интерну употребу и не би требало да се користе као прилагођени параметар у функцији 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

Примери

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

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

Формула	Опис
Лаунцх ( " http://bing.com/search", "q", "Power Apps", "count", 1 )	Отвара веб страницу https://bing.com/search?q=Power%20Apps& цоунт = 1. Отвара се нови прозор или картица.
Лаунцх ( " http://bing.com/search", { q: "Power Apps", count: 1 } )	Исто као у претходним примерима користећи еквивалентну ноту записа. Отвара се нови прозор или картица.
Лаунцх ( " http://bing.com/search", { q: "Power Apps", count: 1 }, LaunchTarget.Replace )	Исто као у претходним примерима, заменићемо тренутни прозор или картицу резултатом ако се покреће у веб-прегледачу.
Лаунцх ( " 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:

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

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

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

Пример – Launch

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

Савет

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

Пример – Param

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

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

Белешка

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