Exercício: usar um convite para registrar usuários

  • 10 minutos

O objetivo deste laboratório prático é apresentar o processo de registro de usuário baseado em convite do Power Pages.

Os exercícios funcionam melhor quando você tem dados com os quais trabalhar. Dependendo do ambiente em que você está trabalhando, convém instalar alguns dados de exemplo para facilitar os exercícios. O Dataverse oferece a capacidade de adicionar dados de exemplo conforme necessário. Se o ambiente em que você está trabalhando não tiver dados de exemplo instalados, siga as etapas da documentação Adicionar ou remover dados de exemplo para instalar os dados de exemplo em seu ambiente.

Objetivos de aprendizagem

Ao fim destes exercícios, você poderá:

  • Crie um fluxo do Power Automate para enviar convites por email aos contatos.

  • Criar e enviar convites para que os contatos se registrem.

  • Resgatar os convites.

Pré-requisitos

Estes são os pré-requisitos deste exercício:

  • Acesso de administrador do sistema a um ambiente Dataverse ou Microsoft Dynamics 365.

  • Um site do Power Pages provisionado nesse ambiente.

  • Acesso de criador ao Power Automate.

  • Uma conta de email do Office 365 ou qualquer outra conta de email que você possa acessar no Power Automate usando um conector.

Cenário

Sua organização usa o Power Apps há algum tempo e registra informações sobre clientes e fornecedores. Você provisionou e configurou um site do Power Pages. Você deseja convidar um fornecedor que está lhe ajudando no gerenciamento do site para se registrar como um usuário administrativo do site de modo que ele possa entrar, acessar o conteúdo exclusivo do administrador e executar funções de front-end específicas do administrador, como visualizar conteúdo de rascunho.

Etapas de alto nível

Para enviar convites a seus clientes e para que eles os resgatem, conclua as seguintes tarefas:

  • Criar um fluxo do Power Automate para enviar um único convite.

  • Selecione um contato e crie um convite.

  • Verifique se o convite contém as informações necessárias.

  • Envie o convite ao contato.

Criar um contato de teste

Para criar um contato de teste, siga estas etapas:

  1. Entre no Power Apps.

  2. Selecione um ambiente de destino usando o seletor de ambiente no canto superior direito.

  3. No menu esquerdo, selecione Aplicativos.

  4. Selecione o aplicativo Power Pages Management, que será aberto em uma nova guia. Não feche a janela do ambiente do Power Apps maker.

    Captura de tela das etapas para abrir o aplicativo Gerenciamento do Portal.

  5. No aplicativo, selecione Contatos na seção Segurança e selecione Novo.

  6. Crie uma nova linha para Nancy Davolio. Preencha o nome, o sobrenome e as informações de endereço de email (use um endereço que você possa receber o email).

  7. Selecione Salvar.

    Captura de tela das etapas para criar um contato de teste.

  8. Não feche essa janela.

Criar um fluxo de convites

