Функции за стартиране и параметър

Статия
10/16/2024

Отнася се за: Приложения за платно

Стартира уеб страница или приложение за платно и осигурява достъп до параметри за стартиране.

Стартиране

Стартира уеб страница или приложение за платно. Функцията поддържа:

Адрес (задължително), URL адресът на уеб страницата на приложението за платно.
Параметри (по избор), именувани стойности за предаване на уеб страницата или приложението за платно. В приложението за платно параметрите могат да бъдат прочетени с Param функция.
Target (по избор), разделът на браузъра, в който да стартирате уеб страницата или приложението за платно.

Launch може да се използва само във формули за поведение.

Бележка

Ако формулата за стартиране се използва за отваряне Power Apps и приложението не се вижда от крайния потребител, препоръчително е да проверите дали приложението е блокирано от блокиране на изскачащи прозорци в браузъра или дали браузърът изчаква отговора на потребителя на диалогов прозорец, който пита дали иска да навигира до нов екран.

Адрес

Уеб страниците се стартират чрез URL адрес. Например:

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

Можете да стартирате приложения за платно с уеб връзка или URI на приложение (идентификатор на приложение с префикс). /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.

Адресът и параметрите са кодирани URL, преди да бъдат предадени, за да се заменят някои не буквено-цифрови символи с % и шестнадесетично число, като че ли EncodeUrl функция е използвана за всеки.

Когато стартирате уеб страница, низ за заявка от параметрите могат да бъдат включени в края на URL адреса. Всички допълнителни параметри, предоставени на Launch, ще бъде добавен в края на низа на заявката. Низовете на заявките не работят, когато стартирате приложение за платно.

Когато стартирате приложение на мобилно устройство, на което вече се изпълнява, параметрите няма да се обновяват в работещото приложение. За обновяване на параметрите е необходимо презареждане на приложението.

Цел

Използвайте аргумента LaunchTarget, за да посочите целевия прозорец на браузъра, в който да отворите уеб страницата или приложението. Използвайте едно от следните стойности на изброявания LaunchTarget или предоставете персонализиран прозорец име.

Изброяване LaunchTarget	Описание
Нов	Уеб страницата или приложението се отваря в нов прозорец или раздел.
Заменям	Уеб страницата или приложението заменя текущия прозорец или раздел.
Име	Вместо стойност на изброяване, използвайте свой собствен текстов низ за име прозореца или раздела. себе си е само вътрешно име, което се използва само от Launch функция. Това няма никакво влияние, нито ще съответства на заглавието на прозореца, което виждат вашите потребители. Ако прозорец или раздел с даденото име вече съществува, съдържанието му ще бъде заменено. В противен случай ще бъде създаден нов прозорец или раздел. Името не може да започва със знака за долна черта "_".

New е изброяването по подразбиране при изпълнение в уеб браузър с опции Replace и name as available. В мобилен плейър, New е по подразбиране за уеб страници с име като налична опция; докато текущото приложение за платно винаги ще бъде заменено с друго приложение за платно.

Бележка

Използване на LaunchTarget с всякаква стойност, различна от New във вградени сценарии (например, 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 винаги ще бъде текстов низ. Преобразуването в други типове автоматично ще се случи или ще се използват изрични конверсии, като например Value функция за преобразуване изрично в число.

Бележка

За персонализирани страници единствените параметри, приети от страницата, са: recordId и entityName.

Синтаксис

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

Адрес – Задължително. Адресът на уеб страница или идентификационният номер на приложение, което да стартирате.
ParameterNames – По избор. Име на параметър.
ParameterValues – по избор. Съответстващи стойности на параметри, които трябва да се предадат на приложението или уеб страницата.

Launch(Адрес;[ParameterName1: ParameterValue1;... ] { } [, LaunchTarget ] )

Адрес – Задължително. Адресът на уеб страница или идентификационният номер на приложение, което да стартирате.
ParameterNames – По избор. Име на параметър.
ParameterValues – по избор. Съответстващи стойности на параметри, които трябва да се предадат на приложението или уеб страницата.
LaunchTarget – По избор. Стойност на изброяване на LaunchTarget или персонализирано име.

Param( Име на параметър)

ParameterName - Задължително. Името на параметъра, подаден към приложението.

Запазени параметри

Следните ключови думи са запазени (независимо от регистъра на буквите) за вътрешна употреба и не трябва да се използват като персонализиран параметър във функцията Param():

amp%3Bauthmode
amp%3Benableonbehalfof
amp%3Bhidenavbar
amp%3Blocale
appmetadataversion
authmode
channeltype
cordovapath
correlationid
debug
delegatelaunchurl
delegatelaunchurl
disablepreviewredirect
embedderorigin
enableonbehalfof
groupid
hideappsplash
hidenavbar
подсказване
hostclienttype
hostmode
iframecontainerid
isfullscreen
ispreviewmode
loader
loaderType
езикова променлива
местоположение
packagekind
packageproperties
playerresourcespath
playersessionid
powerappslanguage
screencolor
sdkversion
сайт
skipappmetadata
skipiframecreation
skiplaunchappcache
източник
Време за източник
standaloneconsent
teamid
teamtype
tenantId
тема
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 }, "Search Results" )	Същият като предишния пример, създаване или замяна на съдържанието на прозореца или раздела с име Резултати от търсенето.

