Exercício: implementar um gatilho de sondagem

  • 10 minutos

Neste exercício, você adicionará um gatilho de sondagem ao conector personalizado para uma API da Contoso Invoicing.

Importante

Use um ambiente de teste com o Microsoft Dataverse provisionado. Se você não tiver um, poderá se inscrever no plano da comunidade.

Tarefa 1: Importar a solução com o conector personalizado

Observação

Você pode continuar usando o conector criado e modificou na Unidade 4: Implementar um gatilho de webhook. Se você concluiu esse exercício, pode avançar para a Tarefa 2.

Observação

Baixe o arquivo a seguir no computador local para fazer este exercício Contoso Invoicing Triggers. Selecione o botão download no meio à direita da tela.

Nesta tarefa, você importará uma solução não gerenciada contendo um conector personalizado predefinido para a API do Contoso Invoicing.

  1. Vá para o Power Apps Maker Portal e verifique se está no ambiente correto.

  2. Selecione Soluções > Importar.

  3. Selecione Procurar.

  4. Selecione a solução ContosoInvoicingTriggers_1_0_0_0.zip e, em seguida, clique em Abrir.

  5. Selecione Avançar.

  6. Selecione Importar e aguarde a conclusão da importação. Uma mensagem de êxito deve aparecer após a conclusão da importação.

  7. Selecione Publicar Todas as Personalizações e aguarde o término da publicação.

  8. Abra a solução Contoso invoicing triggers que você importou.

    Você deve ver o componente do conector personalizado Contoso Invoicing Triggers.

    Captura de tela do componente Contoso Invoicing Triggers realçado.

  9. Vá para o Contoso Invoicing.

  10. Selecione o link Chave de API.

    Captura da tela do link da chave de API realçada.

  11. Copie a Chave de API e cole-a em um bloco de notas para uso futuro.

  12. Retorne ao Power Apps Maker Portal e verifique se está no ambiente.

  13. Escolha Soluções e abra a solução Contoso Invoicing Triggers.

  14. Abra o conector personalizado de Gatilhos da Contoso Invoicing.

  15. Selecione Editar.

    Captura de tela de uma seta apontando para o botão do conector de edição.

  16. Insira contosoinvoicing.azurewebsites.net no Host.

  17. Selecione Atualizar conector.

  18. Selecione Testar > + Novo Conector.

    Captura de tela de uma seta apontando para o botão para adicionar nova conexão.

  19. Cole a Chave de API e selecione Criar conexão.

    Captura de tela do botão Criar conexão.

  20. Selecione Atualizar. A conexão criada deve ser selecionada automaticamente.

  21. Role até a seção Operações, selecione ListInvoice e Testar operação.

    Captura de tela de uma seta apontando para o botão Testar operação.

    Você verá uma lista de faturas na seção Corpo.

    Captura de tela de uma lista de faturas na seção Corpo.

  22. Não saia desta página.

Tarefa 2: Adicionar um gatilho de sondagem

Se você tiver ignorado a tarefa anterior, acesse o conector personalizado de Gatilhos da Contoso invoicing e selecione Editar.

  1. Selecione Definição.

    Captura de tela da guia Definição selecionada.

  2. Role até a seção Gatilhos e selecione + Novo gatilho.

  3. Forneça os seguintes valores:

    • Resumo: quando a Fatura é Criada (Votação)

    • Descrição: quando a Fatura é Criada (Votação)

    • ID da Operação: InvoiceCreatedPoll

    • Tipo de gatilho: sondagem

    Captura de tela das propriedades do gatilho do conector.

  4. Vá para a seção Solicitação e selecione + Importar da amostra.

    Captura de tela de uma seta apontando para o botão Importar da amostra.

  5. Insira os valores a seguir e selecione Importar.

    • Verbo: GET

    • URL - https://contosoinvoicing.azurewebsites.net/ListInvoices?fromDate=

  6. Selecione as reticências no botão de divisa ao lado de fromDate e selecione Editar.

    Captura de tela de uma seta apontando para o botão editar consulta.

  7. Selecione interna para Visibilidade e, depois, selecione o botão Voltar.

    Captura de tela da opção de visibilidade de parâmetros definida como interna.

  8. Role até a seção Resposta e selecione + Adicionar resposta padrão.

  9. Cole o código JSON a seguir no campo Corpo e selecione Importar.

     {
   "invoices": [
     {
       "invoiceId": "1933",
       "date": "2021-01-26T04:02:52.1490835Z",
       "createDate": "2021-01-25T04:02:52.1490835Z",
       "amount": 5000,
       "accountId": "1001",
       "accountName": "Wing Tips",
       "status": "Invoiced",
       "typeId": 1,
       "purchaseOrderId": "3002",
       "tags": "New Account;Special Pricing"
     }
   ]
 }

    Captura de tela da resposta padrão de importação.

  10. Acesse a seção Configuração do gatilho e forneça os seguintes valores:

    • Selecione o parâmetro de consulta para monitorar a alteração de estado: fromDate

    • Especifique o valor a ser passado ao parâmetro de consulta selecionado. Você pode escolher expressões - @{triggerBody().invoices[0].createDate}

    • Selecione a coleção que contém dados do gatilho - @triggerBody().invoices

    Captura de tela da seção Configuração do gatilho com valores.

  11. Selecione o botão Atualizar conector localizado na parte superior da tela e aguarde até que o conector seja atualizado.

