Fluxos de gatilho quando uma linha é adicionada, modificada ou excluída

O gatilho Quando uma linha for adicionada, modificada ou excluída executa um fluxo sempre que uma linha de uma tabela e um escopo selecionados é alterada ou criada.

Pré-requisitos

• Para criar um fluxo que é acionado quando você cria, modifica ou exclui uma linha, você deve ter permissões de nível de usuário para criar, ler, gravar e excluir na tabela Registro de Retorno de Chamada.

• Além disso, dependendo dos escopos definidos no fluxo, talvez você precise pelo menos desse nível de leitura na mesma tabela. Você pode obter mais informações sobre Segurança de ambiente.

As seguintes informações são necessárias para usar o gatilho Quando uma linha for adicionada, modificada ou excluída.

• Condição do gatilho
• Nome da tabela
• Scope

Observação

O Power Automate usa o designer de fluxos da nuvem clássica ou o designer de fluxos da nuvem com o Copilot. Para identificar qual designer você está usando, vá para a seção Observação em Entender o novo designer de fluxos da nuvem com os recursos do copiloto.

Designer clássico

Defina os parâmetros diretamente no cartão para o gatilho Quando uma linha é adicionada, modificada ou excluída.

Editar com o Copilot

Em seu fluxo, selecione o cartão para o trigger Quando uma linha é adicionada, modificada ou excluída. Um painel é aberto à esquerda com a guia Parâmetros selecionada.

Condição do gatilho

A condição do gatilho, Tipo de alteração, define com precisão qual combinação de alterações em uma linha executaria o fluxo.

Quando o fluxo é acionado pela criação, atualização ou exclusão de uma linha, o valor de triggerOutputs()['body/SdkMessage'] vai ser Create, Update, ou Delete, respectivamente.

Se houver várias atualizações em uma única linha em uma tabela, o Power Automate avaliará o gatilho para cada atualização, mesmo que os valores que estiverem sendo atualizados na linha sejam iguais ao valor anterior. Essas atualizações podem levar a várias execuções de fluxo.

Nome da tabela

A lista Nome da tabela filtra as linhas para indicar precisamente quais tipos de linhas devem ser alterados antes que o fluxo seja acionado. Consulte as Tabelas no Dataverse.

O gatilho Quando uma linha é adicionada, modificada ou excluída não é oferece suporte ao desencadeamento de fluxos em relacionamentos do tipo 1:N ou N:N.

Scope

A lista Escopo indica as linhas que devem ser monitoradas para determinar se o fluxo deve ser executado.

Veja o que cada escopo significa:

Scope	Nível de propriedade de linha
Unidade de Negócios	As ações são realizadas em linhas de propriedade de qualquer pessoa na sua unidade de negócios.
Organização	As ações são realizadas por qualquer pessoa dentro do ambiente.
Pai: divisão secundária	As ações são realizadas em linhas que pertencem a qualquer pessoa na sua unidade de negócios ou em uma divisão secundária.
Usuário	As ações são realizadas em linhas de sua propriedade.

Opções avançadas

Você pode definir propriedades adicionais para definir mais granularmente quando o fluxo é executado e o perfil de usuário sob o qual ele é executado.

Designer clássico

Para acessar as opções avançadas, selecione Mostrar opções avançadas.

Editar com o Copilot

[Este tópico faz parte da documentação de pré-lançamento e está sujeito a alterações.]

1. Para acessar as opções avançadas, selecione o cartão Listar linhas.

2. Na guia Parâmetros, selecione Adicionar novos parâmetros no menu suspenso.

   

Condições de filtro

Use as condições de filtro para definir as condições de quando acionar fluxos.

Colunas de filtro

Use a caixa Selecionar colunas para definir as colunas específicas da linha que devem fazer com que o fluxo seja executado quando alteradas, como uma lista de nomes de colunas exclusivos separados por vírgula.

Esta propriedade aplica-se somente à condição Atualizar. Criar e Excluir aplicam-se a todas as colunas de uma linha.

