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.
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 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.
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 Select columns para definir as colunas específicas da linha que devem fazer com que o fluxo seja executado quando incluído na solicitação, como uma lista separada por vírgulas de nomes de colunas exclusivos. Inclua somente colunas com valores alterados em solicitações de atualização. O fluxo será executado quando os valores incluídos forem 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')
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.
- 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.
- 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.
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:
Vá para a página de visão geral do fluxo.
Selecione Editar nas configurações Executar apenas usuários.
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.