Exercício: estender formulários com mais ações

Concluído

O objetivo deste laboratório prático é apresentar o processo de extensão de formulários básicos com mais ações.

Os exercícios funcionam melhor quando há dados de exemplo. Dependendo do ambiente em que você está trabalhando, convém instalar alguns dados de exemplo para facilitar os exercícios. O Microsoft Power Platform permite 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

O objetivo desses exercícios é que você aprenda a:

  • Criar um fluxo de trabalho para uma tabela de casos.

  • Configurar uma nova ação de fluxo de trabalho para formulários básicos.

  • Adicionar um prompt de usuário a uma ação de fluxo de trabalho.

  • Aplicar um filtro condicional a um botão de ação.

Tempo estimado para concluir este exercício: 15 a 20 minutos

Pré-requisitos

Os pré-requisitos para concluir as tarefas neste exercício são:

  • Acesso de administrador do sistema a uma instância do Microsoft Dataverse com o aplicativo Microsoft Dynamics 365 Customer Service instalado. Se você não tiver uma instância do Dynamics 365 com o aplicativo instalado, poderá provisionar uma avaliação do Dynamics 365 Customer Service acessando Iniciar uma avaliação gratuita do Microsoft Dynamics 365.

  • Um site de autoatendimento do cliente, comunidade ou parceiro provisionado. Se você não tiver um site do Power Pages disponível, siga as instruções em Criar um site com o Power Pages, mas selecione um dos modelos mencionados.

Cenário

Sua organização provisionou um site do Power Pages para estender os recursos de gerenciamento de casos do aplicativo Dynamics 365 Customer Service.

A empresa deseja que os clientes tenham a capacidade de colocar um caso ativo em espera com os seguintes parâmetros:

  • Quando um usuário do site seleciona o botão, ele deve receber uma mensagem de confirmação.

  • Somente os casos ativos que ainda não estão em espera devem exibir a interface para os usuários do site.

Para terminar o exercício, realize as seguintes tarefas:

  1. Crie um fluxo de trabalho em tempo real para a tabela Caso que define o status do caso como Em Espera.

  2. Adicione um botão de ação de fluxo de trabalho ao formulário Editar Caso existente.

  3. Adicione uma mensagem de confirmação.

  4. Adicione critérios de filtragem para mostrar o botão somente para os casos ativos que não estão em espera.

Criar um processo de fluxo de trabalho

Antes de habilitar mais ações para o formulário básico, você precisará criar um fluxo de trabalho chamado pelo formulário. Nas etapas a seguir, você criará um fluxo de trabalho em tempo real para comentários visuais imediatos no formulário básico.

  1. Entre no Power Apps.

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

  3. Selecione Soluções.

  4. Selecione Solução Padrão Microsoft Dataverse.

    Observação

    Dependendo da versão do seu ambiente, a solução também pode se chamar Solução Padrão de Common Data Services.

    Dica

    Use a funcionalidade de pesquisa e procure padrão para localizar a solução rapidamente.

  5. Selecione Novo > Automação > Processo > Fluxo de trabalho.

    Captura de tela das etapas para criar um fluxo de trabalho clássico em uma solução do Dataverse.

  6. Digite os seguintes valores no painel lateral:

    • Nome de exibição: Caso em Espera

    • Tabela: Caso

    • Executar fluxo de trabalho em segundo plano: desmarque essa opção

    • Começar com: selecione Em branco

  7. Selecione Criar.

    Captura de tela das propriedades do fluxo de trabalho.

  8. Na nova janela que é aberta, selecione Como um processo sob demanda.

  9. Desmarque a caixa de seleção Registro criado.

  10. Selecione Adicionar Etapa > Alterar Status.

  11. Altere o status da linha para Em Espera.

  12. Selecione Ativar.

    Captura de tela das etapas e propriedades do fluxo de trabalho clássico.

  13. Selecione Fechar.

Criar um botão de ação

Após a criação do fluxo de trabalho, você pode adicionar um botão de ação do fluxo de trabalho ao formulário básico do caso e configurar esse botão para chamar o fluxo de trabalho.

  1. Entre na Página inicial do Power Pages.

  2. Selecione o ambiente correto no canto superior direito.

  3. Selecione o site, selecione o menu de reticências (...) e Gerenciamento do Portal.

  4. No aplicativo Gerenciamento do Portal, selecione Formulários (ele também pode ser chamado de Formulários Básicos).

  5. Selecione Customer Service – Editar Ocorrência.

  6. Selecione a guia Configurações Adicionais.

  7. Selecione Fluxo de trabalho.

    Captura de tela das etapas para adicionar um botão de fluxo de trabalho ao formulário básico existente.

  8. Insira os seguintes valores para a ação de Fluxo de trabalho (talvez seja necessário rolar para localizá-la):

    • Fluxo de Trabalho: selecione Caso em Espera

    • Rótulo do Botão: Em Espera

  9. Selecione Salvar.

    Captura de tela da ação Adicionar fluxo de trabalho e salvar o formulário básico.

  10. Não feche a janela.

