Configuração, requisitos e práticas recomendadas do Provedor de Dados OData v4

Este tópico descreve como configurar o Provedor de Dados OData v4, bem como os requisitos e práticas recomendadas de uso do provedor de dados OData v4 para conectar com o serviço Web do OData v4.

Práticas recomendadas do provedor de dados OData v4

• Microsoft Dataverse requer que todas as tabelas tenham um atributo ID, essa ID é conhecida como um identificador exclusivo e o valor deve ser um guid. Só é possível mapear colunas de ID para colunas externas com o tipo de dados Edm.Guid. Não é possível mapear um tipo de dados Edm.Int32 para uma coluna de tipo de dados do identificador exclusivo no Dataverse.
• As tabelas OData com propriedades nulas devem ser configuradas para corresponder à coluna mapeado na tabela virtual. Por exemplo, uma propriedade da tabela OData com Nullable=False deve ter a coluna mapeada no atributo Requisito do Campo do do Dataverse definido como Requisitos Comerciais.
• Para recuperar várias consultas, como quando você carrega dados em uma grade, controle o tamanho do conjunto de dados retornado da fonte de dados externa usando os parâmetros de consulta de seleção e filtro.
• Caso ainda não tenha sido habilitado, os administradores do sistema devem habilitar o rastreamento de plug-in. Depois de habilitado, todos os erros do ponto de extremidade OData são capturados no log de rastreamento do plug-in. Mais informações: Guia do administrador: caixa de diálogo Configurações do Sistema – guia de personalização
• Você não pode usar o Provedor de Dados OData v4 para se conectar a outro ambiente.

Mapeamento de tipo de dados

A tabela a seguir lista os mapeamentos de tipo de dados de Modelo de Dados de Tabela OData com os tipos de dados do Dataverse.

Tipos de dados EDM OData que não oferecem suporte para mapeamento com tabelas virtuais

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

Adicionar uma fonte de dados usando o Provedor de Dados OData v4

Este procedimento mostra como usar o Provedor de Dados OData pronto para uso como o provedor de dados da tabela virtual.

1. Vá para Configurações>Administração>Fontes de Dados da Entidade Virtual.

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

3. Na caixa de diálogo Selecionar Provedor de Dados, selecione uma das fontes de dados a seguir e clique em OK.

   • Provedor de Dados OData v4. O Dataverse inclui um provedor de dados OData v4 que pode ser usado para conexão com fontes de dados compatíveis com o padrão aberto OData v4.
   • Provedor de dados personalizado. Se você tiver importado um plug-in de provedor de dados, o provedor de dados aparecerá aqui. Mais informações: Documentação do desenvolvedor: introdução às tabelas virtuais

4. Na página de propriedades Nova Fonte de Dados, preencha as colunas a seguir e salve a linha.

   • Nome.. Digite um nome que descreva a fonte de dados.
   • Uri. Se você estiver usando o Provedor de Dados OData, insira o uri do serviço Web OData. Por exemplo, se estiver usando o provedor OData para estabelecer conexão a um serviço Web hospedado no Azure, a URI pode ser semelhante a https://contosodataservice.azurewebsites.net/odata/.
   • Tempo limite em segundos. Insira o número de segundos para aguardar por uma resposta do serviço Web antes do tempo limite da solicitação de dados. Por exemplo, insira 30 para aguardar até 30 segundos antes que o tempo limite ocorra.
   • Modo de Paginação. Selecione usar a paginação do cliente ou do servidor para controlar como os resultados de consulta são paginados. O valor padrão é paginação do cliente. Com uma paginação do servidor, o servidor controla como os resultados são paginados usando o parâmetro $skiptoken, que é adicionado à cadeia de consulta. Mais informações: Opção de consulta do sistema de token de omissão ($skiptoken)
     • Retornar contagem embutida. Retorna o número total de linhas no conjunto de resultados. Essa configuração é usada para habilitar a funcionalidade da página seguinte quando você retorna dados para uma grade. Use um valor falso se seu ponto de extremidade OData não for compatível com o parâmetro OData $inlinecount. O valor padrão é false.
   • Parâmetros da Solicitação. Opcionalmente, é possível adicionar parâmetros de cadeia de caracteres de cabeçalho ou de consulta personalizados usados na conexão com o serviço Web OData, como os parâmetros de autenticação no serviço externo. Clique em Cadeia de Caracteres de Consulta para alternar entre o parâmetro e o valor da cadeia de caracteres de consulta e de cabeçalho. Até 10 cadeias de caracteres de consulta ou de cabeçalho podem ser adicionadas.

     

Consulte também

Criar e editar tabelas virtuais que contenham dados de uma fonte de dados externa