Compartilhar via

Microsoft Dataverse [OBSOLETO]

Fornece acesso ao banco de dados do ambiente em Microsoft Dataverse.

Este conector está disponível nos seguintes produtos e regiões:

Service Classe Regiões
Copilot Studio Premium Todas as regiões Power Automate
Aplicativos lógicos Standard Todas as regiões do Logic Apps
Power Apps - Não disponível
Power Automate Premium Todas as regiões Power Automate
Contact
Name Microsoft
URL Suporte Microsoft LogicApps
Microsoft Power Automate Apoiar
Metadados do conector
Editor Microsoft
Site da Web https://powerapps.microsoft.com/common-data-service/

Observação

Microsoft Dataverse O conector (legado) terá suporte da Microsoft até que o conector ofereça suporte ao Logic Apps. Microsoft Dataverse

Para usar este conector em Power Apps, saiba mais sobre como usar este conector em Power Apps..

Limitações e problemas conhecidos

  1. Há ocorrências em que os gatilhos do CDS não funcionam no ambiente de produção com o Modo Administrativo definido como "ativado". Se você tiver esse problema, uma solução alternativa seria desativar o Modo de administrador no Centro de administração do Power Platforms.
  2. Se o modo de administração estiver habilitado para o ambiente usado (sandbox ou produção), o fluxo com o gatilho Power Automate Quando um registro é modificado não será disparado quando um registro for modificado. Para mais detalhes sobre como definir o modo de administração, consulte esta página.
  3. Ao usar o gatilho "Quando um registro é selecionado" em um fluxo e ter uma etapa de condição If logo depois, você receberá um erro se o atributo na condição tiver um valor nulo. A mensagem de erro que você verá é "Tipo inválido. String esperada, mas retornou Null.". A solução alternativa sugerida é inserir uma ação "Obter linha" entre "Quando o registro for selecionado" e a etapa Se condição. Ao usar a saída da ação "Obter Linha" em sua condição, você poderá evitar esse erro.

Mapeamento de tipo de dados do Power Apps

Power Apps Microsoft Dataverse (legado)
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 Data e hora [3] GUID
Filtrar Sim Sim Sim Sim Sim
Classificar Sim Sim Não Sim -
SortByColumns Sim Sim Não Sim -
Pesquisar Sim Sim Sim Sim Sim
=, <> Sim Sim Sim Sim Sim
<, <=, >, >= Sim Sim Não Sim -
And/Or/Not Sim Sim Sim Sim Sim
StartsWith - Sim - - -
IsBlank Sim [4] Sim [4] Não [4] Sim [4] Sim
Sum, Min, Max, Avg Sim [5] - - Não -
  1. Numéricos 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.
  2. Não há suporte a Trim[Ends] ou Len. Oferece suporte a outras funções como Left, Mid, Right, Upper, Lower, Replace, Substitute etc.
  3. DateTime é geralmente delegável, exceto para as funções DateTime Now() e Today().
  4. Oferece suporte a comparações. Por exemplo, Filter(TableName, MyCol = Blank()).
  5. As funções de agregação são limitadas a uma coleção de 50.000 linhas. Se necessário, use a função Filter para selecionar 50.000 linhas de um conjunto maior antes de usar a função de agregação.

Observação

As funções Choices, Guids e Aggregate para Dataverse são compatíveis apenas com a nova versão do conector. Dependendo da versão do Power Apps que você está usando, habilite este conector com a opção Visualização intitulada:

  • Dados relacionais, escolhas e outros novos recursos para Dataverse
    ou esta opção Experimental:
  • Use o conector Dataverse
    Para encontrar essas opções, abra o menu Arquivo e selecione Configurações do aplicativo>Configurações avançadas.

Conector em profundidade

Para obter mais informações sobre o conector, consulte a seção detalhada.

Criando uma conexão

O conector suporta os seguintes tipos de autenticação:
Autenticação de Certificado do Cliente Fornecer credenciais de ID do Microsoft Entra usando certificado PFX e senha Todas as regiões Compartilhável
Oauth Oauth Todas as regiões Compartilhável
Entidade de Serviço Fornecer credenciais de ID do Microsoft Entra usando a ID do Cliente e o Segredo Todas as regiões Compartilhável
Padrão [PRETERIDO] Essa opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores. Todas as regiões Não compartilhável

Autenticação de Certificado do Cliente

ID de autenticação: CertOauth

