Configurarea, cerințele și cele mai bune practici pentru furnizorul 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

• Microsoft Dataverse necesită ca toate tabelele să aibă un ID de atribut, ca acest ID de atribuit să fie cunoscut ca identificator unic și ca valoarea să fie un guid. Puteți să mapați ID-uri de coloane doar la coloane externe cu tipul de date Edm.Guid. Nu puteți mapa tipul de date Edm.Int32 la o coloană cu tip de date Identificator Unic în Dataverse.
• Tabelele OData cu proprietăți ce pot fi nule trebuie setate pentru a se potrivi coloanei mapate în tabelul virtual. De exemplu, o proprietate de tabel OData cu Nullable=False trebuie să aibă coloana mapată cu atributul Dataverse Cerință 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. Mai multe informații: Ghid de Administrator: caseta de dialog Setări de sistem - fila particularizare
• Nu puteți utiliza OData v4 Data Provider pentru a vă conecta la un alt mediu.

Maparea tipului de date

Următorul tabel listează mapările tipului de date model de date pentru tabele OData (EDM) cu tipurile de date Dataverse.

Tipul de date OData	Tip de date Dataverse
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 în 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 tabele 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 tabel virtual.

1. Accesați Setări > Administrare > Surse de date entitate virtuală.

2. Pe bara de instrumente Acțiuni, faceți clic pe Nou.

3. În caseta de dialog Selectați furnizorul de date, selectați din următoarele surse de date, apoi faceți clic pe OK.

   • Furnizor de date OData v4. Dataverse 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. Mai multe informații: Documentație pentru dezvoltatori: Introducere în tabele virtuale

4. Pe pagina de proprietăți Sursă nouă de date, completați coloanele următoare și apoi salvați rândul.

   • 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. Mai multe informații: Omitere opțiune e interogare sistem token ($skiptoken)
     • Returnare număr entități în linie. Returnează numărul total de rânduri 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. Faceți clic pe Ș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 tabelelor virtuale care conțin date dintr-o sursă de date externă

Notă

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).