Configuración, requisitos e prácticas recomendadas do fornecedor de datos de OData v4

Este tema describe como configurar o fornecedor de datos de OData v4, así como os requisitos e as prácticas recomendadas para utilizar o fornecedor de datos de OData v4 para establecer a conexión cun servizo web de OData v4.

Prácticas recomendadas do fornecedor de datos de OData v4

• Microsoft Dataverse require que todas as táboas teñan un atributo de ID, que se coñece como identificador único e o seu valor debe ser un GUID. Vostede só pode asignar as columnas de ID a columnas externas co tipo de datos Edm.Guid. Non pode asignar un tipo de datos Edm.Int32 a unha columna de tipo de datos Identificador único en Dataverse.
• As táboas de OData que teñan propiedades con valores nulos deben configurarse para que coincidan coa columna asignada na táboa virtual. Por exemplo, unha propiedade da táboa de OData cun valor Nullable=False debe ter a columna asignada no conxunto de atributos de Requisito de campo de Dataverse como Requirido pola empresa.
• Para recuperar varias consultas, como cando carga datos nunha grade, controle o tamaño do conxunto de datos devolto desde a orixe de datos externa mediante os parámetros para seleccionar e filtrar a consulta.
• Se non está activado, os administradores do sistema deben activar a opción de rastrexo de complementos. Cando está activado, todos os erros do extremo de OData captúranse no rexistro de rastrexo de complementos. Máis información: Guía do Administrador: caixa de diálogo de Configuración do Sistema: separador Personalización
• Non pode usar o provedor de datos OData v4 para conectarse a outro ambiente.

Asignación de tipos de datos

A seguinte táboa mostra as asignacións de tipo de datos de OData Table Data Model (EDM) cos tipos de datos de Dataverse.

Tipo de datos de OData	Tipo de datos de Dataverse
Edm.Boolean	Dúas opcións
Edm.DateTime	Data e hora
Edm.DateTimeOffset	Data e hora
Edm.Decimal	Número decimal ou moeda
Edm.Double	Número de punto flotante
Edm.Guid	Identificador único
Edm.Int32	Número enteiro
Edm.Int64	Número enteiro
Edm.String	Unha liña de texto ou varias liñas de texto

Tipos de datos de OData EDM que non se poden asignar con táboas virtuais

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

Engadir unha orixe de datos utilizando o fornecedor de datos de OData v4

Este procedemento mostra como utilizar o fornecedor de datos de OData integrado como orixe de datos de táboa virtual.

1. Vaia a Configuración > Administración > Orixes de datos de entidade virtual.

2. Na barra de ferramentas de acción, prema Novo.

3. Na caixa de diálogo Seleccionar fornecedor de datos seleccione un dos seguintes orixes de datos e, a seguir, prema Aceptar.

   • Fornecedor de datos OData v4. Dataverse inclúe un fornecedor de datos de Odata v4 que se pode usar para conectarse ás orixes de datos que admiten o estándar aberto de OData v4.
   • Fornecedor de datos personalizado. Se importou un complemento de fornecedor de datos, o fornecedor de datos aparecerá aquí. Máis información: Documentación de programador: introdución ás táboas virtuais

4. Na páxina de propiedades Nova orixe de datos, encha as seguintes columnas e, a seguir, garde a fila.

   • Nome. Escriba un nome para describir a orixe de datos.
   • Uri. Se utiliza o fornecedor de datos de OData, especifique o URL para o servizo web de OData. Por exemplo, se está a utilizar o fornecedor de OData para conectarse a un servizo web aloxado en Azure, o URI pode parecerse a https://contosodataservice.azurewebsites.net/odata/.
   • Tempo de espera en segundos. Introduza o número de segundos que se debe esperar unha resposta do servizo web antes de esgotar o tempo de espera dunha solicitude de datos. Por exemplo, introduza 30 para esperar un máximo de trinta segundos antes de que se esgote o tempo de espera.
   • Modo de paxinación. Seleccione se utilizará a paxinación no cliente ou no servidor para controlar como se paxinan os resultados da consulta. O valor predefinido é a paxinación no cliente. Coa paxinación no servidor, o servidor controla a maneira de paxinar os resultados utilizando o parámetro $skiptoken, que se engade á cadea de consulta. Máis información: Opción para omitir a consulta do sistema de token ($skiptoken)
     • Devolver reconto entre liñas Devolve o número total de filas no conxunto de resultados. Esta configuración utilízase para activar a funcionalidade da seguinte páxina cando se devolven os datos a unha grade. Utilice un valor "false" se o extremo de OData non admite o parámetro de OData $inlinecount. O valor predefinido é false.
   • Parámetros de solicitude. Como alternativa, pode engadir os parámetros de cadea de consulta ou cabeceira personalizado que se utilizan para conectar co servicio web de OData, como parámetros de autenticación para o servizo externo. Prema Cadea de consulta para alternar entre o parámetro de cadea de consulta e cabeceira e o valor. Pódense engadir até 10 cadeas de consulta ou cabeceira.

     

Consulte tamén

Crear e editar táboas virtuais que conteñen datos desde unha orixe de datos externa

Nota

Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)

Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).