Configuração, requisitos e melhores práticas do Fornecedor de dados OData v4

Artigo
03/15/2023

Este tópico descreve como configurar o Fornecedor de Dados OData v4, bem como os requisitos e as melhores práticas recomendadas para utilizar o fornecedor de dados OData v4 para estabelecer ligação a um serviço Web OData v4.

Melhores práticas do fornecedor de dados OData v4

O Microsoft Dataverse necessita que todas as tabelas tenham um atributo de ID. Este ID é conhecido como um identificador exclusivo e o valor tem de ser um guid. Só pode mapear as colunas de ID para colunas externas com o tipo de dados Edm.Guid. Não é possível mapear um tipo de dados Edm.Int32 com uma coluna de tipo de dados Identificador Exclusivo no Dataverse.
As tabelas OData com propriedades anuláveis têm de ser definidas para corresponderem à coluna mapeada na tabela virtual. Por exemplo, uma propriedade da tabela OData com Nullable=False tem de ter uma coluna mapeada no atributo Requisito de Campo no Dataverse definida como Negócio Necessário.
Para obter várias consultas, como quando carrega os dados para uma grelha, controla o tamanho do conjunto de dados devolvido pela origem de dados externa ao utilizar os parâmetros de consulta do filtro e seleção.
Se ainda não estiver ativado, os administradores de sistema devem ativar o rastreamento de plug-ins. Depois de ativado, todos os erros do ponto final OData são capturados no registo de rastreio de plug-ins. Mais informações: Guia de Administrador: caixa de diálogo Definições de Sistema - separador Personalização.
Não é possível utilizar o Fornecedor de Dados OData v4 para se ligar a outro ambiente.

Mapeamento de tipos de dados

A tabela seguinte lista os mapeamentos de tipos de dados Modelo de Dados (EDM) de tabela OData com os tipos de dados do Dataverse.

Tipo de Dados OData	Tipo de Dados Dataverse
`Edm.Boolean`	Duas Opções
`Edm.DateTime`	Data e Hora
`Edm.DateTimeOffset`	Data e Hora
`Edm.Decimal`	Número Decimal ou Moeda
`Edm.Double`	Número de Vírgula Flutuante
`Edm.Guid`	Identificador Exclusivo
`Edm.Int32`	Número Inteiro
`Edm.Int64`	Número Inteiro
`Edm.String`	Uma Linha de Texto ou Várias Linhas de Texto

Tipos de dados OData EDM não suportados para mapeamento com tabelas virtuais

Edm.Binary
Edm.Time
Edm.Float
Edm.Single
Edm.Int16
Edm.Byte
Edm.SByte

Adicionar uma origem de dados utilizando o Fornecedor de Dados OData v4

Este procedimento mostra como utilizar o Fornecedor de Dados OData fornecido com o programa para utilizar como origem de dados da tabela virtual.

Aceda a Definições > Administração > Origens de Dados de Entidade Virtual.
Na barra de ferramentas ações, clique em Novo.
Na caixa de diálogo Selecionar Fornecedor de Dados, selecione as seguintes origens de dados e, em seguida, clique em OK.
- Fornecedor de Dados OData v4. O Dataverse inclui um fornecedor de dados Odata v4 que pode ser utilizado para ligar a origens de dados que suportem a norma aberta OData v4.
- Fornecedor de dados personalizado. Se tiver importado um plug-in de fornecedor de dados, o fornecedor de dados será apresentado aqui. Mais informações Documentação do Programador: Começar a utilizar tabelas virtuais
Na página de propriedades Nova Origem de Dados, preencha as seguintes colunas e, em seguida, guarde a linha.
- Nome. Escreva um nome que descreva a origem de dados.
- Uri. Se estiver a utilizar o Fornecedor de Dados OData, introduza o URI para o serviço Web OData. Por exemplo, se estiver a utilizar o fornecedor OData para ligar a um serviço Web alojado no Azure, o URI pode ter um aspeto semelhante a https://contosodataservice.azurewebsites.net/odata/.
- Tempo limite em segundos. Introduza o número de segundos a esperar por uma resposta do serviço Web antes de ocorrer o tempo limite do pedido de dados. Por exemplo, introduza 30 para aguardar um máximo de 30 segundos antes exceder o tempo limite.
- Modo de Paginação. Selecione se pretende utilizar a paginação do lado do cliente ou do lado do servidor para controlar o modo como os resultados da consulta são paginados. O valor predefinido é a paginação do lado do cliente. Com a paginação do lado do servidor, o servidor controla a forma como os resultados são paginados utilizando o parâmetro $skiptoken, que é adicionado à cadeia de consulta. Mais informações: Ignorar Opção de Consulta do Sistema de Token ($skiptoken)
  - Devolver contagem inline. Devolve o número total de linhas no conjunto de resultados. Esta definição é utilizada para ativar a funcionalidade de página seguinte quando devolve dados a uma grelha. Utilize um valor de Falso se o seu ponto final de OData não suportar o parâmetro $inclinecount OData. O valor predefinido é false.
- Parâmetros do Pedido. Opcionalmente, pode adicionar parâmetros de cabeçalho personalizado ou de cadeia de consulta utilizados para ligar ao serviço Web OData, como parâmetros de autenticação para o serviço externo. Clique em Cadeia de Consulta para alternar entre o parâmetro e o valor do cabeçalho e da cadeia de consulta. É possível adicionar até 10 cabeçalhos ou cadeias de consulta.

Consulte também

Criar e editar tabelas virtuais que contêm dados a partir de uma origem de dados externa

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).