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

Este tópico aplica-se ao Dynamics 365 Customer Engagement (on-premises). Para a versão Power Apps deste tópico, consulte: Configuração do Fornecedor de Dados OData v4

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

• A sua instância requer que todas as entidades tenham um atributo de ID. Este ID é conhecido como um identificador exclusivo e o valor tem de ser um guid. Só pode mapear os campos de ID para campos externos com o tipo de dados EDM.Guid. Não é possível mapear um tipo de dados EDM.Int32 com um campo de dados uniqueidentifer.

• As entidades OData com propriedades anuláveis têm de ser definidas para corresponderem ao campo mapeado na entidade virtual. Por exemplo, uma propriedade da entidade OData com Nullable=False tem de ter um campo mapeado com o conjunto de atributos Requisito de Campo definido como Requerido pelo Negócio.

• 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: Caixa de diálogo de Configurações do Sistema - separador Personalização

Mapeamento de tipos de dados

A tabela seguinte lista os mapeamentos de tipos de dados OData Entity Data Model (EDM) com os tipos de dados apropriados.

Tipos de dados OData EDM não suportados para mapeamento com entidades 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 entidade virtual.

1. Aceda a Definições>Administração>Origens de Dados de Entidade Virtual.

2. Na barra de ferramentas Ações, selecione Novo.

3. Na caixa de diálogo Selecionar Fornecedor de Dados, selecione as seguintes origens de dados e, em seguida, selecione OK.

   • Fornecedor de Dados OData v4. O seu ambiente 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: Introdução às entidades virtuais

4. Na página de propriedades Nova Origem de Dados, preencha os seguintes campos e, em seguida, guarde o registo.

   • 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: Token de Omissão de Consulta do Sistema ($skiptoken)

     • Devolver contagem inline. Devolve o número total de registos 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 false se o ponto final 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. Selecione 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 entidades virtuais que contêm dados a partir de uma origem de dados externa
Blogue do TechNet: Interaja com os dados de sistemas externos com as novas entidades virtuais