Microsoft Dataverse
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
- 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.
- 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.
- 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 | - |
- 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.
- Não há suporte a Trim[Ends] ou Len. Oferece suporte a outras funções como Left, Mid, Right, Upper, Lower, Replace, Substitute etc.
- DateTime é geralmente delegável, exceto para as funções DateTime Now() e Today().
- Oferece suporte a comparações. Por exemplo, Filter(TableName, MyCol = Blank()).
- 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 |
Essa ação permite que você adicione uma nova linha na tabela Microsoft Dataverse selecionada. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365. |
| 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 |
Essa ação permite que você modifique qualquer linha selecionada em uma tabela Microsoft Dataverse ou adicione uma nova linha se ela não existir. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365. |
| 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 |
| Baixar um arquivo ou uma imagem |
Essa ação permite que você baixe um arquivo ou um conteúdo de imagem de uma tabela Microsoft Dataverse. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365. |
| Carregar um arquivo ou uma imagem |
Essa ação permite que você carregue um arquivo ou um conteúdo de imagem em uma tabela Microsoft Dataverse com um tipo de coluna compatível. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365. |
| Excluir uma linha |
Essa ação permite que você exclua uma linha de uma tabela Microsoft Dataverse. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365. |
| Excluir uma linha (legado) [OBSOLETO] |
Esta operação exclui uma linha de uma coleção de tabelas |
| Executar uma ação associada |
Essa ação permite que você execute Microsoft Dataverse ações associadas a uma tabela selecionada. |
| Executar uma ação não associada |
Essa ação permite que você execute Microsoft Dataverse ações disponíveis no ambiente que não estão associadas a nenhuma tabela. |
| Executar uma solicitação changeset |
Essa ação permite que você execute um grupo de operações de conector Microsoft Dataverse como uma única transação. Se uma das operações falhar, todas as ações bem-sucedidas serão revertidas. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365. |
| 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 |
| Linhas não relacionadas |
Essa ação permite que você remova o vínculo entre uma linha em uma Microsoft Dataverse tabela para outra se as tabelas tiverem uma relação um para muitos ou muitos para muitos. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365. |
| Listar linhas |
Essa ação permite que você liste as linhas em uma tabela Microsoft Dataverse que corresponda às opções selecionadas. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365. |
| Obter linha (legado) [OBSOLETO] |
Esta operação recupera a linha especificada para uma tabela |
| Obter uma linha por ID |
Essa ação permite que você obtenha a linha que corresponde a uma ID em uma tabela de Microsoft Dataverse. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365. |
| Obtém uma linha da tabela [OBSOLETO] |
Obtém uma linha da tabela |
| Pesquisar linhas |
Essa ação permite que você pesquise um ambiente de Microsoft Dataverse usando a Pesquisa de Relevância e retorna as linhas que correspondem mais de perto ao termo de pesquisa. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365. |
| Relacionar linhas |
Essa ação permite vincular uma linha em uma Microsoft Dataverse tabela a outra se as tabelas tiverem uma relação um para muitos ou muitos para muitos. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365. |
Adicionar uma nova linha
Essa ação permite que você adicione uma nova linha na tabela Microsoft Dataverse selecionada. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Environment
|
organization | True | string |
Selecionar um Ambiente |
|
Nome da tabela
|
entityName | True | string |
Escolha uma tabela |
|
Item de Linha
|
item | True | dynamic |
Linha a ser criada |
Retornos
Adicionar uma nova linha (herdado) [OBSOLETO]
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
Adicionar uma nova linha [OBSOLETO]
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
Atualizar uma linha
Essa ação permite que você modifique qualquer linha selecionada em uma tabela Microsoft Dataverse ou adicione uma nova linha se ela não existir. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL da Organização
|
organization | True | string |
URL da organização |
|
Nome da tabela
|
entityName | True | string |
Escolha uma tabela |
|
ID de linha
|
recordId | True | string |
Inserir o GUID (identificador global exclusivo) da linha |
|
Item de Linha
|
item | True | dynamic |
Linha a ser atualizada |
Retornos
Atualizar uma linha (legado) [OBSOLETO]
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
Atualizar uma linha [OBSOLETO]
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
Baixar um arquivo ou uma imagem
Essa ação permite que você baixe um arquivo ou um conteúdo de imagem de uma tabela Microsoft Dataverse. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Environment
|
organization | True | string |
Selecionar um Ambiente |
|
Nome da tabela
|
entityName | True | string |
Escolha uma tabela |
|
ID de linha
|
recordId | True | string |
Inserir o GUID (identificador global exclusivo) da linha |
|
Nome da Coluna
|
fileImageFieldName | True | string |
Escolher uma coluna |
|
Tamanho da imagem
|
size | string |
Inserir "completa" para a imagem inteira, se habilitada (padrão = miniatura) |
Retornos
O conteúdo do arquivo ou da imagem
- Conteúdo do arquivo ou da imagem
- binary
Carregar um arquivo ou uma imagem
Essa ação permite que você carregue um arquivo ou um conteúdo de imagem em uma tabela Microsoft Dataverse com um tipo de coluna compatível. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Environment
|
organization | True | string |
Selecionar um Ambiente |
|
Nome da tabela
|
entityName | True | string |
Escolha uma tabela |
|
ID de linha
|
recordId | True | string |
Inserir o GUID (identificador global exclusivo) da linha |
|
Nome da Coluna
|
fileImageFieldName | True | string |
Escolher uma coluna |
|
Conteúdo
|
item | True | binary |
Adicionar conteúdo do arquivo ou imagem |
|
Nome do conteúdo
|
x-ms-file-name | True | string |
Inserir um nome para o arquivo ou a imagem |
Excluir uma linha
Essa ação permite que você exclua uma linha de uma tabela Microsoft Dataverse. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL da Organização
|
organization | True | string |
URL da organização |
|
Nome da tabela
|
entityName | True | string |
Escolha uma tabela |
|
ID de linha
|
recordId | True | string |
Inserir o GUID (identificador global exclusivo) da linha |
|
ID da Partição
|
partitionId | string |
Uma opção para especificar a partitionId ao excluir a linha para tabelas NoSQL |
Excluir uma linha (legado) [OBSOLETO]
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 |
Executar uma ação associada
Essa ação permite que você execute Microsoft Dataverse ações associadas a uma tabela selecionada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Environment
|
organization | True | string |
Selecionar um Ambiente |
|
Nome da tabela
|
entityName | True | string |
Escolha uma tabela |
|
Nome da ação
|
actionName | True | string |
Escolha uma ação |
|
ID de linha
|
recordId | True | string |
Inserir o GUID (identificador global exclusivo) da linha |
|
Parâmetros da ação
|
item | dynamic |
Parâmetros da ação |
Retornos
Executar uma ação não associada
Essa ação permite que você execute Microsoft Dataverse ações disponíveis no ambiente que não estão associadas a nenhuma tabela.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Environment
|
organization | True | string |
Selecionar um Ambiente |
|
Nome da ação
|
actionName | True | string |
Escolha uma ação |
|
Parâmetros da ação
|
item | dynamic |
Parâmetros da ação |
Retornos
Executar uma solicitação changeset
Essa ação permite que você execute um grupo de operações de conector Microsoft Dataverse como uma única transação. Se uma das operações falhar, todas as ações bem-sucedidas serão revertidas. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365.
Linhas de lista (legado) [OBSOLETO]
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
Linhas de lista [OBSOLETO]
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
Linhas não relacionadas
Essa ação permite que você remova o vínculo entre uma linha em uma Microsoft Dataverse tabela para outra se as tabelas tiverem uma relação um para muitos ou muitos para muitos. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Environment
|
organization | True | string |
Selecionar um Ambiente |
|
Nome da tabela
|
entityName | True | string |
Escolha uma tabela |
|
ID de linha
|
recordId | True | string |
Inserir o GUID (identificador global exclusivo) da linha |
|
Relação
|
associationEntityRelationship | True | string |
Escolha o tipo de relacionamento |
|
Não relacionado a
|
$id | True | string |
Insira a URL da linha usando o ID do OData de uma etapa anterior ou digitando a URL completa (por exemplo, https://org0.crm.dynamics.com/api/data/v9.0/faxes(3ce6c728-3c8a-4b55-a4ee-a251b253c3ee) |
Listar linhas
Essa ação permite que você liste as linhas em uma tabela Microsoft Dataverse que corresponda às opções selecionadas. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Environment
|
organization | True | string |
Selecionar um Ambiente |
|
Nome da tabela
|
entityName | True | string |
Escolha uma tabela |
|
Selecionar colunas
|
$select | string |
Inserir uma lista separada por vírgula de nomes exclusivos de coluna para limitar as colunas listadas |
|
|
Filtrar linhas
|
$filter | string |
Inserir uma expressão de filtro estilo OData para limitar as linhas que são listadas |
|
|
Classificar Por
|
$orderby | string |
Colunas a classificar no estilo orderBy de OData (exceto pesquisas) |
|
|
Expandir Consulta
|
$expand | string |
Inserir uma consulta de expansão estilo OData para listar as linhas relacionadas |
|
|
Buscar Consulta XML
|
fetchXml | string |
Inserir uma consulta Fetch XML para personalização avançada |
|
|
Contagem de linhas
|
$top | integer |
Inserir o número de linhas a serem listadas (padrão = 5000) |
|
|
Ignorar token
|
$skiptoken | string |
Insira o token de omissão obtido de uma execução anterior para listar linhas da próxima página |
|
|
ID da partição
|
partitionId | string |
Uma opção para especificar a partitionId ao recuperar dados para tabelas de NoSQL |
Retornos
Obter linha (legado) [OBSOLETO]
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
Obter uma linha por ID
Essa ação permite que você obtenha a linha que corresponde a uma ID em uma tabela de Microsoft Dataverse. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL da Organização
|
organization | True | string |
URL da organização |
|
Nome da tabela
|
entityName | True | string |
Escolha uma tabela |
|
ID de linha
|
recordId | True | string |
Inserir o GUID (identificador global exclusivo) da linha |
|
Selecionar colunas
|
$select | string |
Inserir uma lista separada por vírgula de nomes exclusivos de coluna para limitar as colunas listadas |
|
|
Expandir Consulta
|
$expand | string |
Inserir uma consulta de expansão estilo OData para listar as linhas relacionadas |
|
|
ID da Partição
|
partitionId | string |
Uma opção para especificar a partitionId ao recuperar dados para tabelas de NoSQL |
Retornos
Obtém uma linha da tabela [OBSOLETO]
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
Pesquisar linhas
Essa ação permite que você pesquise um ambiente de Microsoft Dataverse usando a Pesquisa de Relevância e retorna as linhas que correspondem mais de perto ao termo de pesquisa. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL da Organização
|
organization | True | string |
URL da organização |
|
Termo de pesquisa
|
search | True | string |
Insira um termo de pesquisa, por exemplo. Contoso. Modificadores de pesquisa como operadores booleanos, curingas, pesquisa difusa, pesquisa de proximidade etc. requerem o tipo de pesquisa completo |
|
Tipo de pesquisa
|
searchtype | string |
Insira se a sintaxe de pesquisa simples ou completa deve ser usada (o padrão é simples) |
|
|
Modo de pesquisa
|
searchmode | string |
Insira se algum ou todos os termos de pesquisa devem ser correspondidos (o padrão é qualquer um) |
|
|
Contagem de linhas
|
top | integer |
Insira o número de resultados de pesquisa a serem listados (padrão = 50) |
|
|
Filtro de linhas
|
filter | string |
Insira uma expressão de filtro de estilo Odata para restringir a pesquisa |
|
|
Filtro de tabela
|
entities | array of string |
Insira uma lista separada por vírgulas de tabelas a serem pesquisadas (o padrão é todas as tabelas) |
|
|
Classificar por
|
orderby | array of string |
Insira uma lista separada por vírgulas de nomes exclusivos de colunas seguidos por asc ou desc |
|
|
Consulta de faceta
|
facets | array of string |
Insira uma lista separada por vírgulas de consultas de facetas para restringir a pesquisa |
|
|
Pular linhas
|
skip | integer |
Insira o número de resultados de pesquisa a serem ignorados |
|
|
Retornar contagem de linhas
|
returntotalrecordcount | boolean |
Escolher uma opção |
Retornos
A saída da pesquisa.
- Body
- SearchOutput
Relacionar linhas
Essa ação permite vincular uma linha em uma Microsoft Dataverse tabela a outra se as tabelas tiverem uma relação um para muitos ou muitos para muitos. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Environment
|
organization | True | string |
Selecionar um Ambiente |
|
Nome da tabela
|
entityName | True | string |
Escolha uma tabela |
|
ID de linha
|
recordId | True | string |
Inserir o GUID (identificador global exclusivo) da linha |
|
Relação
|
associationEntityRelationship | True | string |
Escolha o tipo de relacionamento |
|
Relacionado a
|
@odata.id | True | string |
Insira a URL da linha usando o ID do OData de uma etapa anterior ou digitando a URL completa (por exemplo, https://org0.crm.dynamics.com/api/data/v9.0/faxes(3ce6c728-3c8a-4b55-a4ee-a251b253c3ee) |
Gatilhos
| Quando uma ação é executada |
Dispara quando uma ação de Microsoft Dataverse é concluída. |
| Quando uma linha é adicionada, modificada ou excluída |
Esse gatilho permite que você inicie um fluxo quando uma linha é adicionada, modificada ou excluída em uma tabela Microsoft Dataverse, de modo que corresponda às opções selecionadas. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365. |
| 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 ação é executada
Dispara quando uma ação de Microsoft Dataverse é concluída.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Environment
|
organization | True | string |
Selecionar um Ambiente |
|
Catalog
|
catalog | True | string |
Escolha uma opção para filtrar tabelas e ações. |
|
Categoria
|
category | True | string |
Escolha uma opção para filtrar tabelas e ações. |
|
Nome da tabela
|
entityname | True | string |
Escolha uma tabela para filtrar ações. |
|
Nome da ação
|
sdkmessagename | True | string |
Escolha uma ação. |
Retornos
Quando uma linha é adicionada, modificada ou excluída
Esse gatilho permite que você inicie um fluxo quando uma linha é adicionada, modificada ou excluída em uma tabela Microsoft Dataverse, de modo que corresponda às opções selecionadas. Esse conector era conhecido anteriormente como Common Data Service (herdado) e substitui o conector Dynamics 365.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Environment
|
organization | True | string |
Selecionar um Ambiente |
|
Nome da tabela
|
entityname | True | string |
Escolha uma tabela |
|
Tipo de mudança
|
message | True | integer |
Escolha quando o fluxo dispara |
|
Scope
|
scope | True | integer |
Escolha um escopo para limitar quais linhas podem disparar o fluxo |
|
Selecionar colunas
|
filteringattributes | string |
Insira uma lista separada por vírgulas de nomes exclusivos de colunas. O fluxo é acionado se algum deles for modificado |
|
|
Filtrar linhas
|
filterexpression | string |
Insira uma expressão de filtro de estilo OData para determinar quais linhas podem disparar o fluxo |
|
|
Adiar até
|
postponeuntil | string |
Insira um horário para adiar a avaliação do gatilho, por exemplo, 2020-01-01T10:10:00Z |
|
|
Executar como
|
runas | integer |
Escolha o usuário para a execução das etapas em que as conexões do invocador são usadas |
Retornos
Quando uma linha é adicionada (somente administrador) [OBSOLETO]
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
Quando uma linha é adicionada (somente administrador) [OBSOLETO]
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
Quando uma linha é adicionada [OBSOLETO]
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
Quando uma linha é excluída (somente administrador) [OBSOLETO]
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
Quando uma linha é excluída [OBSOLETO]
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
Quando uma linha é modificada (somente administrador) [OBSOLETO]
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
Quando uma linha é modificada (somente administrador) [OBSOLETO]
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
Quando uma linha é modificada [OBSOLETO]
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
Definições
Saída de pesquisa
A saída da pesquisa.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Lista de linhas
|
value | array of object |
Lista de linhas |
|
Pontuação de pesquisa de linha
|
value.@search.score | number |
Pesquisar pontuação da linha |
|
Nome da tabela de linha
|
value.@search.entityname | string |
Tabela que contém a linha |
|
ID de objeto de linha
|
value.@search.objectid | string |
Objectid da linha |
|
Código de tipo de objeto de linha
|
value.@search.objecttypecode | integer |
Código do tipo de objeto da linha |
|
Contagem total de linhas
|
totalrecordcount | integer |
Contagem total de resultados (-1 se returntotalrecordcount for definido como falso) |
binário
Esse é o tipo de dados básico 'binary'.