Aplicável: Todas as regiões

Fornecer credenciais de ID do Microsoft Entra usando certificado PFX e senha

Essa é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a visão geral dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs

Name Tipo Description Obrigatório
Inquilino cadeia Verdade
ID do cliente cadeia A ID do cliente do aplicativo Microsoft Entra ID Verdade
Segredo do certificado do cliente clientCertificate O segredo do certificado do cliente permitido por este aplicativo Verdade

Oauth

ID de autenticação: Oauth

Aplicável: Todas as regiões

Oauth

Essa é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a visão geral dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs

Principal de Serviço

ID de autenticação: ServicePrincipalOauth

Aplicável: Todas as regiões

Fornecer credenciais de ID do Microsoft Entra usando a ID do Cliente e o Segredo

Essa é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a visão geral dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs

Name Tipo Description Obrigatório
ID do cliente cadeia ID do cliente (ou aplicativo) do aplicativo Microsoft Entra ID. Verdade
Segredo de Cliente secureString Segredo do cliente do aplicativo ID do Microsoft Entra. Verdade
Inquilino cadeia A ID do locatário do aplicativo Microsoft Entra ID. Verdade

Padrão [PRETERIDO]

Aplicável: Todas as regiões

Essa opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.

Esta não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limitações

Nome Chamadas Período de renovação
Chamadas de API por conexão 1000 60 segundos

Ações

Adicionar uma nova linha (herdado) [OBSOLETO]

Esta operação adiciona uma nova linha de uma tabela
Adicionar uma nova linha [OBSOLETO]

Esta operação adiciona uma nova linha de uma tabela
Atualizar uma linha (legado) [OBSOLETO]

Esta operação atualiza uma linha existente para uma tabela
Atualizar uma linha [OBSOLETO]

Esta operação atualiza uma linha existente para uma tabela
Excluir uma linha (legado) [OBSOLETO]

Esta operação exclui uma linha de uma coleção de tabelas
Linhas de lista (legado) [OBSOLETO]

Esta operação obtém linhas para uma tabela
Linhas de lista [OBSOLETO]

Esta operação obtém linhas para uma tabela
Obter linha (legado) [OBSOLETO]

Esta operação recupera a linha especificada para uma tabela
Obtém uma linha da tabela [OBSOLETO]

Obtém uma linha da tabela

Adicionar uma nova linha (herdado) [OBSOLETO]

ID da operação:
PostItem_V2

Esta operação adiciona uma nova linha de uma tabela

Parâmetros

Nome Chave Obrigatório Tipo Description
Environment
 dataset True string

Selecionar um Ambiente
Nome da Tabela
 table True string

Selecionar uma tabela
Item de Linha
 item True dynamic

Linha a ser criada

Retornos

As saídas desta operação são dinâmicas.

Adicionar uma nova linha [OBSOLETO]

ID da operação:
PostItem

Esta operação adiciona uma nova linha de uma tabela

Parâmetros

Nome Chave Obrigatório Tipo Description
Environment
 dataset True string

Selecionar um Ambiente
Nome da Tabela
 table True string

Selecionar uma tabela
Item de Linha
 item True dynamic

Linha a ser criada

Retornos

As saídas desta operação são dinâmicas.

Atualizar uma linha (legado) [OBSOLETO]

ID da operação:
PatchItem_V2

Esta operação atualiza uma linha existente para uma tabela

Parâmetros

Nome Chave Obrigatório Tipo Description
Environment
 dataset True string

Selecionar um Ambiente
Nome da Tabela
 table True string

Selecionar uma tabela
Identificador da linha
 id True string

Identificador da linha
Item de Linha
 item True dynamic

Linha a ser atualizada

Retornos

As saídas desta operação são dinâmicas.

Atualizar uma linha [OBSOLETO]

ID da operação:
PatchItem

Esta operação atualiza uma linha existente para uma tabela

Parâmetros

Nome Chave Obrigatório Tipo Description
Environment
 dataset True string

Selecionar um Ambiente
Nome da Tabela
 table True string

Selecionar uma tabela
Identificador da linha
 id True string

Identificador da linha
Item de Linha
 item True dynamic

Linha a ser atualizada

Retornos

As saídas desta operação são dinâmicas.

Excluir uma linha (legado) [OBSOLETO]

ID da operação:
DeleteItem

Esta operação exclui uma linha de uma coleção de tabelas

Parâmetros