O Power Pages é fornecido com um fluxo de trabalho clássico para enviar o email de convite. Este exemplo usa uma abordagem moderna e cria um fluxo do Power Automate para realizar a mesma tarefa.

  1. Mude para a guia de ambiente do criador do Power Apps.

  2. Selecione Soluções e localize e selecione Solução Padrão do Common Data Services.

    Dica

    Use a pesquisa para localizar a solução.

    Captura de tela das etapas para abrir a Solução Padrão do Common Data Services no ambiente.

  3. Selecione Novo > Automação > Fluxo da nuvem > Instantâneo.

    Captura de tela da seleção do menu para começar a criar um fluxo instantâneo do Power Automate.

  4. Insira Send Invitation como Nome do fluxo.

  5. Selecione quando uma linha for selecionada.

  6. Selecione Criar.

    Captura de tela da seleção do menu para começar a criar um fluxo instantâneo do Power Automate.

  7. Insira detalhes para a etapa Quando uma linha é selecionada.

    1. Selecione o ambiente Padrão.

    2. Selecione a tabela Convites.

  8. Adicione a ação Obter uma linha por ID do conector do Microsoft Dataverse.

    1. Selecione as reticências (...) na etapa e, depois, Renomear. Altere o nome da etapa para Obter Contato.

    2. Selecione Contatos como a tabela.

    3. Insira o conteúdo dinâmico de Invite Contact como a ID da Linha.

  9. Selecione Salvar. O fluxo deve for semelhante ao exemplo a seguir.

    Captura de tela das etapas iniciais para criar o fluxo do Power Automate.

  10. Adicione uma ação Compor por meio do conector de Operação de Dados.

    1. Defina Entradas como <a href="https://siteurl/register/?invitation=CODE">this link</a>.

    2. Substitua siteurl pelo endereço de seu site, como contoso.powerappsportals.com.

    3. Selecione CODE e substitua-o pelo conteúdo dinâmico do Invitation Code.

      Será criada uma expressão de link de convite que agora você pode usar em um email HTML.

    Captura de tela da etapa de composição para criar uma URL de convite.

  11. Adicione a ação Enviar um email (V2) do conector do Office 365 Outlook.

    Observação

    Nesta etapa, você pode usar qualquer conector que dê suporte ao envio de emails HTML. Por exemplo, se tiver uma assinatura SendGrid, você poderá usar o conector SendGrid.

  12. Insira o conteúdo dinâmico de Email da etapa Obter Contato no campo Para.

    1. Insira Participe da nossa comunidade como o Assunto.

    2. Insira o seguinte texto como o corpo do email:

    Prezado(a) FIRSTNAME,

    Aceite nosso convite para ingressar na comunidade da Contoso. Para resgatar seu convite, siga LINK.

    Atenciosamente, Equipe da Contoso

  13. Substitua FIRSTNAME pelo conteúdo dinâmico de First Name da etapa Obter Contato.

    1. Substitua LINK por Saídas da etapa Compor.

  14. Selecione Salvar. O fluxo deve for semelhante à captura de tela a seguir.

    Captura de tela após a etapa de enviar um email.

  15. Adicione a ação Atualizar uma linha do conector do Microsoft Dataverse.

    1. Selecione as reticências (...) na etapa e, depois, Renomear. Altere o nome da etapa para Definir o status como enviado.

    2. Selecione Convites como a tabela.

    3. Selecione o conteúdo dinâmico de Convite da etapa Quando um registro é selecionado como o valor ID da linha.

    4. Expanda Mostrar opções avançadas.

    5. Selecione Enviado como a Razão do Status.

    Captura de tela da configuração da razão do status do convite.

  16. Selecione Salvar e a seta Voltar no canto superior esquerdo.

    Captura de tela da etapa salvar e sair do editor de fluxo.

Criar e enviar o convite

Para criar e enviar o convite, siga estas etapas:

  1. Alterne para o aplicativo do Power Pages. Abra a linha de contato de Nancy Davolio, se ainda não estiver aberta.

  2. Selecione Criar convite na barra de comandos.

  3. O convite é previamente preenchido. Selecione Salvar.

  4. Em Atribuir a Funções Web, selecione Adicionar Função Web existente.

  5. Pesquise e adicione a função Administradores.

  6. Selecione Fluxo > Enviar Convite.

    Captura de tela das etapas criar e enviar convite.

Dica

Se a opção Enviar convite não for mostrada no menu Fluxo, selecione Ver seus fluxos primeiro, atualize a janela e tente acessar o menu Fluxo novamente.

Resgatar o convite

Para resgatar o convite, siga estas etapas:

  1. Abra a caixa de correio do email que você usou para Nancy Davolio.

  2. Localize e abra o email de convite.

  3. Selecione o link no email. A página Resgatar Convite será aberta.

  4. Selecione Registrar.

  5. Insira nancyd como o nome de usuário e insira uma senha de sua escolha.

    Dica

    Por padrão, as senhas devem ter pelo menos oito caracteres. As senhas devem conter caracteres de, pelo menos, três das seguintes classes: letra maiúscula, letra minúscula, número e caracteres não alfanuméricos (especiais).

  6. Selecione Registrar. Sua conta agora está registrada e você é conectado automaticamente e redirecionado para a página de perfil.

  7. Alterne para o aplicativo do Power Pages.

  8. Selecione Convites e, em seguida, selecione a exibição Convites Concluídos.

  9. Confirme se o convite de Nancy Davolio consta na lista.

  10. Abra o convite e confirme se a Razão do Status é Resgatado.

Captura de tela do convite resgatado.