От приложение за платно към приложение за платно

Актуализирайте идентификационния номер на приложението, името на екрана и номера на записа, според случая.

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

От уеб страница към приложение за платно

Актуализирайте идентификационния номер на приложението, ИД на клиента, името на екрана и номера на записа, според случая.

<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 е предоставен, когато приложението е стартирано и е върнато.	"Втори екран"
Param( "Запис" )	Параметърът Record е предоставен, когато приложението е стартирано. Въпреки че е предаден като номер на Launch функция, резултатът от Парам ще бъде текстов низ, който може да бъде имплицитно или изрично преобразуван в други типове.	"34"
Param( "Потребител" )	Параметърът User не бе предоставен. Стойност празно се връща, която може да бъде тествана с IsBlank функция.	интервал

Стъпка по стъпка примери за стартиране и Param

шаблон за оформление на таблета Витрина на продукта е използван за следните примери. За да създадете приложение с този шаблон, следвайте стъпките от създайте приложение статията и изберете Витрина на продукта шаблон. Можете също да използвате собствено приложение.

Пример - Launch

Отидете на Power Apps.
В левия навигационен екран изберете Приложения.
Изберете приложението си, след което изберете Редактиране.
Изберете Вмъкване от менюто и след това изберете Етикет.
Преместете етикета долу вдясно на екрана.
От панела със свойствата вдясно изберете цвят като бял и задайте Дебелина на границата на 1.
Изберете свойството Текст от дясната страна и въведете текст като Повърхностни таблети в новини.
От списъка със собствености горе вляво изберете OnSelect.
Въведете формула като Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). Можете също така да използвате всеки друг URL адрес, параметър и ключови думи по ваш избор.
Записване и публикуване на приложение.
Изпълнение на приложението.
Изберете етикет Surface таблети в новини , за да стартирате търсене на новини с ключови думи Microsoft Surface таблети.

Съвет

За мащабируемост можете да замените ръчно въведените ключови думи във функцията за стартиране с променливи.

Пример - Param

Отидете на Power Apps.
В левия навигационен екран изберете Приложения.
Изберете приложението си, след което изберете Редактиране.
Изберете Вмъкване от менюто и след това изберете Етикет.
Преместете етикета долу вдясно на екрана.
Изберете Текст свойство за етикета горе вляво.
Въведете формула като Param("browser"). Можете също да използвате различен параметър по ваш избор.
Записване и публикуване на приложение.
Копирайте уеб линк за приложението ви от Power Apps.
Отваряне в нов браузър.
Поставете уеб връзката на приложението в браузъра и добавете &browser=Microsoft%20Edge накрая.
Когато вашето приложение се стартира, етикетът показва стойността на параметъра, предадена.
Затворете плейъра на приложението и редактирайте приложението.
Изберете Приложение от изглед на дървото вляво за навигация.
Изберете свойството StartScreen горе вляво.
Въведете формулата като If( Param("screen") = "techspecs", TechSpecs ).

Ако функцията в свойството StartScreen проверява дали параметърът е равен на определена стойност, в този случай стойността techspecs. И ако съвпада, връща контролата на екрана на TechSpecs към свойството StartScreen .

Бележка

Заменете името на контролата TechSpecs във функцията If с името на екранна контрола във вашето собствено приложение, ако не използвате шаблона на приложението Product Showcase .
Записване и публикуване на приложение.
Отваряне в нов браузър.
Поставете уеб връзката на приложението в браузъра и добавете &screen=techspecs накрая.
Приложението се стартира директно с TechSpecs като начален екран.