Nome Chave Obrigatório Tipo Description
Environment
 dataset True string

Selecionar um Ambiente
Nome da Tabela
 table True string

Selecionar uma tabela
Identificador do item
 id True string

Identificador da linha

Linhas de lista (legado) [OBSOLETO]

ID da operação:
GetItems_V2

Esta operação obtém linhas para uma tabela

Parâmetros

Nome Chave Obrigatório Tipo Description
Environment
 dataset True string

Selecionar um Ambiente
Nome da Tabela
 table True string

Selecionar uma tabela
Transformação de agregação
 $apply string

Uma sequência de transformações de agregação do OData
Filtrar Consulta
 $filter string

Uma consulta de filtro ODATA para restringir as entradas foi retornada (por exemplo: stringColumn eq 'string' OU numberColumn lt 123).
Ordenar Por
 $orderby string

Uma consulta orderBy ODATA para especificar a ordem das entradas.
Contagem Principal
 $top integer

Número total de entradas a serem recuperadas (padrão = todas).
Expandir Consulta
 $expand string

Entradas relacionadas a serem incluídas nas entradas solicitadas (padrão = nenhuma)

Retornos

As saídas desta operação são dinâmicas.

Linhas de lista [OBSOLETO]

ID da operação:
GetItems

Esta operação obtém linhas para uma tabela

Parâmetros

Nome Chave Obrigatório Tipo Description
Environment
 dataset True string

Selecionar um Ambiente
Nome da Tabela
 table True string

Selecionar uma tabela
Filtrar Consulta
 $filter string

Uma consulta de filtro ODATA para restringir as entradas foi retornada (por exemplo: stringColumn eq 'string' OU numberColumn lt 123).
Ordenar Por
 $orderby string

Uma consulta orderBy ODATA para especificar a ordem das entradas.
Contagem Principal
 $top integer

Número total de entradas a serem recuperadas (padrão = todas).
Expandir Consulta
 $expand string

Entradas relacionadas a serem incluídas nas entradas solicitadas (padrão = nenhuma)

Retornos

As saídas desta operação são dinâmicas.

Obter linha (legado) [OBSOLETO]

ID da operação:
GetItem_V2

Esta operação recupera a linha especificada para uma tabela

Parâmetros

Nome Chave Obrigatório Tipo Description
Environment
 dataset True string

Selecionar um Ambiente
Nome da Tabela
 table True string

Selecionar uma tabela
Identificador do item
 id True string

Identificador da linha

Retornos

As saídas desta operação são dinâmicas.

Obtém uma linha da tabela [OBSOLETO]

ID da operação:
GetItem

Obtém uma linha da tabela

Parâmetros

Nome Chave Obrigatório Tipo Description
Environment
 dataset True string

Selecionar um Ambiente
Nome da Tabela
 table True string

Selecionar uma tabela
Identificador do item
 id True string

Identificador da linha

Retornos

As saídas desta operação são dinâmicas.

Gatilhos

Quando uma linha é adicionada (somente administrador) [OBSOLETO]

Aciona um fluxo quando uma linha é adicionada em Dataverse
Quando uma linha é adicionada (somente administrador) [OBSOLETO]

Aciona um fluxo quando uma linha é adicionada em Dataverse
Quando uma linha é adicionada [OBSOLETO]

Aciona um fluxo quando uma linha é adicionada em Dataverse.
Quando uma linha é excluída (somente administrador) [OBSOLETO]

Aciona um fluxo quando uma linha é excluída em Dataverse
Quando uma linha é excluída [OBSOLETO]

Aciona um fluxo quando uma linha é excluída em Dataverse.
Quando uma linha é modificada (somente administrador) [OBSOLETO]

Aciona um fluxo quando uma linha é modificada em Dataverse
Quando uma linha é modificada (somente administrador) [OBSOLETO]

Aciona um fluxo quando uma linha é modificada em Dataverse
Quando uma linha é modificada [OBSOLETO]

Aciona um fluxo quando uma linha é modificada em Dataverse.
Quando uma linha é selecionada

Dispare um fluxo quando uma linha for selecionada no menu Fluxo na barra de comandos. (Disponível apenas para Power Automate.)

Quando uma linha é adicionada (somente administrador) [OBSOLETO]

ID da operação:
GetOnNewItems

Aciona um fluxo quando uma linha é adicionada em Dataverse

Parâmetros

