Ações comuns
Os conectores definem os usos das ações do Power Automate, e cada conector tem seu próprio conjunto de ações. Esta unidade é sobre as ações entre o Power Automate e o Dataverse.
O conector Dataverse tem muitas ações diferentes:
- Adicionar uma nova linha
- Adicionar uma nova linha ao ambiente selecionado
- Excluir uma linha
- Excluir uma linha do ambiente selecionado
- Baixar um arquivo ou uma imagem
- Baixar um arquivo ou uma imagem do ambiente selecionado
- Obter uma linha por ID
- Obter uma linha por ID do ambiente selecionado
- Listar linhas
- Listar linhas do ambiente selecionado
- Executar uma operação em segundo plano (em versão preliminar no momento)
- Executar uma ação associada
- Executar uma ação limitada no ambiente selecionado
- Executar uma solicitação changeset
- Executar uma ação não associada
- Executar uma ação ilimitada no ambiente selecionado
- Relacionar linhas
- Relacionar linhas no ambiente selecionado
- Pesquisar linhas (em versão preliminar no momento)
- Linhas não relacionadas
- Linhas não relacionadas no ambiente selecionado
- Atualizar uma linha
- Atualizar uma linha no ambiente selecionado
- Carregar um arquivo ou uma imagem
- Carregar um arquivo ou uma imagem no ambiente selecionado
Observação
O conector Dataverse tem muitas vantagens sobre outros conectores e deve ser sua primeira opção com o Power Automate.
Recuperar dados
Ao usar as ações Obter uma linha por ID ou Listar linhas para recuperar dados, você deve especificar apenas os campos de coluna necessários, pois as linhas do Dataverse incluem uma infinidade de metadados.
A maioria dos gatilhos do Dataverse fornece todos os campos, então, não é necessário recuperar explicitamente o registro logo após a execução do gatilho. No entanto, as seguintes exceções se aplicam:
- O gatilho Quando um registro é selecionado não inclui campos de pesquisa muitos para um, e uma ação Obter uma linha por ID é necessária.
- A opção Excluir inclui apenas a ID da linha, mas nenhuma outra coluna.
Observação
Quando você faz referência a dados recuperados anteriormente em um fluxo, os dados não são atualizados automaticamente após a execução da etapa original.
Obter listas de dados
A ação Listar linhas pode ajudar a filtrar os dados usando uma consulta OData ou FetchXML para recuperar dados.
Ao usar a ação Listar linhas, você deve:
- Filtrar os dados na ação Listar linhas, não em uma etapa posterior com ações de Operação de Dados.
- Considerar que os filtros Consulta FetchXML podem atender a critérios mais avançados, incluindo entidades relacionadas.
- Usar o filtro Expandir Consulta para incluir linhas relacionadas no resultado.
- Use a ferramenta FetchXMl Builder em XrmToolBox para criar suas consultas OData e FetchXML.
- Habilite a paginação se desejar mais de uma página de dados. O tamanho da página é determinado pelo conector, e no Dataverse é 1024. Você pode habilitar a paginação na guia de configurações da ação. O limite é de 100.000 linhas.
Observação
O filtro Expandir Consulta pode ajudar a reduzir a complexidade dos fluxos, reduzir o número de chamadas de API realizadas e acelerar os fluxos.
Atualizar dados
Ao usar a ação Atualizar uma linha, você deve:
- Incluir somente as colunas que foram alteradas. Essa abordagem evita o acionamento de outros logs de automação e de auditoria.
- Usar a expressão nula para limpar valores.
- Forneça um GUID para a ID principal. Se você estiver usando uma chave alternativa, o sistema executará uma operação de inserção ascendente usando as outras colunas de dados fornecidas.
Chamar ações personalizadas
A Microsoft usa o termo ação para vários comportamentos diferentes nos processos, para um tipo de processo e para as etapas de processos e fluxos. As ações personalizadas são processos semelhantes aos recursos dos fluxos de trabalho clássicos no que diz respeito ao que pode ser executado com etapas. Em outras palavras, os processos de ação podem usar condições, além de criar e atualizar linhas.
Ações personalizadas são processos reutilizáveis que podem ser iniciados de um código e do Power Automate. A Microsoft também inclui várias ações internas, como:
- Definir Modelo do Word: cria um documento do Microsoft Word com base em um modelo do Word.
- Adicionar à Fila: adiciona um registro a uma fila.
Os fluxos da nuvem do Power Automate podem chamar ações personalizadas usando o conector Dataverse. Você deve usar Executar uma ação limitada para processos de ação associados a uma tabela e usar Executar uma ação não limitada para processos de ação definidos como Globais.