Share via


Utilizar vínculos profundos con la aplicación móvil de Power Apps

Los vínculos profundos permiten a los usuarios pasar de una aplicación a otra en equipos de sobremesa y dispositivos móviles. Algunos ejemplos sencillos incluyen un vínculo profundo de una aplicación móvil a Facebook para iniciar sesión, un vínculo profundo de una dirección de correo electrónico a una aplicación de correo para redactar un mensaje o un vínculo profundo de un sitio web a una tienda de aplicaciones para descargar una aplicación móvil relacionada.

Puede abrir una vista entityrecord o entitylist en la aplicación móvil de Power Apps mediante direcciones URL de vínculo profundo desde otras aplicaciones. Cuando sigue el vínculo desde una aplicación externa, el elemento de destino se abre en Power Apps para dispositivos móviles

Si ya ha iniciado sesión en la instancia de la aplicación, el registro de destino se muestra en el cliente móvil al seguir el vínculo desde una aplicación externa. De lo contrario, se le pedirá que inicie sesión en su instancia de la aplicación móvil; después de iniciar sesión, se muestra el elemento de destino. Debe tener la aplicación móvil Power Apps instalada en su dispositivo móvil para usar esta característica.

Parámetros de URL admitidos para una aplicación basada en modelo

Use los siguientes parámetros del controlador de aplicaciones y cadena de consulta para crear la dirección URL.

Los vínculos profundos para la aplicación móvil Power Apps deben comenzar con lo siguiente:

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

Importante

La URL de la organización no puede contener https://. El siguiente es un ejemplo de un vínculo profundo de una aplicación basada en modelos:
ms-apps://contoso.onmicrosoft.com_e6429eba-2204-40e8-b9dd-fc74791ff2c2?tenantId=219f9bd4-8c16-4dfa-b87e-f4a33764f1dd

Parámetro Description
<targeted-app>
  • ms-dynamicsxrm -> Dynamics 365 para teléfonos
  • ms-apps-fs -> Field Service
  • ms-apps -> Power Apps
  • ms-mobile-apps-> aplicaciones móviles nativas encapsuladas
<org-url> Se conecta a la URL de la organización correcta.
<app-id> Abre el módulo de aplicación correcto.
tenantId Se conecta al inquilino correcto.
forceOfflineDataSync Garantiza el desencadenamiento de la sincronización de datos para que estén disponibles los datos más recientes.

Si abre un formulario entityrecord o crea un nuevo entityrecord, utilice los siguientes parámetros:

Parámetro Description
etn=<entity-logical-name> Designa a qué tabla hay que ir.
pagetype=entityrecord Indica que el destino es un formulario.
extraqs=<form-id> Designa qué formulario hay que abrir para entityrecord; si no se especifica, se abre el formulario predeterminado. El parámetro extraqs también se puede utilizar para valores de campo predeterminados.
id=<record-id> Designa a qué registro concreto hay que ir; si se deja en blanco, se abre el formulario de creación de la tabla.

Si el vínculo va a una vista entitylist, agregue los siguientes parámetros:

Parámetro Description
etn=<entity-logical-name> Designa a qué tabla hay que ir.
pagetype=entitylist Indica que vamos a una vista.
viewid=<view-id> Designa qué vista se debe abrir.
Viewtype= <1039 para vista del sistema, 4230 para vista personal> Designa si vamos a una vista del sistema o a una vista personal.

Parámetros de URL admitidos para una aplicación de lienzo

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

Parámetro Description
<app-id> Abre el módulo de aplicación correcto.
<tenantId> Se conecta al inquilino correcto.
restartApp=true Reinicia la aplicación de lienzo, necesaria para garantizar que se pasen los parámetros cuando la aplicación ya está abierta.
autoLoginUpn=<correo electrónico> Completa automáticamente el correo electrónico y activa el inicio de sesión.

Parámetros de URL admitidos para una aplicación móvil nativa encapsulada

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

Parámetro Description
<app-id> Abre el módulo de aplicación correcto.
<tenantId> Se conecta al inquilino correcto.
restartApp=true Reinicia la aplicación de lienzo para garantizar que se pasen los parámetros cuando la aplicación ya está abierta.
autoLoginUpn=<correo electrónico> Completa automáticamente el correo electrónico y activa el inicio de sesión.

Solución de problemas

Los vínculos profundos pueden abrirse en su explorador en función de las políticas organizativas de la empresa y de la configuración del dispositivo del usuario. Las herramientas de administración de dispositivos móviles (MDM) y los sistemas operativos de dispositivos tienen diferentes opciones y configuraciones que afectan a la forma en que se manejan los vínculos profundos. Si los vínculos profundos se abren en un explorador en lugar de directamente en Power Apps Mobile, asegúrese de que las políticas de MDM y la configuración del dispositivo estén configuradas correctamente.

Como ejemplo, en algunos dispositivos Android, vaya a Configuración > ** Aplicaciones** > Power Apps > Abrir de forma predeterminada y agregue apps.powerapps.com para hacer que los vínculos profundos se abran directamente en Power Apps Mobile.