Launch и Param функции

Применимо к: приложениям Canvas

Запускает веб-страницу или приложение на основе холста и предоставляет доступ к параметрам запуска.

Launch

Запускает веб-страницу или приложение на основе холста. Функция поддерживает:

• Адрес (обязательно), URL-адрес веб-страницы приложения Canvas.
• Параметры (необязательно), именованные значения для передачи на веб-страницу или в приложение Canvas. В приложении холста параметры можно считывать с Param помощью функции.
• Target (необязательно), вкладка браузера, в которой следует запустить веб-страницу или приложение Canvas.

Launch можно использовать только в формулах поведения.

Адрес

Веб-страницы запускаются через URL-адрес. Например:

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

Вы можете запустить приложения на основе холста с помощью веб-ссылки или URI приложения (ИД приложения с /providers/Microsoft.PowerApps/apps/). Чтобы найти эти значения для приложения:

1. Переход к Power Apps.

2. Выберите Приложения в левой области навигации.

3. Выберите приложение.

4. Выберите Сведения в верхнем меню.
   Вы также можете выбрать ... (Дополнительные команды), затем выберите Сведения из раскрывающегося меню.

   

5. Скопируйте Веб-ссылку.

   

Веб-ссылка может использоваться на любой веб-странице и запустит приложение на основе холста. Его также можно использовать с функцией 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 этого, будут добавлены в конец строки запроса. Строки запроса не работают при запуске приложения на основе холста.

При запуске приложения на мобильном устройстве, где оно уже запущено, параметры в работающем приложении не обновляются. Для обновления параметров требуется перезагрузка приложения.

Target

Используйте аргумент LaunchTarget для указания целевого окна браузера, в котором нужно открыть веб-страницу или приложение. Используйте одно из следующих значений перечисления LaunchTarget или укажите имя пользовательского окна.,

New является значением по умолчанию перечисление при запуске в веб-браузере с Заменить и название в качестве доступных параметров. В мобильном плеере Создать задано по умолчанию для веб-страниц с именем в качестве доступного варианта; в то время как текущее приложение на основе холста всегда будет заменено другим приложением на основе холста.

Param

Функция Param извлекает параметр, переданный приложению при запуске. Если именованный параметр не был передан, Param возвращает пустое значение.

• При запуске приложения холста из другого приложения холста используйте аргументы параметров для Launch функции. Имена и значения параметров будут автоматически закодированы в кодировке URL.
• При запуске приложения на основе холста с веб-страницы добавьте параметры в строку запросавеб-ссылки приложения на основе холста. Это включает в себя добавление &parametername=parametervalue при условии, что строка запроса уже была запущена для tenantId. Например, при добавлении &First%20Name=Vicki&category=3 будут передаваться два параметра: First Name со значением "Vicki" и category со значением "3" (тип значения — текст). Имя и значение параметра должны быть закодированы в кодировке URL, если они содержат пробелы или специальные символы, аналогично использованию функции EncodeURL.
• Param имена чувствительны к регистру.
• Param имена и значения автоматически декодируются ПО URL-адресу для использования в приложении.
• Значения параметров не изменяются, пока приложение не будет перезагружено. Использование Launch на мобильном устройстве, где приложение уже запущено, не обновляет параметры.
• Даже если параметр содержит число, тип, возвращаемый Param всегда будет текстовой строкой. Преобразование в другие типы будет происходить автоматически или использовать явные преобразования, такие как функция Value для явного преобразования в число.

Синтаксис

Launch( Адрес [, ParameterName1, ParameterValue1, ... ] )

• Адрес – Обязательно. Адрес веб-страницы или ИД приложения для запуска.
• ParameterNames – Необязательно. Имя параметра.
• Значения параметров – Необязательно. Соответствующие значения параметров для передачи в приложение или веб-страницу.

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

• Адрес – Обязательно. Адрес веб-страницы или ИД приложения для запуска.
• ParameterNames – Необязательно. Имя параметра.
• Значения параметров – Необязательно. Соответствующие значения параметров для передачи в приложение или веб-страницу.
• LaunchTarget – Необязательно. Значение перечисления LaunchTarget или пользовательское имя.

Param( ParameterName )

• ИмяПараметра - Обязательно. Имя параметра, переданного в приложение.

Зарезервированные параметры

Следующие ключевые слова зарезервированы (независимо от регистра) для внутреннего использования и не должны использоваться в качестве настраиваемого параметра в Paramфункции ().

• amp%3Bauthmode
• amp%3Benableonbehalfof
• amp%3Bhidenavbar
• amp%3Blocale
• appmetadataversion
• authmode
• channeltype
• cordovapath
• correlationid
• отладка
• 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
• source
• sourcetime
• standaloneconsent
• teamid
• teamtype
• tenantId
• theme
• uselocalpackagehostresources
• userteamrole

Примеры

Простой Launch

Из приложения на основе холста в веб-страницу:

Из приложения на основе холста в приложение на основе холста

Обновите идентификатор приложения, имя экрана и номер записи соответствующим образом.

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 функции:

Пошаговые примеры для Launch и Param

Шаблон макета планшета Витрина товаров был использован для следующих примеров. Чтобы создать приложение с этим шаблоном, выполните действия из статьи о создании приложения и выберите шаблон Витрина товаров. Также можно использовать собственное приложение.

Пример- Launch

1. Переход к Power Apps.

2. Выберите Приложения в левой области навигации.

3. Выберите свое приложение, затем выберите Изменить.

4. Выберите Вставить в меню, затем выберите Label.

5. Переместите метку в правый нижний угол экрана.

6. На панели свойств справа выберите Цвет как белый и установить для параметра Толщина границы значение 1.

7. Выберите свойство Text справа и введите текст как Планшеты Surface в новостях.

8. Из списка свойств слева вверху выберите OnSelect.

9. Введите формулу как Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). Вы также можете использовать любой другой URL, параметр и ключевые слова по вашему выбору.

   

10. Сохраните и опубликуйте приложение.

11. Запустите приложение.

12. Выберите метку Планшеты Surface в новостях, чтобы запустить поиск новостей по ключевым словам Планшеты Microsoft Surface.

Пример- Param

1. Переход к Power Apps.

2. Выберите Приложения в левой области навигации.

3. Выберите свое приложение, затем выберите Изменить.

4. Выберите Вставить в меню, затем выберите Label.

5. Переместите метку в правый нижний угол экрана.

6. Выберите свойство Text для метки сверху слева.

7. Введите формулу как Param("browser"). Вы также можете использовать другой параметр по вашему выбору.

   

8. Сохраните и опубликуйте приложение.

9. Скопируйте веб-ссылку для вашего приложения из Power Apps.

10. Откройте новый браузер.

11. Вставьте веб-ссылку приложения в браузер и добавьте &browser=Microsoft%20Edge в конце.

    

12. Когда ваше приложение запускается, метка показывает переданное значение параметра.

    

13. Закройте проигрыватель приложения и отредактируйте приложение.

14. Выберите App из представления дерева в левой навигации.

15. Выберите свойство StartScreen в левом верхнем углу.

16. Введите формулу как If( Param("screen") = "techspecs", TechSpecs ).

    

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

    Заметка

    Замените имя элемента управления TechSpecs в функции If именем элемента управления в вашем приложении, если вы не используете шаблон приложения Product Showcase.

17. Сохраните и опубликуйте приложение.

18. Откройте новый браузер.

19. Вставьте веб-ссылку приложения в браузер и добавьте &screen=techspecs в конце.

    

20. Приложение запускается напрямую с TechSpecs в качестве начального экрана.

См. также

Справочник по формулам приложения Canvas