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

Статия
03/22/2024

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

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

Стартиране

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

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

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

Бележка

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

Адрес

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

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

Можете да стартирате платно приложения с уеб връзка или App URI (приложение ID префикс с /providers/Microsoft.PowerApps/apps/). За да намерите тези стойности за приложение:

Отидете на Power Apps.
В левия навигационен екран изберете Приложения.
Изберете приложението си.
Изберете Подробности от горното меню.
Можете също да изберете ... (Още команди) и след това изберете Подробности от падащото меню.
Копиране на уеб връзка.

Уеб линк може да се използва във всяка уеб страница и ще стартира приложението за платното. Може да се използва и с функцията 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.

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

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

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

Цел

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

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

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

Бележка

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

Синтаксис

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

Address – Задължително. Адресът на уеб страница или идентификационният номер на приложение, което да стартирате.
ParameterName(s) – Опционално. Име на параметър.
ParameterValue(s) – Опционално. Съответстващи стойности на параметри, които трябва да се предадат на приложението или уеб страницата.

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

Address – Задължително. Адресът на уеб страница или идентификационният номер на приложение, което да стартирате.
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
подсказване
hostclienttype
hostmode
iframecontainerid
isfullscreen
ispreviewmode
loader
loaderType
езикова променлива
местоположение
packagekind
packageproperties
playerresourcespath
playersessionid
powerappslanguage
screencolor
sdkversion
сайт
skipappmetadata
skipiframecreation
skiplaunchappcache
източник
sourcetime
standaloneconsent
teamid
teamtype
tenantId
тема
uselocalpackagehostresources
userteamrole

Примери

Прост старт

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

Формула	Описание
Launch( "http://bing.com/search", "q", "Power Apps", "count", 1 )	Отваря уеб страницата 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 }, "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" )	Параметърът Navigate е предоставен, когато приложението е стартирано и е върнато.	"Втори екран"
Param( "Record" )	Параметърът Record е предоставен, когато приложението е стартирано. Въпреки че е предаден като номер на Launch функция, резултатът от Парам ще бъде текстов низ, който може да бъде имплицитно или изрично преобразуван в други типове.	"34"
Param( "User" )	Параметърът User не бе предоставен. Стойност празно се връща, която може да бъде тествана с IsBlank функция.	blank

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

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

Пример - Launch

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

Бакшиш

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

Пример - Param

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

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

Бележка

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