Partilhar via

Utilizar ligações profundas com a aplicação móvel do Power Apps

As ligações avançadas permitem que os utilizadores se movam de uma aplicação para outra em computadores e dispositivos móveis. Exemplos simples incluem uma aplicação móvel com ligação avançada para o Facebook para iniciar sessão, um endereço de e-mail com ligação avançada para uma aplicação de correio para compor uma mensagem ou um site com ligação avançada para uma loja de aplicações para transferir uma aplicação móvel relacionada.

Pode abrir uma vista de entityrecord ou de entitylist na aplicação móvel Power Apps utilizando URLs de ligação avançada a partir de outras aplicações. Quando segue a ligação a partir de uma aplicação externa, o elemento de destino abre no Power Apps Mobile

Se já tiver iniciado sessão na sua instância na aplicação, o registo de destino é apresentado quando segue a ligação a partir de uma aplicação externa. Caso contrário, é-lhe pedido que inicie sessão na sua instância na aplicação móvel; depois de iniciar sessão, o elemento de destino é apresentado. Tem de ter a aplicação móvel Power Apps instalada no seu dispositivo móvel para utilizar esta caraterística.

Parâmetros de Urls suportados para uma aplicação condicionada por modelo

Utilize os seguintes parâmetros de processador de aplicação e de cadeia de consulta para compor o URL.

As ligações avançadas para a aplicação móvel Power Apps devem começar com o seguinte:

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

Importante

O URL da organização não pode conter https://. A seguir está um exemplo de uma hiperligação direta de aplicação orientada por modelo.
ms-apps://contoso.onmicrosoft.com_e6429eba-2204-40e8-b9dd-fc74791ff2c2?tenantId=aaaabbbb-0000-cccc-1111-dddd2222eeee&environmentId=g67tfyufhkjfg&appLogicalName=cr12_e567

Parâmetro Descrição Obrigatório
<aplicação-alvo>
  • ms-dynamicsxrm -> Dynamics 365 para telemóveis
  • ms-apps-fs -> Field Service
  • ms-apps -> Power Apps
  • ms-mobile-apps -> aplicações móveis nativas encapsuladas
 Sim
<org-url> Liga-se ao URL correto da organização. Sim
<ID do aplicativo> Abre o módulo de aplicação correto. Sim
tenantId=<tenant-id> Liga-se ao inquilino correto. Sim
*environmentId=<environment-id> Identifica exclusivamente o ambiente dentro de um locatário. Sim
*appLogicalName=<app-logical-name> Nome exclusivo do aplicativo. Para obter mais informações sobre como encontrar esse nome exclusivo do aplicativo no estúdio moderno, consulte Gerenciar configurações de aplicativo controladas por modelo no designer de aplicativo e, para o editor clássico, consulte Gerenciar propriedades de aplicativo controladas por modelo no designer de aplicativo (clássico) Sim
appType=AppModule Indica que a aplicação de destino é uma aplicação condicionada por modelo. Sim
restartApp=true Reinicia a aplicação condicionada por modelo. Necessário para garantir que os parâmetros são passados quando a aplicação já está aberta. Não
autoLoginUpn=<e-mail> Preenche automaticamente o e-mail e aciona as informações de início de sessão.

Nota: Este parâmetro será ignorado se um utilizador já tiver sessão iniciada na aplicação.		 Não
forceOfflineDataSync=true Garante que a sincronização de dados é acionada para que todos os dados mais recentes estejam disponíveis. Não

* Considerações

  • O ID do ambiente e appLogicalName são obrigatórios para todos os novos deep links.
  • Os links profundos existentes sem um ID de ambiente ou appLogicalName terão um desempenho mais lento até dezembro de 2025, após o qual não serão suportados.
  • Atualize todos os deep links existentes para incluir o ID do ambiente e appLogicalName para melhorar o desempenho e reduzir o tempo de espera.

