Usar links profundos com o aplicativo móvel do Power Apps

  • Artigo

Links profundos permitem que os usuários mudem de um aplicativo para outro em computadores e dispositivos móveis. Exemplos simples incluem um link profundo de aplicativo móvel para o Facebook para fazer login, um link profundo de endereço de email para um aplicativo de email para redigir uma mensagem ou um link profundo de um site para uma loja de aplicativos para baixar um aplicativo móvel relacionado.

Você pode abrir uma exibição entityrecord ou entitylist no aplicativo móvel Power Apps usando URLs de link profundo de outros aplicativos. Quando você segue o link de um aplicativo externo, o elemento de destino é aberto no Power Apps mobile

Se você já estiver conectado à sua instância no aplicativo, o registro de destino será exibido quando você seguir o link de um aplicativo externo. Caso contrário, você será solicitado a efetuar login em sua instância no aplicativo móvel; depois que você entrar, o elemento de destino será exibido. Você deve ter o aplicativo móvel Power Apps instalado no dispositivo móvel para usar esse recurso.

Parâmetros de URLs compatíveis para um aplicativo baseado em modelo

Use o seguinte manipulador de aplicativos e parâmetros de cadeia de consulta para compor o URL.

Os links profundos do aplicativo móvel Power Apps devem começar com o seguinte:

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

Importante

A url da organização não pode conter https://. Veja a seguir um exemplo de deeplink de um aplicativo baseado em modelo:
ms-apps://contoso.onmicrosoft.com_e6429eba-2204-40e8-b9dd-fc74791ff2c2?tenantId=219f9bd4-8c16-4dfa-b87e-f4a33764f1dd

Parâmetro Descrição
<targeted-app>
  • ms-dynamicsxrm -> Dynamics 365 para telefones
  • ms-apps-fs -> Field Service
  • ms-apps -> Power Apps
  • ms-mobile-apps -> aplicativos móveis empacotados
<org-url> Conecta-se à URL da organização correta.
<app-id> Abre o módulo de aplicativo correto.
tenantId Conecta-se ao locatário correto.
forceOfflineDataSync Garante que a sincronização de dados seja disparada, de maneira que todos os dados mais recentes estejam disponíveis.

Ao abrir um formulário entityrecord ou criar um novo entityrecord, use os seguintes parâmetros:

Parâmetro Descrição
etn=<entity-logical-name> Designa a qual tabela recorrer.
pagetype=entityrecord Indica que o destino é um formulário.
extraqs=<form-id> Designa qual formulário abrir para o entityrecord; se não for especificado, o formulário padrão será aberto. O parâmetro extraqs também pode ser usado para valores de campo padrão.
id=<record-id> Designa a qual registro específico recorrer; se deixado em branco, o formulário de criação da tabela é aberto.

Se o link for para um exibição entitylist, adicione os seguintes parâmetros:

Parâmetro Descrição
etn=<entity-logical-name> Designa a qual tabela recorrer.
pagetype=entitylist Indica que estamos indo para uma exibição.
viewid=<view-id> Designa qual exibição abrir.
Viewtype= <1039 se for uma exibição do sistema e 4230 se for uma exibição pessoal> Determina se estamos indo até uma exibição do sistema ou pessoal.

Parâmetros de URLs compatíveis para um aplicativo de tela

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

Parâmetro Descrição
<app-id> Abre o módulo de aplicativo correto.
<tenantId> Conecta-se ao locatário correto.
restartApp=true Reinicia o aplicativo de tela, necessário para garantir que os parâmetros sejam passados quando o aplicativo já está aberto.
autoLoginUpn=<e-mail> Popula automaticamente o email e dispara a entrada.

Parâmetros de URLs compatíveis para um aplicativo móvel nativo empacotado

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

Parâmetro Descrição
<app-id> Abre o módulo de aplicativo correto.
<tenantId> Conecta-se ao locatário correto.
restartApp=true Reinicia o aplicativo de tela para garantir que os parâmetros sejam passados quando o aplicativo já estiver aberto.
autoLoginUpn=<e-mail> Popula automaticamente o email e dispara a entrada.

Solução de Problemas

Os deeplinks podem ser abertos no seu navegador dependendo das políticas organizacionais da empresa e das configurações do dispositivo do usuário. As ferramentas de MDM (gerenciamento de dispositivo móvel) e os sistemas operacionais dos dispositivos têm diferentes opções e configurações que afetam o modo como os deeplinks são tratados. Se os deeplinks estiverem abrindo em um navegador em vez de diretamente no Power Apps Mobile, certifique-se de que suas políticas de MDM e configurações do dispositivo estejam definidas adequadamente.

Como exemplo, em alguns dispositivos Android, acesse Configurações > Aplicativos > Power Apps > Abrir por padrão e adicione apps.powerapps.com para que os deeplinks sejam abertos diretamente no Power Apps Mobile.