Exercício: criar um fluxo executado quando ocorre um evento no Dynamics 365

  • 14 minutos

Você pode criar fluxos que começam quando ocorre um evento no Microsoft Dataverse ou algum outro serviço. Esses fluxos realizam então uma ação nesse serviço.

No Power Automate, você pode configurar fluxos de trabalho automatizados entre seus aplicativos e serviços favoritos para sincronizar arquivos, obter notificações, coletar dados e muito mais.

Nesta unidade, vamos criar dois fluxos:

  • O primeiro fluxo cria uma tarefa no Microsoft Dataverse quando uma nova Conta é criada.
  • O segundo fluxo copia um item de lista para o Planner quando uma tarefa é criada no Microsoft Dataverse.

Aqui estão alguns exemplos de fluxos que você pode criar usando o Microsoft Dataverse:

  • Criar um item de lista no Microsoft SharePoint quando um objeto é criado no Microsoft Dataverse.
  • Criar registros de conta do Microsoft Dataverse com base em uma tabela do Microsoft Excel.

Pré-requisitos

Importante

Para invocar um gatilho de fluxo, a tabela de participação do cliente do Microsoft Dataverse usada com o fluxo de deve ter controle de alterações ativado. Para obter mais informações sobre como ativar o controle de alterações, veja Habilitar controle de alterações para sincronização de dados de controle.

Exemplo um: criar uma tarefa de uma nova conta

Este exemplo mostra como criar uma nova linha na tabela Tarefas do Dataverse sempre que uma conta é adicionada à tabela Contas do Dataverse. As tabelas Contas e Tarefas fazem parte do Common Data Model e estão disponíveis em todos os ambientes do Microsoft Dataverse.

  1. Entre no Power Automate usando sua conta organizacional e selecione o ambiente para o fluxo.

  2. No painel esquerdo, selecione Meus fluxos.

  3. Selecione Novo fluxo e Fluxo da nuvem automatizado.

  4. Digite um nome para o fluxo em Nome do fluxo. Para este exemplo, digite Criar uma tarefa quando uma conta for criada para o nome do fluxo.

  5. Na lista de gatilhos de fluxo, insira Microsoft Dataverse no campo Pesquisar todos os gatilhos e, em seguida, selecione Microsoft Dataverse - Quando uma linha é adicionada, modificada ou excluída.

  6. Selecione Criar. Se for solicitado a entrar no Dataverse, faça isso.

    Captura de tela da página Criar um novo fluxo com o gatilho definido como Quando uma linha é adicionada, modificada ou excluída.

  7. No painel de tela, selecione a ação de gatilho Quando uma linha é adicionada, modificada ou excluída para abri-la no painel de configuração de ação.

  8. Selecione Adicionado para Tipo de alteração e selecione Contas para Nome da tabela.

  9. Para o Escopo, selecione Organização

    Dica

    O gatilho do Dataverse requer a especificação de um Escopo. O escopo determina se o fluxo é executado quando um usuário em uma unidade de negócios cria um novo registro ou se qualquer usuário na organização cria um novo registro.

    A seguir, adicionamos outra ação usando o Copilot.

  10. No painel Copilot à direita, digite Quando uma nova linha for adicionada a uma tabela do Dataverse, adicionar uma nova linha a outra tabela do Dataverse e pressione ENTER.

    Captura de tela do painel Copilot com a opção Quando uma nova linha for adicionada a uma tabela do Dataverse, adicionar uma nova linha a outra tabela do Dataverse selecionada.

  11. O Copilot expande o fluxo e adiciona a ação Adicionar uma nova linha.

    Observação

    O Copilot pode fornecer um aviso de "Parâmetros inválidos" no gatilho de fluxo à medida que atualiza o fluxo. Se isso acontecer, retorne ao gatilho de fluxo e atualize os parâmetros necessários antes de continuar.

  12. Selecione a ação Adicionar uma nova linha para configurar as propriedades. O painel de configuração de ação à esquerda é exibido.

  13. No campo Nome da tabela, localize/selecione a tabela Tarefas.

  14. Mais campos são mostrados sob a seleção da tabela. Selecione o campo Assunto e, depois, o ícone de conteúdo dinâmico (tem a forma de um raio) para escolher os campos das etapas anteriores.

    Para esta unidade, selecione Nome da conta.

    Captura de tela de Criar um novo registro com o campo Assunto definido como Full name do conteúdo dinâmico.

  15. Selecione Salvar no lado direito da barra de comandos para salvar o fluxo.

