Gatilhos do Dataverse
Com o Power Automate, você pode criar fluxos de trabalho automatizados na nuvem com um gatilho e diversas ações. Um gatilho é um evento que inicia um fluxo da nuvem. O conector do Dataverse dá suporte a quatro gatilhos que permitem o início de fluxos com base em eventos de dados do Dataverse.
Os gatilhos no conector do Dataverse são os seguintes:
Quando uma linha é adicionada, modificada ou excluída: use esse gatilho para iniciar um fluxo quando uma linha for adicionada, modificada ou excluída em uma tabela do Dataverse. Por exemplo, quando você adiciona uma nova linha à tabela Projeto, o sistema deve executar um fluxo.
Quando uma ação é executada: esse gatilho ocorre quando uma ação do Dataverse é concluída. Como resultado, o sistema dispara fluxos de eventos de negócios personalizados definidos por você. Por exemplo, você poderia criar um evento EmployeeOnboarded e usá-lo para disparar fluxos.
Quando uma etapa do fluxo é executada por meio de um fluxo do processo empresarial: com esse gatilho, você pode iniciar um fluxo quando alguém seleciona o botão Executar Fluxo em uma etapa de fluxo de processo empresarial. Por exemplo, em um aplicativo baseado em modelo do Microsoft Power Apps que usa um fluxo do processo empresarial, pode criar um etapa que inicia um fluxo para obter a aprovação de um gerente.
Quando uma linha é selecionada: esse gatilho inicia um fluxo quando um usuário em um aplicativo baseado em modelo do Power Apps seleciona uma linha e executa o fluxo.
Cada gatilho tem opções diferentes que você precisa configurar. Alguns gatilhos têm opções avançadas que fornecem controle extra sobre os comportamentos do gatilho. O restante deste tópico realça algumas das opções mais comuns que você pode configurar.
Quando uma linha é adicionada, modificada ou excluída
Para usar o gatilho Quando uma linha é adicionada, modificada ou excluída, você precisa configurar o tipo de alteração, a tabela e as opções de escopo no gatilho. Todas as outras configurações são opcionais.
Tipo de alteração
Use o gatilho Tipo de alteração para configurar um ou mais eventos de linha de dados que você deseja disparar o fluxo. Por exemplo, você pode optar por executar o fluxo quando uma linha for adicionada, modificada ou excluída ou combinações dessas ações. Esses eventos de linha de dados disparam o fluxo após a alteração na linha ocorrer no ambiente do Dataverse.
Se você adicionar ou modificar o tipo de alteração, a linha atual da tabela do Dataverse estará disponível como saída para uso nas etapas subsequentes da área de conteúdo dinâmico. Se você excluir o tipo de alteração, somente a ID da linha do Dataverse estará disponível.
Se disparar seu fluxo em vários tipos de alteração e precisar de lógica condicional dependendo do tipo, você poderá usar a expressão a seguir para obter o tipo de alteração que disparou o fluxo. A propriedade SdkMessage contém criação, atualização ou exclusão.
triggerBody()?['SdkMessage']
Se você concluir várias atualizações para uma linha, o fluxo poderá ser disparado para cada atualização, mesmo que os valores da coluna da linha não sejam alterados. Essa situação ocorre porque você concluiu a atualização na linha diversas vezes. A lógica do fluxo deve levar esse fator em consideração.
Nome da tabela
Você pode escolher o nome da tabela na lista completa ou filtrar a lista começando a digitar o nome da tabela. Os nomes das tabelas não são apresentados em ordem alfabética; portanto, usar o filtro pode ser útil em ambientes com um grande número de tabelas.
Escopo
Ao criar uma tabela do Dataverse, você especifica o tipo de propriedade da linha. A organização pode ser proprietária das linhas ou um usuário ou equipe pode ser proprietário delas.
Você pode usar a opção de escopo para especificar quais linhas se qualificam para disparar o fluxo com base em quem é o proprietário da linha que está sendo modificada. Se a propriedade da linha da tabela for organização, a única opção de escopo será a organização. Para tabelas que permitem propriedade de usuário ou equipe, você pode escolher qualquer uma das seguintes opções de escopo:
Organização: essa opção é o padrão. Qualquer usuário que seja proprietário de uma linha e a modifique poderá disparar seu fluxo. Além disso, qualquer pessoa que modifique tabelas de propriedade da organização pode disparar seu fluxo.
Usuário: esta opção é a mais limitadora; seu fluxo só será executado se a linha modificada for de sua propriedade.
Unidade de Negócios: essa opção disparará seu fluxo se alguém em sua unidade de negócios for proprietário da linha modificada. Por exemplo, considere um cenário em que você está na unidade de negócios Marketing com 16 usuários. Sempre que qualquer um desses 16 usuários concluir uma ação, ele poderá disparar seu fluxo se qualquer outra pessoa na unidade de negócios for proprietária da linha modificada.
Divisões Primária e Secundárias: essa opção inclui usuários da divisão secundária para determinar quais ações podem disparar seu fluxo. Portanto, se a unidade de negócios de Marketing tiver unidades de negócios secundárias de Marketing — EUA e Marketing — EMEA, o sistema incluirá esses usuários para determinar se seu fluxo deve ser executado.
Organização e usuário são as configurações mais comuns. O escopo da organização será melhor se você estiver criando um fluxo para todos os usuários. O escopo do usuário será melhor se você estiver criando sua própria automação pessoal e quiser minimizar dados aleatórios ou irrelevantes inseridos por outros usuários.
Embora você possa configurar o escopo para incluir mais linhas de dados do que as que você tem privilégios para ler, seu fluxo só é disparado para as linhas que você tem privilégios para ler.
Além das opções obrigatórias, o gatilho tem as seguintes opções Avançadas para modificação adicional:
Selecionar colunas
Filtrar linhas
Atrasar até
Executar como
Selecionar colunas
A opção Selecionar colunas só se aplica quando você define o tipo de alteração para incluir linhas modificadas. Você pode fornecer uma lista de colunas de tabela que, se forem incluídas na modificação da linha de dados, farão com que o fluxo seja executado.
Essa opção é um recurso útil para reduzir as execuções dos fluxos. Por exemplo, se você quiser executar um fluxo apenas se as colunas Nome e Sobrenome da tabela Contato forem modificadas, defina a opção Selecionar colunas da seguinte forma:
firstname,lastname
Também é importante usar esse recurso se o fluxo pretender usar uma ação de atualização de linha posteriormente para atualizar colunas na linha que disparou o fluxo. Para evitar um loop infinito, não inclua as colunas atualizadas na opção Selecionar colunas.
Filtrar linhas
Use a opção Filtrar linhas para filtrar as linhas que disparam seu fluxo com base nos valores das colunas da linha. Por exemplo, você pode filtrar as linhas da tabela Projeto para incluir apenas linhas que excedem o orçamento. Embora adicionar uma verificação de condição às ações de fluxo possa realizar a mesma tarefa, é menos eficiente do que usar uma expressão de linhas de filtro.
Você pode especificar linhas de filtro usando uma expressão OData. O fluxo é executado apenas quando o sistema avalia a expressão como verdadeira após você salvar a alteração no Dataverse.
contoso_amountoverbudget gt 10000
Este módulo explora expressões OData comuns posteriormente no tópico de consulta de dados.
Atrasar até
Você pode usar Atrasar até para especificar um horário específico para atrasar a avaliação de gatilho. Usando um carimbo de data/hora estilo OData, você pode atrasar o gatilho de fluxo até um horário UTC específico.
Um dos principais benefícios de usar essa opção em comparação com uma ação Atrasar até é que a propriedade Adiar até do Dataverse desse gatilho nunca expira, permitindo que o fluxo seja executado por longos períodos.
Executar como
Usando a opção executar como, você pode definir cada ação do Dataverse no fluxo para ser executada usando o contexto de um usuário diferente do proprietário do fluxo. O proprietário do fluxo deve ter o privilégio Agir em Nome de Outro Usuário do Dataverse. O direito de acesso Delegado inclui esse privilégio por padrão, mas você pode adicioná-lo a qualquer direito de acesso.
Você pode definir o recurso executar como com as seguintes opções:
Proprietário do fluxo: o usuário que criou o fluxo.
Proprietário da linha: o usuário que é proprietário da linha do Dataverse que disparou o fluxo. Se uma equipe for proprietária de uma linha, essa opção voltará a ser executada como proprietária do fluxo.
Usuário da modificação: o usuário que executou a ação na linha do Dataverse, fazendo com que o fluxo fosse disparado ou modificado.
Para cada ação do Dataverse que você deseja executar como um usuário diferente, selecione Usar a conexão do invocador na guia Configurações da ação.
Considere o exemplo a seguir. John cria um fluxo que adiciona tarefas às novas linhas da tabela do Projeto. Se Mary criar uma nova linha de Projeto, o fluxo será executado e o sistema adicionará novas tarefas. Depois disso, John poderá exibir as tarefas recém-adicionadas.
Se John alterar a opção executar como para usuário da modificação e alterar o recurso adicionar linha das tarefas para Usar a conexão do invocador, as linhas da tarefa mostrarão Mary como a criadora em vez de John.