Esta propriedade não é suportada em tabelas virtuais.

Expressão de filtro

A expressão de filtro fornece uma maneira de definir uma expressão de filtro de estilo OData para ajudar você a definir as condições de acionamento com ainda mais precisão. O fluxo é executado apenas quando a expressão é avaliada como verdadeiro depois que a mudança for salva no Dataverse. Nos exemplos a seguir, o fluxo é acionado quando firstname é atualizado para "John".

Exemplos para Filtrar linhas:

firstname eq 'John'

contains(firstname,'John')

Para saber como criar estas expressões de filtro, acesse os exemplos nos operadores de filtro padrão e funções de consulta.

Ao contrário dos exemplos nos links de referência, sua expressão não deve conter a cadeia de caracteres $filter=. Esta cadeia de caracteres aplica-se apenas quando você usa as APIs diretamente.

Condição de espera usando a propriedade Atrasar até

Use um carimbo de data/hora estilo OData na propriedade Atrasar até para atrasar o gatilho de fluxo até um horário UTC específico.

O principal benefício de usar a propriedade Atrasar até do Dataverse em vez da ação padrão Atrasar até que a propriedade Atrasar até do Dataverse nunca expira, permitindo que a execução do fluxo espere por longos períodos de tempo.

Representação de usuário usando Executar Como

O proprietário do fluxo deve ter o privilégio Agir em nome de outro usuário (prvActOnBehalfOfAnotherUser) do Microsoft Dataverse. O direito de acesso Delegar inclui este privilégio por padrão. Você pode habilitá-lo em qualquer direito de acesso. Para mais detalhes, vá para Representar outro usuário.

Quando cria fluxos com o gatilho Quando uma linha for adicionada, modificada ou excluída, você pode definir cada ação do Microsoft Dataverse no fluxo a ser executada usando o contexto de um usuário que não seja o proprietário do fluxo.

Siga estas etapas para representar um usuário.

Designer clássico

1. No designer, selecione um valor para Executar como informe ao Microsoft Dataverse qual contexto do usuário você pretende usar para ações do Dataverse.
2. Para cada ação Dataverse que você deseja executar como um usuário diferente, selecione as reticências (...) no canto superior direito e, em seguida, selecione a configuração Usar a conexão do invocador.

Para as etapas em que ela não for selecionada, o usuário padrão é presumido. Isso chama as APIs subjacentes de acordo com o usuário selecionado, e não como o proprietário do fluxo. Se nada for especificado, o padrão será o proprietário do fluxo que criou o fluxo: ou seja, o autor.

Editar com o Copilot

Para cada ação do Dataverse que você deseja executar como um usuário diferente, selecione uma opção no menu suspenso Executar como .

Para as etapas em que ela não for selecionada, o usuário padrão é presumido. Isso chama as APIs subjacentes de acordo com o usuário selecionado, e não como o proprietário do fluxo. Se nada for especificado, o padrão será o proprietário do fluxo que criou o fluxo: ou seja, o autor.

Estas são as outras opções:

• Proprietário do fluxo: o usuário que criou o fluxo.

• Proprietário da linha: o usuário que possui a linha do Microsoft Dataverse que sofreu uma alteração, fazendo com que o fluxo fosse disparado. Se uma linha pertencer a uma equipe, essa opção voltará a ser executada como o proprietário do fluxo.

• Usuário da modificação: o usuário que executou a ação na linha do Microsoft Dataverse, fazendo com que o fluxo fosse acionado ou modificado.

Além disso, os fluxos instantâneos permitem executar as etapas de qualquer outro conector, como Microsoft Teams, Outlook do Microsoft 365 ou SharePoint no mesmo fluxo usando a conexão do invocador. Para fazer isso, siga estas etapas:

1. Vá para a página de visão geral do fluxo.

2. Selecione Editar nas configurações Executar apenas usuários.

3. No painel Gerenciar permissões somente de execução, vá para a guia Usuário e grupos e selecione Fornecido pelo usuário somente de execução na lista Conexões Usadas.