Se abrir um formulário de entityrecord ou criar um novo entityrecord, utilize os seguintes parâmetros:

Parâmetro Descrição Obrigatório
etn=<nome-lógico-da-entidade> Designa a tabela de destino. Sim
pagetype=entityrecord Indica que o alvo é um formulário. Sim
id=<id de registro> Designa a que registo específico se deve dirigir; Se deixado em branco, o formulário criado para a tabela será aberto. Sim
extraqs=<formulário-id> Designa que formulário abrir para o entityrecord; se não especificado, o formulário predefinido abre-se. O parâmetro extraqs também pode ser usado para valores de campo predefinidos. Não

Se o ligação direcionar para uma vista de entitylist, adicione os seguintes parâmetros:

Parâmetro Descrição Obrigatório
etn=<nome-lógico-da-entidade> Designa a tabela de destino. Sim
pagetype=entitylist Indica que vamos para uma vista. Sim
viewid=<view-id> Designa qual a vista a abrir. Não
Viewtype= <1039 se vista do sistema, 4230 se vista pessoal> Indica se a vista de destino é uma vista do sistema ou uma vista pessoal. Não

Parâmetros de Urls suportados para uma aplicação de tela

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

Parâmetro Descrição Obrigatório
<ID do aplicativo> Abre o módulo de aplicação correto. Sim
tenantId=<tenantId> Liga-se ao inquilino correto. Sim
*environmentId=<environment-id> Identifica exclusivamente o ambiente dentro de um locatário. Sim
restartApp=true Reinicia o aplicativo Canvas. Necessário para garantir que os parâmetros são passados quando a aplicação já está aberta. Não
autoLoginUpn=<e-mail> Preenche automaticamente o e-mail e aciona as informações de início de sessão.

Nota: Este parâmetro será ignorado se um utilizador já tiver sessão iniciada na aplicação.		 Não

* Considerações

  • O identificador do ambiente é obrigatório para todas as novas ligações diretas.

  • Os links profundos existentes sem um ID de ambiente terão um desempenho mais lento até dezembro de 2025, após o qual não serão suportados.

  • Atualize todos os deep links existentes para incluir o ID do ambiente para melhorar o desempenho e reduzir o tempo de espera.

    Parâmetros de URLs suportados para uma aplicação móvel nativa encapsulada

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

Importante

A URL de link profundo para um aplicativo encapsulado funciona somente quando um aplicativo encapsulado é instalado no dispositivo móvel. Ele não funciona se mais de um aplicativo encapsulado estiver instalado.

Parâmetro Descrição Obrigatório
<ID do aplicativo> Abre o módulo de aplicação correto. Sim
tenantId=<tenantId> Liga-se ao inquilino correto. Sim
restartApp=true Reinicia a aplicação condicionada por modelo. Necessário para garantir que os parâmetros são passados quando a aplicação já está aberta. Não
autoLoginUpn=<e-mail> Preenche automaticamente o e-mail e aciona as informações de início de sessão.

Nota: Este parâmetro será ignorado se um utilizador já tiver sessão iniciada na aplicação.		 Não

Resolução de Problemas

As ligações avançadas podem abrir no seu browser dependendo das políticas organizacionais da empresa e das definições do dispositivo do utilizador. As ferramentas de Gestão de Dispositivos Móveis (MDM) e os sistemas operativos dos dispositivos têm diferentes opções e definições que afetam a forma como as ligações profundas são tratadas. Se os links diretos estiverem sendo abertos em um navegador em vez de diretamente no Power Apps mobile, verifique se as políticas de MDM e as configurações do dispositivo estão configuradas corretamente.

Por exemplo, em alguns dispositivos Android, aceda a Definições>Aplicações>Power Apps>Open por predefinição e adicione apps.powerapps.com para abrir ligações profundas diretamente no Power Apps mobile.

Consulte também

Alterações (preterimentos) futuras importantes em aplicações de tela

  • Last updated on