Configurare furnizor de date OData v4 și cele mai bune practici

Acest subiect se aplică la Dynamics 365 Customer Engagement (on-premises). Pentru versiunea Power Apps a acestui subiect, consultați: Configurația OData v4 furnizor de date

Acest subiect descrie configurarea furnizorului de date OData v4, precum și cerințele și cele mai bune practici recomandate pentru utilizarea furnizorului de date OData v4 pentru conectarea cu un serviciu web OData v4.

Cele mai bune practici ale furnizorului de date OData v4

• Instanța dumneavoastră necesită că toate entitățile să aibă un atribut ID. Acest ID este cunoscut ca un identificator unic iar valoarea trebuie să fie un guid. Puteți să mapați ID-uri de câmpuri doar la câmpuri externe cu tipul de date EDM.Guid. Nu puteți să mapați un tip de date EDM.Int32 la un câmp de tip de date uniqueidentifer.

• Entitățile OData cu proprietăți ce pot fi nule trebuie setate pentru a se potrivi câmpului mapat în entitatea virtuală. De exemplu, o proprietate de entitate OData cu Nullable=False trebuie să aibă câmpul mapat cu atributul Field Requirement setat la Business Required.

• Pentru a regăsi mai multe interogări, cum ar fi atunci când încărcați date într-o grilă, controlați dimensiunea setului de date returnat din sursa de date externă utilizând parametri de interogare pentru selectare și filtrare.

• Dacă nu este deja activată, administratorii de sistem trebuie să activeze urmărirea inserturilor. Odată activată, toate erorile din punctul final OData sunt capturate în jurnalul de urmărire a inserturilor. Mai multe informații: Casa de dialog Setări sistem - fila Personalizare

Maparea tipului de date

Următorul tabel listează mapările tipului de date OData Entity Data Model (EDM) cu tipul de date adecvat.

Tipul de date OData	Tip de date
Edm.Boolean	Două opțiuni
Edm.DateTime	Dată și oră
Edm.DateTimeOffset	Dată și oră
Edm.Decimal	Număr zecimal sau monedă
Edm.Double	Număr cu virgulă mobilă
Edm.Guid	Identificator unic
Edm.Int32	Număr întreg
Edm.Int64	Număr întreg
Edm.String	O singură linie de text sau mai multe linii de text

Tipurile de date OData EDM care nu sunt acceptate pentru maparea cu entități virtuale

• Edm.Binary

• Edm.Time

• Edm.Float

• Edm.Single

• Edm.Int16

• Edm.Byte

• Edm.SByte

Adăugați o sursă de date utilizând furnizorul de date OData v4

Această procedură vă arată cum să utilizați furnizorul de date OData implicit de utilizat ca sursă de date pentru entitate virtuală.

1. Accesați Setări>Administrare>Surse de date ale entităților virtuale.

2. În bara de instrumente pentru acțiuni, selectați Nou.

3. În caseta de dialog Selectare furnizor de date, selectați dintre următoarele surse de date, apoi selectați OK.

   • OData v4 furnizor de date. Mediul dvs. include un furnizor de date Odata v4 care poate fi utilizat pentru a vă conecta la surse de date care acceptă standardul deschis OData v4.

   • Personalizat furnizor de date. Dacă ați importat un insert furnizor de date, furnizorul de date va apărea aici. Mai multe informații: Începeți cu entitățile virtuale

4. Pe pagina de proprietăți Sursă de date nouă, completați următoarele câmpuri, apoi salvați înregistrarea.

   • Nume. Tastați un nume care descrie sursa de date.

   • Uri. Dacă folosiți furnizorul de date OData, introduceți uri-ul pentru serviciul web OData. De exemplu, dacă utilizați furnizorul OData pentru a vă conecta la un serviciu web găzduit în Azure, URI-ul poate arăta similar cu https://contosodataservice.azurewebsites.net/odata/

   • Timeout în secunde. Introduceți numărul de secunde pentru a aștepta un răspuns de la serviciul web înainte de expirarea unei solicitări de date. De exemplu, introduceți 30 pentru a aștepta maximum treizeci de secunde înainte să apară o expirare.

   • Modul de paginare. Selectați dacă se utilizează paginarea la nivel de client sau la nivel de server pentru a controla modul în care sunt paginate rezultatele interogării. Valoarea implicită este paginarea la nivel de client. Cu paginarea la nivel de server, serverul controlează modul în care sunt paginate rezultatele utilizând parametrul $skiptoken, care se adaugă la șirul de interogare. Mai multe informații: Omiteți opțiunea de interogare a sistemului de simboluri ($skiptoken)

     • Returnează numărul inline. Întoarce numărul total de înregistrări din setul de rezultate. Această setare este utilizată pentru a activa funcționalitatea următoarei pagini atunci când returnați datele într-o rețea. Utilizați o valoare de false dacă punctul final OData nu acceptă parametrul $inclinecount OData. Valoarea implicită este false.

   • Parametri de solicitare. Opțional, puteți adăuga antetul particularizat sau parametrii șirului de interogare utilizați pentru a vã conecta la serviciul web OData, cum ar fi parametrii de autentificare la serviciul extern. Selectați Șir de interogare pentru a comuta între parametrul și valoarea pentru antet și șirul de interogare. Până la 10 antete sau șiruri de interogare pot fi adăugate.

   

Consultați și

Creați și editați entități virtuale care conțin date dintr-un sursă de date extern
Blog TechNet: Interacționați cu datele din sisteme externe folosind noile entități virtuale