Ações comuns
As ações usadas no Power Automate são definidas pelos conectores. Cada conector tem seu próprio conjunto de ações. As seções a seguir explicam as ações comuns entre Power Automate e Dataverse.
O conector Dataverse tem as seguintes ações:
- Criar um novo registro
- Obter registro
- Listar registros
- Atualizar um registro
- Excluir um registro
O conector Common Dataverse (ambiente atual) tem as mesmas ações, além de várias outras:
- Criar uma nova linha
- Obter uma linha por ID
- Listar linhas
- Atualizar uma linha
- Excluir uma linha
- Relacionar linhas
- Linhas não relacionadas
- Executar uma solicitação changeset
- Baixar um arquivo ou uma imagem
- Carregar um arquivo ou uma imagem
- Executar uma ação associada
- Executar uma ação não associada
- Prever com modelos do AI Builder
O conector Dataverse também permite a criação e o uso de fluxos filhos.
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, verifique se você especificou apenas os campos de coluna necessários para o fluxo.
A maioria dos gatilhos do Dataverse fornece todos os campos, e 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
Ao fazer referência a dados que já foram recuperados em um fluxo, esses 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 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.
- Usar a ferramenta FetchXMl Builder em XrmToolBox para criar suas consultas OData e FetchXML.
- Habilitar a paginação se desejar mais de uma página de dados. O tamanho da página é determinado pelo conector, e no Dataverse é 1024. A paginação é habilitada por meio das configurações de ação. O limite é 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.
- Fornecer um GUID para a ID principal se você estiver usando uma chave Alternativa, que executará uma operação Upsert 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.