Agora, quando uma nova linha é adicionada à tabela Contas, o Power Automate cria uma nova linha na tabela Tarefas, e o Assunto da tarefa é o nome da nova conta.

Exemplo: criar uma tarefa do Planner com base em uma tarefa do Microsoft Dataverse

Este exemplo mostra como criar uma tarefa no Microsoft Planner sempre que uma tarefa é criada no Microsoft Dataverse. O Planner é um serviço que você pode usar para criar listas de tarefas, adicionar lembretes e rastrear tarefas. Para completar o exemplo, você precisará criar um plano no Planner.

  1. Retorne a make.powerautomate.com usando sua conta organizacional e selecione o ambiente para o fluxo.

  2. No painel esquerdo, selecione Meus fluxos.

  3. Selecione + Novo fluxo e Fluxo da nuvem automatizado.

  4. Digite um nome para o fluxo em Nome do fluxo. Para este exemplo, digite Criar uma tarefa do Planner quando uma tarefa do Dataverse for criada para o nome do fluxo.

  5. Digite Dataverse no campo Pesquisar todos os gatilhos e, em seguida, selecione Microsoft Dataverse - Quando uma linha for adicionada, modificada ou excluída.

  6. Selecione Criar.

  7. O novo fluxo será aberto no designer do Power Automate Copilot.

  8. Selecione o gatilho Quando uma linha é adicionada, modificada ou excluída para abrir o painel de configuração de ação e configurar as propriedades.

  9. No campo Alterar tipo, selecione Adicionado.

  10. No campo Nome da tabela, localize/selecione a tabela Tarefas.

  11. No campo Escopo, selecione Organização.

    Captura de tela de quando um registro é criado com Ambiente definido como o padrão, Nome da Tabela definido como Tarefas e Escopo definido como Organização.

    Observação

    Se o gatilho mostrar Conexão inválida, selecione Alterar conexão no painel de configuração de ação à esquerda. Você será solicitado a entrar ou selecionar sua conexão existente.

    Captura de tela da alteração da conexão no painel de configuração de ações.

    Em seguida, adicionamos uma tarefa do planejador.

  12. No painel Copilot à direita, digite Quando uma nova linha for adicionada a uma tabela do Dataverse, adicionar uma nova tarefa do Planner e pressione ENTER.

    Captura de tela de como alterar a conexão no painel de configuração de ação.

  13. O Copilot expande o fluxo e adiciona a ação Criar uma tarefa.

    Observação

    É possível que o Copilot tenha excluído o nome da tabela do gatilho. Verifique se a tabela Tarefas ainda está selecionada e continue.

  14. Selecione a ação Criar uma tarefa para abrir as propriedades no painel de configuração de ação à esquerda.

    Captura de tela das opções de parâmetro da tarefa do Planner para a ação Criar uma Tarefa.

  15. Para ID do Grupo, selecione o menu suspenso e selecione o Grupo que tem seu plano do Planner. Em nosso exemplo, selecionarei Vendas e Marketing.

  16. Para ID do Plano, selecione o plano no menu suspenso. Em nosso exemplo, estamos selecionando Evento de Lançamento de Produto.

  17. No campo Título, digite algum texto e adicione o Subject no painel de conteúdo dinâmico. Em nosso exemplo, para o campo Título, inserimos Iniciar processo de integração para:

  18. Selecione o raio para abrir as opções de conteúdo dinâmico. Como estamos procurando o assunto, começo a digitar Assunto. Assim que o assunto for mostrado na caixa de conteúdo dinâmico, selecione-o.

    Captura de tela do assunto de conteúdo dinâmico da tarefa do Planner.

  19. Selecione Parâmetros avançados e Id do bucket. Você pode selecionar um pop-up de parâmetros avançados para fechá-lo. Agora o campo ID do Bucket é exibido abaixo de Parâmetros avançados.

  20. Para ID do Bucket, selecione o bucket no qual deseja criar a tarefa no menu suspenso (opcional). No nosso exemplo, podemos selecionar Tarefas pendentes, mas se você fez um plano do zero, procure a opção O que fazer em seguida. Caso tenha outros parâmetros para os quais você gostaria de adicionar dados, continue inserindo o conteúdo dinâmico em seus itens de tarefa do Planner no Dataverse. Um exemplo é o campo Data e Hora de Conclusão em que você pode selecionar a data de conclusão do Dataverse.

    Captura de tela de Criar uma tarefa do Planner com ID do Grupo, ID do Plano, Título e ID do Bucket.

    Consulte criar parâmetros de tarefa para obter informações sobre os outros campos que você pode adicionar à sua tarefa.

  21. Selecione Salvar no menu superior direito para salvar o fluxo.

