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, a se vedea: Configurație furnizor de date OData v4

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 cerinței de câmp setat la Obligatoriu pentru firmă.

• 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. Informații suplimentare: Caseta de dialog Setări de sistem - fila Particularizare

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 entitate virtuală.

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

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

   • Furnizor de date OData v4. 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.

   • Furnizor de date particularizat. Dacă ați importat un insert furnizor de date, furnizorul de date va apărea aici. Informații suplimentare: Introducere în 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/

   • Expirare î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.

   • Mod paginație. 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. Informații suplimentare: Omitere opțiune e interogare sistem token ($skiptoken)

     • Returnare număr entități în linie. Î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 antet și parametrul și valoarea șirului de interogare. Până la 10 antete sau șiruri de interogare pot fi adăugate.

   

Consultați și

Crearea și editarea entităților virtuale care conțin date dintr-o sursă de date externă
Blogul TechNet: Interacționați cu date din sisteme externe, folosind noile entități virtuale

Hinweis

Ne puteți spune care preferințele dvs. lingvistice pentru documentație? Răspundeți la un chestionar scurt. (rețineți că acest chestionar este în limba engleză)

Chestionarul va dura aproximativ șapte minute. Nu sunt colectate date personale (angajament de respectare a confidențialității).