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

Em seu fluxo, selecione o cartão para o gatilho 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 a combinação de alterações em uma linha que aciona o fluxo.

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

Quando ocorrem várias atualizações em uma única linha em uma tabela, Power Automate avalia o gatilho para cada atualização, mesmo que os valores atualizados sejam os mesmos dos anteriores. Essas atualizações podem resultar em várias execuções de fluxo.

Nome da tabela

A lista Nome da tabela filtra as linhas cujas alterações ocorrem antes de o fluxo ser acionado. Saiba mais em Tabelas no Dataverse.

O gatilho Quando uma linha é adicionada, modificada ou excluída não oferece suporte ao desencadeamento de fluxos nos 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:

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 acionar o fluxo quando incluídas na solicitação, como uma lista separada por vírgulas de nomes de colunas exclusivas. Inclua apenas colunas com valores alterados em solicitações de atualização. O fluxo é executado quando os valores incluídos são os mesmos que os valores existentes.

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')

Saiba mais em operadores de filtro padrão e funções de consulta.

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

Condição do gatilho

A condição do gatilho, Tipo de alteração, define a combinação de alterações em uma linha que aciona o fluxo.

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

Quando ocorrem várias atualizações em uma única linha em uma tabela, Power Automate avalia o gatilho para cada atualização, mesmo que os valores atualizados sejam os mesmos dos anteriores. Essas atualizações podem resultar em várias execuções de fluxo.

Nome da tabela

A lista Nome da tabela filtra as linhas cujas alterações ocorrem antes de o fluxo ser acionado. Saiba mais em Tabelas no Dataverse.

O gatilho Quando uma linha é adicionada, modificada ou excluída não oferece suporte ao desencadeamento de fluxos nos 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:

Para acessar os parâmetros avançados, selecione Mostrar tudo no campo Parâmetros avançados.

Condição de espera usando 'Atrasar até'

Use uma marca de data e hora no estilo de OData na propriedade Atrasar até para adiar o gatilho do fluxo até um tempo específico UTC.

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 Microsoft Dataverse Agir Em Nome De Outro Usuário (prvActOnBehalfOfAnotherUser). A função de segurança Delegado inclui este privilégio por padrão. Você pode habilitá-lo em qualquer função de segurança. Saiba mais em Representar outro usuário.

Quando você cria fluxos com o gatilho Quando uma linha é 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 diferente do proprietário do fluxo.

Para representar um usuário, siga estas etapas. Para cada ação do Dataverse que você deseja executar como se fosse outro usuário, selecione uma opção no menu suspenso Executar como.

Para as etapas em que não estiver selecionado, o usuário padrão é considerado. Isso chama as APIs subjacentes de acordo com o usuário selecionado, não 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 é alterada, acionando o fluxo. Se uma equipe for proprietária de uma linha, essa opção é configurada para executar como o proprietário do fluxo.

• Usuário modificador: o usuário que interagiu com a linha do Microsoft Dataverse, acionando ou modificando o fluxo.

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

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 acionar o fluxo quando incluídas na solicitação, como uma lista separada por vírgulas de nomes de colunas exclusivas. Inclua apenas colunas com valores alterados em solicitações de atualização. O fluxo é executado quando os valores incluídos são os mesmos que os valores existentes.

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')

Saiba mais em 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 'Atrasar até'

Use uma marca de data e hora no estilo de OData na propriedade Atrasar até para adiar o gatilho do fluxo até um tempo específico UTC.

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 Microsoft Dataverse Agir Em Nome De Outro Usuário (prvActOnBehalfOfAnotherUser). A função de segurança Delegado inclui este privilégio por padrão. Você pode habilitá-lo em qualquer função de segurança. Saiba mais em Representar outro usuário.

Quando você cria fluxos com o gatilho Quando uma linha é 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 diferente do proprietário do fluxo.

Para representar um usuário, siga estas etapas:

1. No designer, selecione um valor para Run as para especificar qual contexto do usuário Microsoft Dataverse usa para ações subsequentes do Dataverse.
2. Para cada ação do Dataverse que você quer executar como um usuário diferente, selecione as reticências (...) no canto superior direito e, em seguida, selecione Usar a conexão do invocador.

Para as etapas em que não estiver selecionado, o usuário padrão é considerado. Isso chama as APIs subjacentes com base no usuário selecionado, em vez do 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 de dados do Microsoft Dataverse que é alterada, acionando o fluxo. Se uma equipe for proprietária de uma linha, essa opção é padronizada para ser executada como proprietária do fluxo.

• Modifying user: o usuário que atuou na linha do Microsoft Dataverse, acionando ou modificando o fluxo.