Использование прямых ссылок с мобильным приложением Power Apps

  • Статья

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

Вы можете открыть представление entityrecord или entitylist в мобильном приложении Power Apps, используя URL-адреса прямых ссылок из других приложений. Когда вы переходите по ссылке из внешнего приложения, целевой элемент открывается в мобильном приложении Power Apps

Если вы уже вошли в свой экземпляр в приложении, целевая запись отображается, когда вы переходите по ссылке из внешнего приложения. В противном случае вам будет предложено войти в свой экземпляр в мобильном приложении; после входа в систему отображается целевой элемент. Вы должны иметь мобильное приложение Power Apps для телефонов или планшетов, установленное на вашем мобильном устройстве, чтобы использовать эту функцию.

Поддерживаемые параметры URL для приложения на основе модели

Используйте следующий обработчик приложения и параметры строки запроса для создания URL-адреса.

Прямые ссылки для мобильного приложения Power Apps должны начинаться со следующего:

ms-apps://<org-url>_<app-id>?tenantId=<tenant-id>&isShortcut=true&appType=AppModule&openApp=true&restartApp=true&forceOfflineDataSync=true

Важно!

URL-адрес организации не может содержать https://. Ниже приведен пример глубокой ссылки на приложение на основе модели:
ms-apps://contoso.onmicrosoft.com_e6429eba-2204-40e8-b9dd-fc74791ff2c2?tenantId=219f9bd4-8c16-4dfa-b87e-f4a33764f1dd

Параметр Описание
<targeted-app>
  • ms-dynamicsxrm -> Dynamics 365 для телефонов
  • ms-apps-fs -> Field Service
  • ms-apps -> Power Apps
  • ms-mobile-apps -> упакованные нативные мобильные приложения
<org-url> Подключается к правильному URL-адресу организации.
<app-id> Открывает правильный модуль приложения.
tenantId Подключается к правильному клиенту.
forceOfflineDataSync Обеспечивает запуск синхронизации данных, чтобы все последние данные были доступны.

При открытии формы entityrecord или создании новой entityrecord используйте следующие параметры:

Параметр Description
etn=<логическое-имя-сущности> Обозначает, к какой таблице перейти.
pagetype=entityrecord Указывает, что целевой элемент является формой.
extraqs=<ИД-формы> Обозначает, какую форму открыть для entityrecord; если не указано, откроется форма по умолчанию. Параметр extraqs также может использоваться для значений полей по умолчанию.
id=<ИД-записи> Указывает, к какой конкретной записи перейти; если оставить поле пустым, откроется форма создания таблицы.

Если ссылка ведет на представление entitylist, добавьте следующие параметры:

Параметр Description
etn=<логическое-имя-сущности> Обозначает, к какой таблице перейти.
pagetype=entitylist Указывает, что мы переходим к представлению.
viewid=<ИД-представления> Указывает, какое представление открыть.
Viewtype= <1039, если системное представление, 4230, если персональное представление> Обозначает, переходим ли мы к системному представлению или к личному представлению.

Поддерживаемые параметры URL для приложения на основе холста

ms-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantId>&restartApp=true

Параметр Description
<app-id> Открывает правильный модуль приложения.
<tenantId> Подключается к правильному клиенту.
restartApp=true Перезапускает приложение на основе холста, необходимое для обеспечения передачи параметров, когда приложение уже открыто.
autoLoginUpn=<e-mail> Автоматически заполняет адрес электронной почты и запускает процесс входа.

Поддерживаемые параметры URL-адресов для упакованных нативных мобильных приложений

ms-mobile-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantId>&restartApp=true

Параметр Description
<app-id> Открывает правильный модуль приложения.
<tenantId> Подключается к правильному клиенту.
restartApp=true Перезапускает приложение на основе холста для обеспечения передачи параметров, когда приложение уже открыто.
autoLoginUpn=<e-mail> Автоматически заполняет адрес электронной почты и запускает процесс входа.

Устранение неполадок

Прямые ссылки могут открываться в вашем браузере в зависимости от организационной политики компании и настроек устройства пользователя. Инструменты управления мобильными устройствами (MDM) и операционные системы устройств имеют различные параметры и настройки, влияющие на обработку прямых ссылок. Если прямые ссылки открываются в браузере, а не напрямую в мобильном приложении Power Apps, убедитесь, что политики MDM и параметры устройства настроены соответствующим образом.

Например, на некоторых устройствах Android, перейдите в Настройки > Приложения > Power Apps > Открывать по умолчанию и добавьте apps.powerapps.com, чтобы прямые ссылки открывались прямо в мобильном приложении Power Apps.