Conecte-se a outros ambientes usando o conector do Microsoft Dataverse (versão preliminar)

[Este tópico faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Você pode automatizar aplicativos, dados e processos em ambientes do Power Platform por meio de ações e gatilhos compatíveis no conector do Microsoft Dataverse.

Importante

• Este é um recurso em versão preliminar.
• Os recursos de versão preliminar não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.

Anteriormente, o conector do Microsoft Dataverse suportava o ambiente atual do fluxo. Os conectores do Dynamic 365 (preterido) e do Microsoft Dataverse (herdado) eram as formas disponíveis de conexão do Dataverse em outros ambientes a partir de fluxos da nuvem. Com a adição do parâmetro Ambiente, os Microsoft Dataverse gatilhos e ações do conector têm a mesma flexibilidade de se conectar ao ambiente atual do fluxo ou escolher outro.

Durante a visualização desse recurso, ações e gatilhos separados com nomes que terminam em ambiente selecionado (versão preliminar) estão disponíveis para serem adicionados a fluxos novos e existentes. Após a exibição, as ações do conector do Dataverse nos fluxos existentes serão atualizadas automaticamente para incluir o parâmetro Ambiente. Não há nenhuma ação necessária por parte dos proprietários do fluxo ou alterações no comportamento do fluxo existente como parte desta atualização.

Importante

As ações atualizadas com o parâmetro Ambiente serão lançadas como uma versão preliminar pública em todas as regiões do Power Platform até o final de outubro 2023.

O diagrama a seguir mostra um fluxo da nuvem do Power Automate sendo acionado quando uma linha é alterada no ambiente de Suporte da Contoso. Ele executa ações em outros ambientes do Contoso Services e do Contoso Field Service para listar linhas, adicionar uma linha e executar uma ação no exemplo de locatário do Microsoft Entra da Contoso Corporation.

Adicione ações que se conectam a outros ambientes

1. Entre no Power Automate.

2. Crie um novo fluxo da nuvem, como um fluxo instantâneo, com o gatilho Acionar manualmente um fluxo.

   Como alternativa, você pode abrir um fluxo existente.

3. No designer de fluxo, selecione o sinal de mais (+) para adicionar uma nova ação.

4. Pesquise dataverse e selecione Ver mais no conector do Microsoft Dataverse para ver todas as ações disponíveis.

   

5. Adicione uma das ações que termina em ambiente selecionado (versão preliminar), como Listar linhas do ambiente selecionado (versão preliminar).

6. Use o parâmetro Ambiente no cartão de ação para escolher o ambiente para se conectar. A conexão usada para a ação deve ter permissões para executar a operação no outro ambiente.

   

7. Para se conectar ao Dataverse no mesmo ambiente que o fluxo, selecione (Atual) no parâmetro Ambiente.

Ações e gatilhos que podem se conectar a outros ambientes

As seguintes ações do conector do Microsoft Dataverse oferecem suporte à conexão com outros ambientes. No designer de fluxo, as ações de exibição com o parâmetro de ambiente têm nomes que terminam em ambiente selecionado (versão preliminar) para cada uma das ações a seguir.

• Adicionar uma nova linha
• Atualizar uma linha
• Excluir uma linha
• Listar linhas
• Obter uma linha por ID
• Executar uma ação associada
• Executar uma ação não associada
• Relacionar linhas
• Linhas não relacionadas
• Carregar um arquivo ou uma imagem
• Baixar um arquivo ou uma imagem

As ações para pesquisar linhas e executar uma solicitação do conjunto de alterações ainda não possuem ações de visualização com o parâmetro Ambiente.

Os gatilhos a seguir oferecem suporte à conexão com outros ambientes, mas ainda não foram lançados:

• Quando uma linha é adicionada, modificada ou excluída
• Quando uma ação é executada

Os gatilhos a seguir não darão suporte ao parâmetro Ambiente, pois só são aplicáveis ​​ao mesmo ambiente em que o fluxo está localizado.

• Quando uma etapa do fluxo é executada a partir de um fluxo do processo empresarial
• Quando uma linha é selecionada

Recursos suportados pelo parâmetro Ambiente nas ações e gatilhos da versão preliminar

• Conecte-se a outros ambientes no mesmo locatário que a conexão usada com a ação ou gatilho.
• Conecte-se a ambientes em outros locatários ao usar uma conexão com outro locatário.
  • Para restringir conexões com outros locatários do conector do Microsoft Dataverse e de outros conectores, você pode configurar as políticas de isolamento do locatário do Power Platform. Para saber mais, vá para Restrições de entrada e saída entre locatários.
• Especifique o ambiente de forma dinâmica.
• As conexões da entidade de serviço podem ser usadas para se conectar a outros ambientes.

Adicione ações que se conectam a outros ambientes de forma dinâmica

Para definir o parâmetro Ambiente dinamicamente em vez de selecionar um ambiente específico, selecione Inserir valor personalizado no final do seletor de parâmetro Ambiente e forneça o URL raiz de um ambiente do Power Platform no formato https://<yourenvironmentid>.crm.dynamics.com/. A URL pode ser fornecida como uma string, uma expressão, uma variável de ambiente ou como conteúdo dinâmico do gatilho ou de outras ações no fluxo.

Para obter o URL raiz de um ambiente, você pode abrir a página de detalhes do ambiente no Centro de administração do Power Platform, ou usar a saída da ação Listar ambientes de usuário no conector Gerenciamento do Power Automate.

Para ações como Adicionar uma linha que dependem do esquema de tabela específico de um ambiente, o esquema não será recuperado automaticamente ao especificar o ambiente dinamicamente. A solicitação deve ser criada manualmente usando o LogicalCollectionName da tabela e o corpo da solicitação no formato JSON, semelhante a uma Solicitação de API da Web do Dataverse. Por exemplo, contas e { "nome": "Marketing Contoso" }.

Práticas recomendadas

• Para obter melhor desempenho, implante fluxos usando o conector do Microsoft Dataverse ao mesmo ambiente do Power Platform como os dados e aplicativos aos quais eles estão se conectando.
  • O conector do Microsoft Dataverse no Power Automate é otimizado para se conectar diretamente ao Dataverse por meio de uma integração nativa quando o parâmetro Ambiente está definido como (Current).
  • Ao se conectar a outros ambientes, ele se conecta através da Plataforma de conectores do Power Platform.
• Revise as práticas recomendadas de administração e governança em torno de sua Estratégia de ambiente do Power Platform ao planejar soluções que se conectam a outros ambientes, incluindo a preparação de fluxos em ambientes separados de desenvolvimento, teste e produção para grupos de negócios específicos e formulários.

Limitações

• O uso de fluxos instantâneos com a conexão do Dataverse definida como Fornecido pelo usuário somente para execução ainda não é compatível.
• Os gatilhos Quando uma linha é adicionada, modificada ou excluída e Quando uma ação é executada não suportam o Parâmetro de ambiente ainda.
• As ações para Pesquisar linhas e Executar uma solicitação do conjunto de alterações ainda não possuem ações de versão preliminar com o parâmetro Ambiente.