Agora, quando novas tarefas são adicionadas à tabela Tarefas, uma nova tarefa é criada no "Evento de Lançamento de Produto" no Planner.

Limitações da lógica baseada no gatilho

Gatilhos como Quando um item é criado, Quando um item é atualizado e Quando um item é excluído iniciam o fluxo alguns minutos após a ocorrência do evento. Em casos raros, poderão ser necessárias até duas horas para o fluxo ser disparado.

Quando o gatilho ocorre, o fluxo recebe uma notificação, mas o fluxo é executado nos dados que existem quando a ação é executada. Por exemplo, se a criação de um novo item disparar seu fluxo e você atualizar o item duas vezes antes da execução do fluxo, o fluxo será executado apenas uma vez com os dados mais recentes.

Especificar opções avançadas

Ao adicionar uma etapa a um fluxo, você pode selecionar Parâmetros avançados (ou Mostrar opções avançadas no designer antigo) para adicionar um filtro ou uma consulta ordenada que controla como os dados são filtrados.

Por exemplo, você pode usar uma consulta de filtro para recuperar apenas contas ativas ordenadas por endereço de email ao recuperar uma lista de linhas. No exemplo abaixo, selecionamos Filtrar Linhas e Classificar por nos Parâmetros avançados. Para recuperar apenas contas ativas, estamos usando status eq 0. Para ordenar a lista por endereço de email, usamos o nome da coluna Email. Para obter mais informações sobre como filtrar e ordenar por consultas, veja MSDN: $filter e MSDN: $orderby.

Captura de tela das linhas da lista com o Nome da tabela definido como Contas usando Filtrar Linhas e Classificar por.

Práticas recomendadas para opções avançadas

Ao adicionar um valor a uma coluna, você deve fazer a correspondência com o tipo de coluna. Você deve fazer a correspondência, independentemente de inserir um valor ou selecionar um valor no painel de conteúdo dinâmico.

Tipo de coluna Como usar Onde encontrar Nome Tipo de dados
Colunas de texto Colunas de texto exigem uma única linha de texto ou conteúdo dinâmico que seja uma coluna de tipo de texto. Exemplos incluem as colunas Categoria e Subcategoria. Soluções>Solução Padrão>Tarefa>Colunas Categoria Texto
Colunas de inteiro Algumas colunas exigem um dinâmico ou de inteiro que seja uma coluna de tipo inteiro. Exemplos incluem as colunas Porcentagem Concluída e Duração. Soluções>Solução Padrão>Tarefa>Colunas Percentual concluído Número Inteiro
Colunas de data Algumas colunas exigem uma data inserida no formato dd/mm/aaaa ou conteúdo dinâmico que seja uma coluna do tipo data. Exemplos incluem as colunas Criado em, Data de Início, Início Real, Último Tempo de Espera, Término Real e Data de Conclusão. Soluções>Solução Padrão>Tarefa>Colunas Data da Criação Data e Hora
Colunas que exigem uma ID de registro e um tipo de pesquisa Algumas coluna que fazem referência a outro registro de tabela exigem a ID do registro e o tipo de pesquisa. Soluções>Solução Padrão>Conta>Colunas Accountid Chave Primária