Nome Chave Obrigatório Tipo Description
Environment
 dataset True string

Selecionar um Ambiente
Nome da Tabela
 table True string

Selecionar uma tabela

Retornos

As saídas desta operação são dinâmicas.

Quando uma linha é adicionada (somente administrador) [OBSOLETO]

ID da operação:
GetOnNewItems_V2

Aciona um fluxo quando uma linha é adicionada em Dataverse

Parâmetros

Nome Chave Obrigatório Tipo Description
Environment
 dataset True string

Selecionar um Ambiente
Nome da Tabela
 table True string

Selecionar uma tabela

Retornos

As saídas desta operação são dinâmicas.

Quando uma linha é adicionada [OBSOLETO]

ID da operação:
SubscribeOnNewItems

Aciona um fluxo quando uma linha é adicionada em Dataverse.

Parâmetros

Nome Chave Obrigatório Tipo Description
Environment
 dataset True string

Selecione um Ambiente.
Nome da Tabela
 table True string

Selecione uma tabela.
Scope
 scope True string

Escopo.

Retornos

As saídas desta operação são dinâmicas.

Quando uma linha é excluída (somente administrador) [OBSOLETO]

ID da operação:
GetOnDeletedItems

Aciona um fluxo quando uma linha é excluída em Dataverse

Parâmetros

Nome Chave Obrigatório Tipo Description
Environment
 dataset True string

Selecionar um Ambiente
Nome da Tabela
 table True string

Selecionar uma tabela

Retornos

As saídas desta operação são dinâmicas.

Quando uma linha é excluída [OBSOLETO]

ID da operação:
SubscribeOnDeletedItems

Aciona um fluxo quando uma linha é excluída em Dataverse.

Parâmetros

Nome Chave Obrigatório Tipo Description
Environment
 dataset True string

Selecione um Ambiente.
Nome da Tabela
 table True string

Selecione uma tabela.
Scope
 scope True string

Escopo.

Retornos

As saídas desta operação são dinâmicas.

Quando uma linha é modificada (somente administrador) [OBSOLETO]

ID da operação:
GetOnUpdatedItems_V2

Aciona um fluxo quando uma linha é modificada em Dataverse

Parâmetros

Nome Chave Obrigatório Tipo Description
Environment
 dataset True string

Selecionar um Ambiente
Nome da Tabela
 table True string

Selecionar uma tabela

Retornos

As saídas desta operação são dinâmicas.

Quando uma linha é modificada (somente administrador) [OBSOLETO]

ID da operação:
GetOnUpdatedItems

Aciona um fluxo quando uma linha é modificada em Dataverse

Parâmetros

Nome Chave Obrigatório Tipo Description
Environment
 dataset True string

Selecionar um Ambiente
Nome da Tabela
 table True string

Selecionar uma tabela

Retornos

As saídas desta operação são dinâmicas.

Quando uma linha é modificada [OBSOLETO]

ID da operação:
SubscribeOnUpdatedItems

Aciona um fluxo quando uma linha é modificada em Dataverse.

Parâmetros

Nome Chave Obrigatório Tipo Description
Environment
 dataset True string

Selecione um Ambiente.
Nome da Tabela
 table True string

Selecione uma tabela.
Scope
 scope True string

Escopo.
Filtros de Coluna
 AttributeFilters array of string

Filtros de coluna

Retornos

As saídas desta operação são dinâmicas.

Quando uma linha é selecionada

ID da operação:
OnItemSelected

Dispare um fluxo quando uma linha for selecionada no menu Fluxo na barra de comandos. (Disponível apenas para Power Automate.)

Parâmetros

Nome Chave Obrigatório Tipo Description
operationId
 operationId True string
hospedar
 host object
parâmetros
 parameters True object
esquema
 schema True object
cabeçalhosEsquema
 headersSchema object

Retornos

Nome Caminho Tipo Description
linhas
 body.rows array of object
itens
 body.rows object
ID do usuário
 headers.x-ms-user-id-encoded guid

O identificador exclusivo do usuário que disparou o fluxo no AAD.
Email do usuário
 headers.x-ms-user-email-encoded byte

O endereço de email do usuário que disparou o fluxo.
Nome de usuário
 headers.x-ms-user-name-encoded byte

O nome de exibição do usuário que disparou o fluxo.
Carimbo de data/hora
 headers.x-ms-user-timestamp string

A hora em que o fluxo foi disparado.