Tarefa 3: Testar o gatilho

Se você já concluiu a Unidade 4: implementar um gatilho de webhook e criou o fluxo de nuvem Criar fatura, avance para a etapa 14.

  1. Vá para o Power Apps Maker Portal e verifique se está no ambiente.

  2. Escolha Soluções e abra a solução Contoso Invoicing Triggers.

  3. Selecione + Novo > Fluxo da nuvem.

  4. Insira Criar fatura para o nome e, depois, selecione Disparar um fluxo manualmente para o gatilho.

    Captura de tela de uma seta apontando para o gatilho Disparar um fluxo manualmente.

  5. Selecione + Adicionar uma entrada.

  6. Selecione Número para o tipo de entrada.

    Captura de tela de uma seta apontando para o tipo de entrada de número.

  7. Insira Valor para o nome de entrada e selecione + Nova etapa.

    Captura de tela de uma seta apontando para o botão adicionar nova etapa do fluxo.

  8. Escolha a guia Personalizado e selecione o conector personalizado Contoso invoicing.

    Captura de tela de uma seta apontando para o conector personalizado.

  9. Selecione a ação Adicionar Fatura.

  10. Insira Conexão da Contoso no campo Nome da Conexão, cole a Chave de API que você copiou na Tarefa 1 e selecione Criar.

    Captura de tela do botão de criação de conexão.

  11. Selecione o campo valor e, depois, selecione Valor no painel Conteúdo dinâmico.

    Captura de tela da saída do campo de valor da etapa anterior.

  12. Selecione Salvar.

  13. Mantenha essa guia ou janela do navegador aberta.

  14. Inicie uma nova janela do navegador e navegue até https://make.powerapps.com/

  15. Verifique se você selecionou o ambiente correto.

  16. Selecione Soluções e abra as soluções de Contoso Invoicing - Triggers.

  17. Selecione + Novo > Automação > Fluxo da nuvem > Automatizado.

  18. Insira Votação de notificação de fatura para o nome e selecione Ignorar.

  19. Escolha a guia Personalizado e selecione o conector personalizado Contoso invoicing.

    Captura de tela de uma seta apontando para o gatilho do conector personalizado.

  20. Selecione o gatilho Quando a Fatura é Criada (Votação).

    Captura de tela de uma seta apontando para um gatilho do conector personalizado.

  21. Selecione o botão ... Menu do gatilho e, depois, verifique se as Referências de conexão estão selecionadas.

    Captura de tela da seção Referências de conexão.

  22. Selecione +Nova etapa.

  23. Procure Redigir e, em seguida, selecione a ação Redigir.

  24. Selecione o campo Entradas e, em seguida, selecione corpo no painel Conteúdo dinâmico.

    Captura de tela do campo Entradas e corpo do painel de Conteúdo dinâmico.

  25. Selecione Salvar e aguarde até que o fluxo seja salvo.

  26. Selecione Testar.

  27. Selecione Manualmente > Testar. O fluxo será iniciado e você deverá esperar por notificações.

  28. Alterne para a guia ou janela do navegador de fluxo Criar fatura.

  29. Selecione Testar.

  30. Selecione Manualmente > Testar.

  31. Insira 6500 para Valor e selecione Executar fluxo.

  32. Selecione Concluído.

  33. O fluxo deve ser executado com sucesso. Selecione Editar.

    Captura de tela do fluxo bem-sucedido com ícone de edição.

  34. Selecione Testar novamente.

  35. Selecione Manualmente > Testar.

  36. Insira 8800 para Valor e selecione Executar fluxo.

  37. Selecione Concluído. O fluxo deve ser executado com êxito novamente.

  38. Alterne para o fluxo Votação de notificação da fatura. Este fluxo deve ser executado com êxito.

    Observação

    Diferente do gatilho de webhook, pode levar cerca de um minuto para descobrir se o fluxo foi executado com êxito ou não.

  39. Selecione para expandir a etapa de ação Compor.

    Captura de tela de uma seta apontando para a ação de fluxo Compor.

  40. Revise as Saídas e selecione o botão.

    Captura de tela das saídas de ação de fluxo Compor.

    Você verá dois resultados de execução para as duas faturas criadas.

    Captura de tela de detalhes do histórico de execuções de fluxo.