Teste

Para testar se o novo botão de ação do fluxo de trabalho funciona, siga estas etapas:

  1. Abra o site em uma nova janela do navegador: https://yoursite.powerappsportals.com.

  2. Entre como um cliente existente.

  3. Se você não tiver uma conta de cliente, siga estas etapas no aplicativo de Gerenciamento do Portal:

    1. Selecione Contatos.

    2. Selecione Novo.

    3. Alterne para o formulário Contato do Portal.

    4. Insira o nome de sua preferência.

    5. Selecione Autenticação da Web.

    6. Insira o nome de usuário de sua preferência.

    7. Selecione Login Habilitado.

    8. Selecione Salvar.

    9. Selecione Alterar Senha e insira a nova senha de sua preferência.

    10. Adicione a função Web Usuários Autenticados à linha de contato.

    11. Saia como um administrador do sistema.

    12. Entre como um novo usuário.

  4. Selecione Suporte na barra de menus superior.

  5. Selecione um caso existente. Se não houver casos existentes, crie e salve uma nova linha de caso.

    O caso deve ser mostrado como Ativo – Em Andamento.

    Captura de tela de um caso marcado como Ativo — Em andamento.

    A parte inferior da janela do caso deve mostrar o novo botão Em Espera.

    Captura de tela do novo botão Em Espera na janela do caso.

  6. Selecione o botão Em Espera. Será exibida esta mensagem: "O fluxo de trabalho foi iniciado".

    A janela será atualizada e o status do caso mudará para Ativo – Em Espera.

    Captura de tela do status do caso definido como Ativo — Em espera.

  7. Role para baixo e verifique se o botão Em Espera ainda está presente.

Aprimorar o botão de ação

Fazer com que o botão de fluxo de trabalho fique visível continuamente não faz sentido em determinados cenários, por exemplo, em casos desabilitados. Você pode inserir informações extras para aprimorar a experiência do usuário.

  1. Alterne para o aplicativo de Gerenciamento do Portal.

  2. Selecione Formulários Básicos.

  3. Selecione Customer Service – Editar Ocorrência.

  4. Selecione a guia Configurações Adicionais.

  5. Selecione Configurações avançadas e localize a ação de Fluxo de trabalho.

  6. Insira os seguintes valores:

    • Confirmação Necessária: Sim

    • Confirmação: Tem certeza de que deseja colocar este caso em espera?

  7. Na caixa Critérios de Filtragem, copie e cole o seguinte FetchXML:

    <fetch>
    <table name="incident" >
       <attribute name="incidentid" />
       <filter type="and" >
          <condition attribute="statecode" operator="eq" value="0" />
          <condition attribute="statuscode" operator="neq" value="2" />
       </filter>
    </table>
    </fetch>
    

    Este FetchXML garante que o botão fique visível apenas quando o caso estiver ativo (statecode eq 0 (Active)) e a coluna de razão do status não for Em Espera (statuscode neq 2 (On Hold)).

    Captura de tela dos detalhes de confirmação e dos critérios de filtragem.

  8. Selecione Salvar.

Testar o botão de ação

Em seguida, você testará o botão de ação executando estas etapas:

  1. Abra o site e entre como usuário.

  2. Selecione Suporte.

  3. Crie um novo caso e insira os dados de sua preferência.

  4. Selecione Salvar.

  5. Confirme se o status é Ativo – Em Andamento e se o botão Em Espera está visível.

  6. Selecione Em Espera. A confirmação será exibida.

    Captura de tela do prompt de confirmação para colocar um caso em espera.

  7. Selecione Cancelar.

  8. Selecione Fechar caso e, em seguida, selecione Sim quando solicitado.

O status do caso deve indicar Resolvido – Problema Resolvido. Somente o botão Reabrir Caso deve estar visível.

Exercício extra

Talvez você precise adicionar o fluxo de trabalho Retomar e um botão de ação ao formulário. O botão de ação só deve estar visível quando o caso está em espera.

Este exercício mostra como o Power Pages ajuda a estender formulários, convertendo formulários simples de entrada de dados em uma parte de um aplicativo Web.