Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Um cenário comum ao criar aplicativos é a necessidade de compartilhar um "link direto" para uma tela específica. Os links diretos são úteis quando você deseja levar os usuários diretamente para uma tela e dados específicos, em vez de pedir a eles que naveguem a partir da tela de início do seu aplicativo.
Para criar um link direto para um aplicativo do Power Apps, use esta sintaxe de URL: https://apps.powerapps.com/play/{App ID}?{Query}
.
Nesta sintaxe:
- ID do Aplicativo - O ID do aplicativo. Acesse Power Apps>Aplicativos> Selecione >Detalhes do seu aplicativo.
- Consulta - O texto da consulta permite que você forneça os dados para criar o link direto. Você precisará fazer algumas alterações no código do aplicativo de tela para usar os parâmetros fornecidos e abrir o aplicativo com o URL de consulta.
Neste artigo, você aprenderá o seguinte:
- Configure um aplicativo de tela para gerenciar o parâmetro de consulta.
- Crie uma interface do usuário para enviar um link direto por email diretamente de uma tela do seu aplicativo.
- Use o aplicativo para navegar até uma conta específica, enviar um email com o link direto e usar o link do email recebido para abrir o aplicativo diretamente nessa conta.
Pré-requisitos
- Licença do Power Apps
- Se você é novo no Power Apps, conheça os princípios básicos do Power Apps gerando um aplicativo e, em seguida, personalizando os controles, a galeria, os formulários e os cartões desse aplicativo.
- Para criar um aplicativo, o direito de acesso Criador de Ambiente deverá estar atribuído a você.
Criar o aplicativo
Crie um aplicativo usando a tabela Contas no Microsoft Dataverse.
O aplicativo é aberto no arquivo BrowseScreen, que mostra uma lista de contas em uma galeria. Por padrão, essa galeria mostra um endereço de email, uma cidade e um nome de conta. O aplicativo também contém DetailScreen e EditScreen.
Atualizar a navegação
Agora, você definirá a navegação para usar um contexto que utilizaremos para direcionar o usuário a outra tela.
Na tela BrowseScreen, selecione Layout nas propriedades da galeria e escolha Título, subtítulo e corpo
Selecione o primeiro registro da galeria BrowseGallery. Depois, em OnSelect, digite o seguinte:
Navigate(DetailScreen1, Fade, {accountVal:ThisItem})
A função Navigate() cria uma variável de contexto chamada accountVal. Essa variável é preenchida sempre que você seleciona um registro da galeria. Depois de selecionar o registro, você será direcionado a DetailScreen com o valor selecionado (neste exemplo, conta) em accountVal.
Na Exibição em árvore no lado esquerdo da tela, expanda DetalheScreen1 e selecione DetailForm1.
No painel de propriedades no lado direito da tela, selecione Editar campos e adicione os campos Conta,Contato principal eEmail.
Selecione DetailForm e defina Item como accountVal.
Salve com o nome "Link direto da conta".
Obter a ID do aplicativo
ID do Aplicativo é um GUID exclusivo que representa um determinado aplicativo. Ele é gerado quando você salva o aplicativo na nuvem.
Para obter a ID do Aplicativo, abra uma nova guia e acesse Power Apps>Aplicativos> Selecione >Detalhes do aplicativo. Mais informações: Obter um ID do Aplicativo
Habilitar link direto para uma tela
O objetivo deste exemplo é levar os usuários até DetailsScreen1 quando o aplicativo é iniciado com o parâmetro de consulta accountId como parte do URL do aplicativo. Para isso, usaremos a função Param() que recupera o parâmetro de string de consulta fornecido durante a inicialização do aplicativo.
Selecione Aplicativo na Exibição em árvore no lado esquerdo da tela.
Dica
Se você fechou o Power Apps Studio, reabra o aplicativo "Link direto da conta" editando o aplicativo.
Selecione a propriedade OnStart na lista de propriedades.
Para armazenar o valor do ID do Aplicativo, atualize a fórmula da propriedade OnStart como mostrado abaixo.
Set(AppID, "GUID"); If(Not(IsBlank(Param("accountId"))),Set(accountId,Param("accountId")));
Nessa fórmula, a função Set() define o ID do Aplicativo como o GUID do aplicativo. Além disso, a função Param() armazena o valor na variável accountId, quando não está em branco.
Observação
Substitua o "GUID" na fórmula acima pelo ID do Aplicativo conforme apropriado.
Selecione a propriedade StartScreen do aplicativo e adicione o seguinte:
If(Not(IsBlank(Param("accountId"))),DetailScreen1,BrowseScreen1)
Essa função verifica se o Param está em branco e, então, fica no BrowseScreen1. Caso contrário, vá para DetailScreen1.
Selecione DetailScreen1 na Exibição em árvore.
Selecione a propriedade OnVisible e digite o seguinte:
If(Not(IsBlank(accountId)), UpdateContext({accountVal:LookUp(Accounts, Account = GUID(accountId))}))
Essa função usa a accountId armazenada da etapa anterior para definir a variável accountVal.
Criar o URL do link direto
Seu aplicativo agora está configurado para receber accountId como o parâmetro que contém o GUID de uma conta na tabela Contas. E quando esse parâmetro for fornecido com a solicitação para o aplicativo, ele abrirá diretamente a tela de detalhes (DetailScreen1) com a accountId determinada.
Para invocar o aplicativo com o valor do parâmetro, temos que usar a seguinte sintaxe:
https://apps.powerapps.com/play/{App ID}?{Query}
Na sintaxe acima, temos que adicionar o ID do Aplicativo e a consulta que contém a variável accountId com o respectivo valor.
Por exemplo, quando o seguinte URL foi inserido em um navegador para o locatário de exemplo, o aplicativo Link direto da conta aberto diretamente com o valor do parâmetro accountId fornecido (neste exemplo, "A. Datum Corporation (exemplo)"): https://apps.powerapps.com/play/061b64cd-e5a0-4a7a-a77f-b6f8586dd6c7?accountId=01e5bf81-7d44-ec11-8c60-002248094566
Enviar link direto no email
Também podemos fornecer uma variável accountVal para apontar para o ID da conta, em vez de usar o link absoluto explicado acima ao invocar o URL da conta fornecida de dentro do aplicativo.
Para isso, criaremos um botão e adicionaremos a capacidade de invocar um email de dentro do aplicativo com o link direto para a tela de detalhes da conta selecionada no aplicativo Link direto da conta.
Selecione Dados no lado esquerdo da tela.
Selecione Adicionar dados> procure e selecione Office 365 Outlook> selecione Conectar.
Observação
Essa ação adiciona a conexão ao Microsoft 365 Outlook para que possamos usar as próximas etapas para invocar a composição de um email e compartilhar as informações da conta.
Selecione DetailScreen1 na Exibição em árvore.
Insira um botão no canto inferior direito da tela e renomeie-o como Compartilhar conta.
Na propriedade OnSelect do botão, digite o seguinte:
Office365Outlook.SendEmailV2("Recipient", "Subject", "Here's the deep link to the selected account - https://apps.powerapps.com/play/{App ID}?accountId=" & accountVal.Account)
Esta fórmula usa o conector do Microsoft 365 para Outlook para enviar um email usando a operação SendEmailV2.
Observação
Substitua Destinatário, Assunto e AppID na fórmula acima com o endereço de email do destinatário, o assunto do email e o ID do Aplicativo.
Salve e publique o aplicativo.
Testar o aplicativo
Execute o aplicativo e vá para a tela de detalhes de qualquer conta. Em seguida, selecione o botão Compartilhar conta. A fórmula do botão OnSelect aciona um email para o destinatário com o assunto e o corpo configurados anteriormente. Veja um exemplo de email enviado pelo aplicativo configurado:
Abra o email e copie o link direto que aponta para a conta selecionada. Você será levado diretamente para a tela de detalhes da conta no aplicativo Link direto da conta, em vez da tela de navegação padrão.