Configuració del proveïdor de dades OData v4 i pràctiques recomanades

Aquest tema s'aplica al Dynamics 365 Customer Engagement (on-premises). Per a la versió del Power Apps d'aquest tema, vegeu: Configuració del proveïdor de dades OData v4

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

• La instància requereix que totes les entitats tinguin un atribut d'ID. Aquest ID es coneix com un identificador únic i el valor ha de ser un guid. Només podeu assignar camps de l'ID a camps externs amb el tipus de dades EDM.Guid. No podeu assignar un tipus de dades EDM.Int32 a un camp de tipus de dades d'identificador únic.

• Les entitats OData amb propietats que es poden anul·lar s'han d'establir perquè coincideixin amb el camp assignat a l'entitat virtual. Per exemple, una propietat d'entitat OData amb Nullable=False ha de tenir el camp assignat amb l'atribut Requisit de camp definit com a Business required.

• 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ó: Quadre de diàleg Configuració del sistema - pestanya Personalització

Assignació de tipus de dades

La taula següent enumera les assignacions de tipus de dades de Model de dades d'entitat (EDM) OData amb el tipus de dades apropiat.

Tipus de dades OData	Tipus de dades
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 entitats 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 l'entitat virtual.

1. Aneu a Configuració>Administració de fonts> de dades de l'entitatvirtual.

2. A la barra d'eines d'accions, seleccioneu Crea.

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

   • Proveïdor de dades OData v4. L'entorn 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ó: Introducció a les entitats virtuals

4. A la pàgina de propietats Origen de dades nou, empleneu els camps següents i, a continuació, deseu el registre.

   • 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 tenir un aspecte similar 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ó: Omet l'opció de consulta del sistema de testimonis ($skiptoken)

     • Recompte de retorns en línia. Retorna el número total de registres 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. Seleccioneu Query String per alternar entre capçalera i paràmetre i valor de la cadena de consulta. Es poden afegir fins a 10 cadenes de consulta o capçalera.

   

Consulteu també

Crear i editar entitats virtuals que contenen dades d'una font de dades externa
TechNet Blog: Interactuar amb dades de sistemes externs utilitzant les noves entitats virtuals