Compartilhar via


Crie um aplicativo de tela com link direto para uma tela específica

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

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.

  1. Na tela BrowseScreen, selecione Layout nas propriedades da galeria e escolha Título, subtítulo e corpo

    Exibição da lista de contas.

  2. Selecione o primeiro registro da galeria BrowseGallery. Depois, em OnSelect, digite o seguinte:

    Navigate(DetailScreen1, Fade, {accountVal:ThisItem})
    

    Set AccountVal.

    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.

  3. Na Exibição em árvore no lado esquerdo da tela, expanda DetalheScreen1 e selecione DetailForm1.

    Selecione DetailForm1 na Exibição em árvore.

  4. No painel de propriedades no lado direito da tela, selecione Editar campos e adicione os campos Conta,Contato principal eEmail.

    Exibição de detalhes das contas.

  5. Selecione DetailForm e defina Item como accountVal.

    AccountVal.

  6. 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

Detalhes do aplicativo.

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.

  1. 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.

  2. Selecione a propriedade OnStart na lista de propriedades.

  3. 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.

    Fórmula App OnStart com as funções Set e Param.

  4. 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.

    Fórmula App StartScreen com função Param para redirecionar ou permanecer com base no valor da variável.

  5. Selecione DetailScreen1 na Exibição em árvore.

  6. 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.

    DetailScreen1 com a fórmula de propriedade OnVisible.

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

Link de exemplo com detalhes da A. Datum Corporation (Amostra) aberto.

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.

  1. Selecione Dados no lado esquerdo da tela.

  2. 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.

  3. Selecione DetailScreen1 na Exibição em árvore.

  4. Insira um botão no canto inferior direito da tela e renomeie-o como Compartilhar conta.

  5. 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.

    Botão Compartilhar conta.

  6. 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:

Email enviado usando o botão Compartilhar conta.

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.

Aplicativo aberto usando o link do email.

Confira também