Configuració del proveïdor de dades OData v4, requisits i recomanacions

En aquest tema es descriu com configurar el proveïdor de dades OData v4, així com els requisits i les pràctiques recomanades per utilitzar-lo per connectar-se amb un servei web OData v4.

Pràctiques recomanades del proveïdor de dades OData v4

• Microsoft Dataverse requereix que totes les taules tinguin un atribut d'ID, aquest ID s'anomena identificador únic i el valor ha de ser un GUID. Només podeu assignar columnes de l'ID a columnes externes amb el tipus de dades Edm.Guid. No podeu assignar un tipus de dades Edm.Int32 a una columna de tipus de dades d'identificador únic al Dataverse.
• Les taula OData amb propietats que es poden anul·lar s'han d'establir perquè coincideixin amb la columna assignada a la taula virtual. Per exemple, una propietat de taula OData amb Nullable=False ha de tenir la columna assignada a l'atribut de requisit del camp del Dataverse definida en Necessari per a l'empresa.
• Per recuperar consultes múltiples, com ara quan carregueu dades a una quadrícula, controleu la mida del conjunt de dades retornat de la font de dades externa mitjançant els paràmetres de consulta de selecció i filtre.
• Si encara no està activat, els administradors de sistema han d'habilitar el seguiment del complement. Una vegada habilitat, tots els errors de l'extrem OData es capturen en el registre de seguiment del complement. Més informació: Guia de l'administrador: Quadre de diàleg Configuració del sistema (pestanya Personalització)
• No podeu utilitzar el Proveïdor de dades OData v4 per connectar-vos a un altre entorn.

Assignació de tipus de dades

La taula següent enumera les assignacions de tipus de dades de Model de dades de taula (EDM) OData amb els tipus de dades del Dataverse.

Tipus de dades OData	Tipus de dades del Dataverse
Edm.Boolean	Dues opcions
Edm.DateTime	Data i hora
Edm.DateTimeOffset	Data i hora
Edm.Decimal	Nombre decimal o moneda
Edm.Double	Nombre de coma flotant
Edm.Guid	Identificador únic
Edm.Int32	Nombre enter
Edm.Int64	Nombre enter
Edm.String	Línia de text única o diverses línies de text

Tipus de dades OData EDM que no són compatibles amb l'assignació amb taules virtuals

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

Afegiu una font de dades utilitzant el proveïdor de dades OData v4

Aquest procediment mostra com s'utilitza el proveïdor de dades d'OData predefinit com a font de dades de la taula virtual.

1. Aneu a Configuració > Administració > Fonts de dades de l'entitat virtual.

2. A la barra d'eines d'accions, feu clic a Crea.

3. Al quadre de diàleg Seleccioneu el proveïdor de dades, seleccioneu una de les següents fonts de dades i feu clic a D'acord.

   • Proveïdor de dades OData v4. El Dataverse inclou un proveïdor de dades d'Odata v4 que es pot utilitzar per connectar-se a fonts de dades que admeten l'estàndard obert OData v4.
   • Proveïdor de dades personalitzat. Si heu importat un complement de proveïdor de dades, el proveïdor de dades apareixerà aquí. Més informació: Documentació per a desenvolupadors: Introducció a les taules virtuals

4. A la pàgina de propietats Font de dades nova, empleneu les columnes següents i, a continuació, deseu la fila.

   • Nom. Escriviu un nom per descriure la font de dades.
   • Uri. Si utilitzeu el proveïdor de dades d'OData, introduïu l'uri del servei web d'OData. Per exemple, si utilitzeu el proveïdor d'OData per connectar-vos a un servei web allotjat a l'Azure, l'URI pot teniu un aspecte semblant a https://contosodataservice.azurewebsites.net/odata/.
   • Temps d'espera en segons. Introduïu el nombre de segons que heu d'esperar per una resposta del servei web abans del temps d'espera de sol·licitud de dades. Per exemple, introduïu 30 per esperar un màxim de trenta segons abans que es produeixi un temps d'espera.
   • Mode de paginació. Seleccioneu si voleu fer la paginació de client o de servidor per controlar com es paginen els resultats de la consulta. El valor per defecte és paginació del client. Amb la paginació del servidor, el servidor controla com es paginen els resultats mitjançant el paràmetre $skiptoken, que s'afegeix a la cadena de consulta. Més informació: Saltar l'opció de consulta del sistema de testimoni ($skiptoken)
     • Torna el recompte en línia. Retorna el número total de files en el conjunt de resultats. Aquesta opció s'utilitza per habilitar la funcionalitat de pàgina següent quan retorneu dades a una quadrícula. Utilitzeu un valor de fals si el vostre extrem OData no admet el paràmetre OData $inlinecount. El valor per defecte és "fals".
   • Paràmetres de sol·licitud. Opcionalment, podeu afegir una capçalera personalitzada o paràmetres de cadena de consulta per connectar-vos al servei web d'OData, com ara paràmetres d'autenticació al servei extern. Feu clic a Cadena de consulta per canviar entre el paràmetre i el valor de cadena de consulta i la capçalera. Es poden afegir fins a 10 cadenes de consulta o capçalera.

     

Consulteu també

Crear i editar taules virtuals que contenen dades des d'una font de dades externa

Nota

Ens podeu dir quines són les vostres preferències d'idioma per a la documentació? Responeu una breu enquesta. (tingueu en compte que l'idioma de l'enquesta és l'anglès)

Trigareu uns set minuts a completar l'enquesta. No es recopilen dades personals (declaració de privadesa).