Usar links profundos com o aplicativo móvel do Power Apps
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.
Links profundos compatíveis no aplicativo Power Apps mobile
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>&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=aaaabbbb-0000-cccc-1111-dddd2222eeee
| Parâmetro | Descrição | Obrigatório |
|---|---|---|
| <targeted-app> |
|
Sim |
| <org-url> | Conecta-se à URL da organização correta. | Sim |
| <app-id> | Abre o módulo de aplicativo correto. | Sim |
| tenantId=<tenand-id> | Conecta-se ao locatário correto. | Sim |
| appType=AppModule | Indica que o aplicativo de destino é um aplicativo baseado em modelo. | Sim |
| restartApp=true | Reinicia o aplicativo baseado em modelo. Necessário para garantir que os parâmetros sejam passados quando o aplicativo já estiver aberto. | No |
| forceOfflineDataSync=true | Garante que a sincronização de dados seja disparada, de maneira que todos os dados mais recentes estejam disponíveis. | No |
Ao abrir um formulário entityrecord ou criar um novo entityrecord, use os seguintes parâmetros:
| Parâmetro | Descrição | Obrigatório |
|---|---|---|
| etn=<entity-logical-name> | Designa a qual tabela recorrer. | Sim |
| pagetype=entityrecord | Indica que o destino é um formulário. | Sim |
| id=<record-id> | Designa a qual registro específico recorrer; se deixado em branco, o formulário de criação da tabela é aberto. | Sim |
| 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. |
No |
Se o link for para um exibição entitylist, adicione os seguintes parâmetros:
| Parâmetro | Descrição | Obrigatório |
|---|---|---|
| etn=<entity-logical-name> | Designa a qual tabela recorrer. | Sim |
| pagetype=entitylist | Indica que estamos indo para uma exibição. | Sim |
| viewid=<view-id> | Designa qual exibição abrir. | No |
| Viewtype= <1039 se for uma exibição do sistema e 4230 se for uma exibição pessoal> | Indica se a exibição de destino é uma exibição do sistema ou uma exibição pessoal. | No |
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 | Obrigatório |
|---|---|---|
| <app-id> | Abre o módulo de aplicativo correto. | Sim |
| tenantId=<tenantId> | Conecta-se ao locatário correto. | Sim |
| restartApp=true | Reinicia o aplicativo baseado em modelo. Necessário para garantir que os parâmetros sejam passados quando o aplicativo já estiver aberto. | No |
| autoLoginUpn=<e-mail> | Popula automaticamente o email e dispara a entrada. | No |
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 | Obrigatório |
|---|---|---|
| <app-id> | Abre o módulo de aplicativo correto. | Sim |
| tenantId=<tenantId> | Conecta-se ao locatário correto. | Sim |
| restartApp=true | Reinicia o aplicativo baseado em modelo. Necessário para garantir que os parâmetros sejam passados quando o aplicativo já estiver aberto. | No |
| autoLoginUpn=<e-mail> | Popula automaticamente o email e dispara a entrada. | No |
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.