Configuración e prácticas recomendadas do fornecedor de datos de OData v4
Este tema aplícase a Dynamics 365 Customer Engagement (on-premises). Para a versión de Power Apps deste tema, consulte: Configuración do provedor de datos OData v4
Este tema describe como configurar o fornecedor de datos OData v4, así como os requisitos e as prácticas recomendadas para utilizar o fornecedor de datos OData v4 para establecer a conexión cun servizo web de OData v4.
Prácticas recomendadas do fornecedor de datos de OData v4
A instancia require que todas as entidades teñan un atributo de ID. Este ID coñécese como identificador exclusivo e o valor debe ser un GUID. Vostede só pode asignar os campos de ID a campos externos co tipo de datos EDM.Guid. Non pode asignar un tipo de datos EDM.Int32 a un campo de tipo de datos uniqueidentifer.
As entidades de OData que teñan propiedades con valores nulos deben configurarse para que coincidan co campo asignado na entidade virtual. Por exemplo, unha propiedade de entidade OData con Nullable=False debe ter o campo asignado co atributo Requisito de campo definido en Negocio necesario.
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: Cadro de diálogo Configuración do sistema: pestana Personalización
Asignación de tipos de datos
A seguinte táboa mostra as asignacións de tipo de datos de OData Entity Data Model (EDM) co tipo de datos apropiado.
| Tipo de datos de OData | Tipo de datos |
|---|---|
| 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 entidades 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 entidade virtual.
Vaia a Configuración>Administración>Fontes de datos de entidades virtuais.
Na barra de ferramentas de accións, seleccione Novo.
No cadro de diálogo Seleccionar provedor de datos, seleccione entre as seguintes fontes de datos e, a continuación, seleccione Aceptar.
Fornecedor de datos OData v4. O seu ambiente 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 personalizados. Se importou un complemento de fornecedor de datos, o fornecedor de datos aparecerá aquí. Máis información: Comezar coas entidades virtuais
Na páxina de propiedades Nova orixe de datos, encha os seguintes campos e, a seguir, garde o rexistro.
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 usar o provedor OData para conectarse a un servizo web aloxado en Azure, o URI pode parecer
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 de consulta do sistema Omitir token ($skiptoken)
- Devolve o reconto en liña. Devolve o número total de rexistros 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 $inclinecount. 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. Seleccione Cadea de consulta para alternar entre o parámetro e o valor de cabeceira e cadea de consulta. Pódense engadir até 10 cadeas de consulta ou cabeceira.
Consulte tamén
Crea e edita entidades virtuais que conteñan datos dun orixe de datos externo
Blog de TechNet: interactúa con datos de sistemas externos utilizando as novas entidades virtuais