Conectar-se ao Microsoft Dataverse

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

Por padrão, o aplicativo se conecta ao ambiente atual para tabelas do Dataverse. Se o aplicativo for movido para outro ambiente, o conector se conectará aos dados no novo ambiente. Esse comportamento funciona bem para um aplicativo que usa um único ambiente ou um aplicativo que segue um processo do ALM (gerenciamento do ciclo de vida) para migrar do desenvolvimento para o teste e depois para a produção.

Ao adicionar dados do Dataverse, você pode alterar o ambiente e selecionar uma ou mais tabelas. Por padrão, o aplicativo se conecta aos dados no ambiente atual.

Se você selecionar Alterar ambiente, poderá especificar um ambiente diferente para extrair dados dele em vez ou além do ambiente atual.

O nome do ambiente selecionado aparece na lista de tabelas.

Visibilidade e acesso

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

Observação

As conexões listadas no painel de detalhes do aplicativo fora do designer do aplicativo mostram conexões que exigem o consentimento do usuário. Como as conexões nativas do Dataverse usadas no aplicativo não exigem esse consentimento adicional, uma conexão nativa não estará nessa lista.

Mapeamento de tipo de dados do Power Apps

O conector do Microsoft Dataverse é mais robusto que o Dynamics 365 Connector e tem paridade de recurso semelhante. A tabela a seguir lista os tipos de dados no Power Apps, e como eles são mapeados para tipos de dados no Dataverse.

Power Apps	Microsoft Dataverse
Opção	Opção, Sim/Não
DateTime	Data Hora, Data e Hora, Somente Data
Imagem	Imagem
Número	Número de Ponto Flutuante, Moeda, Número Decimal, Duração, Idioma, TimeZone, Número Inteiro
Texto	Email, Texto Multilinha, Telefone, Texto, Área de Texto, Símbolo de Ticker, URL
GUID	Identificador Exclusivo

Funções e operações delegáveis do Power Apps para o Dataverse

Essas operações do Power Apps, para um determinado tipo de dados, podem ser delegadas ao Dataverse para processamento (em vez de serem processadas localmente no Power Apps).

Item	Número [1]	Texto[2]	Opção	DateTime [3]	GUID
<, <=, >, >=	Sim	Sim	Não	Sim	-
=, <>	Sim	Sim	Sim	Sim	Sim
And/Or/Not	Sim	Sim	Sim	Sim	Sim
CountRows [4] [5], CountIf [6]	Sim	Sim	Sim	Sim	Sim
Filtro	Sim	Sim	Sim	Sim	Sim
Primeiro [7]	Sim	Sim	Sim	Sim	Sim
Em (associação) (visualização)	Sim	Sim	Sim	Sim	Sim
Em (substring)	-	Sim	-	-	-
IsBlank [8]	Sim	Sim	Não	Sim	Sim
Pesquisar	Sim	Sim	Sim	Sim	Sim
Pesquisa	Não	Sim	Não	Não	-
Classificar	Sim	Sim	Sim	Sim	-
SortByColumns	Sim	Sim	Sim	Sim	-
StartsWith	-	Sim	-	-	-
Sum, Min, Max, Avg [6]	Sim	-	-	Não	-

1. Numérico com expressões aritméticas (por exemplo, Filter(table, field + 10 > 100)) não são delegáveis. Idioma e TimeZone não são delegáveis. Não há suporte para a conversão de uma coluna para um número. Quando um valor aparece como um número no Power Apps mas a fonte de dados de back-end não é um número simples, como moeda, ele não será delegado.
2. Não há suporte a Trim[Ends] ou Len. Também há suporte para outras funções, como Esquerda, Meio, Direita, Superior, Inferior, Substituir, Substituir, etc. Além disso, não há suporte para conversão como Texto (coluna) para delegação.
3. DateTime é delegável, exceto para as funções DateTime Now() e Today().
4. CountRows no Dataverse usa um valor em cache. Para valores não armazenados em cache em que se espera que a contagem de registros seja inferior a 50.000, use CountIf(table, True).
5. Para CountRows, certifique-se de que os usuários tenham as permissões apropriadas para obter os valores totais da tabela.
6. As funções de agregação são limitadas a uma coleção de 50.000 linhas. Se necessário, use a função Filtro para selecionar 50.000. As funções agregadas não são compatíveis com Views.
7. FirstN não é compatível.
8. Oferece suporte a comparações. Por exemplo, Filter(TableName, MyCol = Blank()).

