Ligar ao Microsoft Dataverse

Armazene com segurança seus dados corporativos no Dataverse e crie aplicativos avançados no Power Apps para que os usuários possam gerenciar esses dados. Também pode integrar esses dados em soluções que incluem Power Automate, Power BI e os dados do Dynamics 365.

Por predefinição, a aplicação conecta-se ao ambiente atual para tabelas Dataverse. Se a sua aplicação mudar para outro ambiente, o conector é ligado aos dados no novo ambiente. Esse comportamento funciona bem para um aplicativo que usa um único ambiente ou segue um processo de gerenciamento do ciclo de vida do aplicativo (ALM) para passar do desenvolvimento para o teste e, em seguida, para a produção.

Quando você adiciona dados do Dataverse, altere o ambiente e selecione uma ou mais tabelas. Por predefinição, a aplicação liga-se aos dados no ambiente atual.

Se você selecionar Alterar ambiente, especifique um ambiente diferente do qual extrair dados em vez de, ou além de, o ambiente atual.

O nome do ambiente selecionado aparece abaixo da lista de tabelas.

Visibilidade e acesso

Ao selecionar Alterar ambiente, você vê uma lista de ambientes. Mesmo que você veja um ambiente na lista, as funções de segurança no ambiente controlam o que você pode fazer lá. Por exemplo, se você não tiver privilégios de leitura, não poderá ver as tabelas e os registros no ambiente.

Mapeamento do tipo de dados nas Power Apps

O conector Microsoft Dataverse é mais robusto do que o conector do Dynamics 365 e está se aproximando da paridade de recursos. A tabela a seguir lista os tipos de dados no Power Apps e como eles são mapeados para tipos de dados no Dataverse.

funções e operações Power Apps delegáveis para Dataverse

Essas operações do Power Apps, para um determinado tipo de dados, podem ser delegadas ao Dataverse para processamento em vez de processá-lo localmente no Power Apps.

Observações

1. Numéricos com expressões aritméticas (por exemplo, Filter(table, field + 10 > 100)) não são delegáveis. O idioma e o fuso horário não são delegáveis. Não há suporte para a conversão de uma coluna em um número. Se um valor aparecer como um número no Power Apps, mas a fonte de dados de back-end não for um número simples, como moeda, ele não será delegado.
2. Não suporta Trim[Ends] ou Len. Suporta outras funções como Esquerda, Média, Direita, Superior, Inferior, Substituir e Substituir. Além disso, a transmissão como Texto(coluna) não é suportada para delegação.
3. DateTime é delegável, exceto para funções DateTime Now() e Today().
4. CountRows em Dataverse utiliza um valor em cache. Para valores não armazenados em cache em que a contagem de registros é inferior a 50.000 registros, use CountIf(table, True).
5. Para CountRows, certifique-se de que os utilizadores têm as permissões adequadas para obter os totais da tabela.
6. Todas as funções agregadas são limitadas a uma coleção de 50.000 linhas. Se necessário, use a função Filtrar para selecionar 50.000 linhas. Não há suporte para funções agregadas em modos de exibição.
7. A função FirstN não é suportada.
8. O In operador está sujeito ao limite de consulta de 15 tabelas do Dataverse.
9. Suporta comparações. Por exemplo, Filter(TableName, MyCol = Blank()).
10. UpdateIf e RemoveIf funcionam localmente, mas simulam a delegação até um limite de 500 ou 2.000 registros. Eles sucessivamente derrubam recordes além do limite de 500 ou 2.000 recordes de não delegação. Os registros que atendem à condição If são coletados. Geralmente, um máximo de 500 ou 2.000 registros são coletados separadamente e, em seguida, alterados por execução. No entanto, mais registros podem ser atualizados se o cache de dados local existente for grande, pois a função pode acessar mais registros para avaliação.

Chamar ações do Dataverse diretamente no Power Fx

Como parte da linguagem Power Fx, agora você pode invocar diretamente uma ação Dataverse dentro de uma fórmula. São suportadas ações dependentes e independentes. Adicione um objeto de linguagem Power Fx Environment ao seu aplicativo para usar ações do Dataverso.

Você pode trabalhar com campos dinâmicos para entradas e saídas. Para entradas, muitas ações do Dataverse exigem um valor dinâmico como argumento. Passe esses argumentos usando ParseJSON para converter um registro Power Fx em um valor dinâmico. Para saídas, se uma ação retornar valores dinâmicos, basta usar a notação de pontos para acessar as propriedades do objeto. Transmita valores específicos para uso em Power Apps, como em um rótulo.

Antes desse recurso, você costumava usar o Power Automate para chamar o Dataverse diretamente. Chamar Dataverse do Power Fx oferece benefícios significativos de desempenho e é mais fácil de usar, portanto, use essa abordagem para leituras e atualizações transacionais diretas. Se seu aplicativo usa o Power Automate para chamar ações do Dataverso, você verá um banner sugerindo que você use essa abordagem de ação direta.

Trabalhar com campos dinâmicos não se limita ao Dataverse. Esse recurso funciona com todos os tipos de conectores e fornece suporte básico a esquemas dinâmicos ad hoc.

Permitir acesso a ações do Microsoft Dataverse

Para novas aplicações, esta caraterística é ativada automaticamente. Para aplicativos criados anteriormente, habilite o acesso às ações do Dataverso.

Para aplicativos mais antigos, abra seu aplicativo de tela para edição. Vá para Configurações>Próximos recursos>Desativado e habilite as ações do Dataverso.

Adicionar o objeto da linguagem do Ambiente Power Fx à aplicação

Para usar ações do Dataverse em suas fórmulas do Power Fx, selecione Adicionar dados, pesquise Ambiente e adicione-o ao seu aplicativo.

Esta etapa adiciona o objeto de idioma Power Fx Environment ao seu aplicativo.

Ações do Access Dataverse

Depois de adicionar o objeto Power Fx Environment ao seu aplicativo, acesse as ações do Dataverse adicionando Environment à sua fórmula e, em seguida, usando a notação de pontos para as ações.

As ações do Dataverse não acoplado estão no mesmo nível das tabelas e precisam do escopo pai do objeto de linguagem Environment . Todas as ações em seu ambiente estão disponíveis — tanto do sistema quanto personalizadas. Estão disponíveis ações dependentes e independentes. O limite de chamadas de dois níveis é removido.

Para obter mais detalhes sobre como usar ações Dataverse em suas fórmulas, consulte Trabalhando com valores dinâmicos.

Passar argumentos de tipo de entidade para ações vinculadas e não acopladas

Para passar argumentos de tipo de entidade para ações do Dataverso, defina o valor do argumento do tipo de entidade como uma variável. Certifique-se de preencher todos os valores ausentes, como *activityId. Esta etapa é importante para entidades que não têm tipos definidos no swagger.

Set(MyArgVar, {
  name: First(systemUser).name,
  Id: First(systemUser).Id
  ... })

Renomear, atualizar e usar ações em outros ambientes

Para renomear um ambiente, selecione as reticências e, em seguida, selecione "Renomear". Se você adicionar uma nova ação do Dataverse no Dataverse e quiser que o Power Apps a veja, selecione "Atualizar". Para usar uma ação em um ambiente diferente, altere o ambiente e, em seguida, procure por "Ambiente", selecione-o e adicione-o ao seu aplicativo.