Chamar diretamente ações do Dataverse no Power Fx

Como parte da linguagem Power Fx, os autores já podem invocar diretamente uma ação do Dataverse dentro de uma fórmula. Há suporte a ações vinculadas e desvinculadas. Os autores podem adicionar um objeto de idioma Power Fx Environment para o aplicativo e acessar ações do Dataverse.

Os autores podem trabalhar com campos de objeto sem tipo para entradas e saídas. No lado de entrada, por exemplo, muitas ações do Dataverse exigem um objeto sem tipo como um argumento. Os autores já podem passar esses argumentos usando ParseJSON para converter um registro do Power Fx em um objeto sem tipo. No lado da saída, para ações que retornem objetos sem tipo, basta dot nas propriedades dos objetos retornados. Você deve converter valores específicos para uso em contextos específicos a serem usados no Power Apps, como um rótulo.

Sem esse recurso, era comum os autores usarem o Power Automate para chamar o Dataverse diretamente. No entanto, chamar diretamente o Dataverse do Power Fx proporciona benefícios significativos em termos de desempenho (e facilidade de uso) e deve ser preferido em leituras e atualizações transacionais diretas. Se tiver um aplicativo que usa o Power Automate para chamar ações do Dataverse, você verá um banner sugerindo usar essa abordagem de ação direta.

O trabalho com campos sem tipo não está restrito ao Dataverse. Ele funciona para todos os tipos de conectores e oferece um suporte ao esquema dinâmico ad hoc básico.

Observação

1. Não damos suporte completo a ações DV no Power Fx (algo específico para qualquer chamada de ação com parâmetros).
2. Não damos suporte à referência direta de entidade e coleções de entidades na tela.
3. Para parâmetros do tipo objeto aninhados (2 ou mais níveis de profundidade), os atributos de segundo nível são tratados obrigatoriamente no PowerApps.

Permitir acesso a ações do Microsoft Dataverse

Para aplicativos novos, esse recurso é habilitado automaticamente. Para aplicativos criados anteriormente, você deverá habilitar o acesso a ações do Dataverse.

Para aplicativos anteriores, abra o aplicativo de tela para edição e navegue até Configurações > Próximos recursos > Aposentado e habilitar ações do Dataverse.

Adicionar o objeto de linguagem Power Fx Environment ao aplicativo

Para usar ações do Dataverse nas fórmulas do Power Fx, selecione Adicionar dados, procure Ambiente e o adicione ao aplicativo.

Isso adiciona o objeto de linguagem Power Fx Environment ao aplicativo.

Acessando ações do Dataverse

Quando o objeto Power Fx Environment é adicionado ao aplicativo, você pode acessar ações do Dataverse adicionando Environment à fórmula e colocando pontos nas ações.

As ações do Dataverse desvinculadas estão no mesmo nível das tabelas e precisam do escopo pai do objeto de linguagem Ambiente. Todas as ações no ambiente estão disponíveis – no nível do sistema e personalizadas. Ações vinculadas e desvinculadas estão disponíveis. O limite de chamada de nível 2 foi removido.

Para obter mais detalhes sobre como usar ações do Dataverse nas fórmulas, consulte Trabalhando com objetos sem tipo e dinâmicos.

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).

Renomear, atualizar e ações em outros ambientes

Você pode renomear um ambiente escolhendo as reticências e selecionando "Renomear". Se adicionar uma nova ação do Dataverse no Dataverse e precisar do Power Apps para vê-la, você poderá escolher "Atualizar". E, se precisar usar uma ação em um ambiente diferente, você precisará primeiramente alterar o ambiente e, lá, procurar "Ambiente", selecionar e adicioná-lo ao aplicativo.