OData v4 Adatszolgáltató konfigurálása, követelmények és gyakorlati tanácsok

Ez a témakör ismerteti, hogyan konfigurálható az OData v4 Data Provider, valamint a követelményeket, és gyakorlati tanácsokat az OData v4 Data Provider használatához az OData v4 webszolgáltatáshoz való kapcsolódás során.

OData v4-adatszolgáltató bevált megoldások

• Microsoft Dataverse megköveteli, hogy minden táblázatnak legyen egy azonosító attribútuma, ez az egyedi azonosító, és az értéknek egy guidnak kell lennie. Az azonosítóoszlopk külső oszlopokra csak az Edm.Guid adattípussal képezhetők le. Egy Edm.Int32 adattípus nem képezhető le egy egyedi azonosító adattípusú oszlophoz a Dataverse rendszerben.
• Az OData táblázatokat üresre állítható tulajdonságokkal a virtuális táblázatban lévő leképezett oszlopnak megfelelően kell beállítani. Például egy Nullable=False beállítással rendelkező OData táblázattulajdonság leképezett oszlopa a Dataverse megoldás Mezőkövetelmény attribútumában kötelezően Szükséges adat értékűnek kell lennie.
• Több lekérdezés beolvasásához, mint például amikor adatokat tölt be egy rácsba, ellenőrizze a külső adatforrásból származó adatkészletek méretét a kiválasztó és szűrő lekérdezési paraméterek használatával.
• Ha még nincs engedélyezve, a rendszergazdának engedélyeznie kell a beépülő modulok nyomkövetését. Engedélyezés után az OData végpontjából származó minden hibát a beépülő modul nyomkövetési naplója rögzíti. További információk: Rendszergazdák kézikönyve: Rendszerbeállítások párbeszédpanel – Testreszabás lap
• Az OData v4 Data Provider nem használható más -környezethez való kapcsolódásra.

Adattípus-leképezés

A következő táblázat az OData tábla adatmodell (EDM) adattípus leképezéseit sorolja fel a(z) Dataverse adattípusokkal.

OData adattípus	Dataverse Adattípus
Edm.Boolean	Két lehetőség
Edm.DateTime	Dátum és idő
Edm.DateTimeOffset	Dátum és idő
Edm.Decimal	Tízes számrendszerbeli szám vagy pénznem
Edm.Double	Lebegőpontos szám
Edm.Guid	Egyedi azonosító
Edm.Int32	Egész szám
Edm.Int64	Egész szám
Edm.String	Egy sornyi szöveg vagy több sornyi szöveg

OData EDM adattípusok, amelyek nem támogatottak virtuális táblázatokkal való leképezésre

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

Adatforrás hozzáadása az OData v4 adatszolgáltatóval

Ez az eljárás bemutatja, hogyan használható virtuális táblázat adatforrásként az OData adatszolgáltató.

1. Nyissa meg a Beállítások > Adminisztráció > Virtuális entitás adatforrásai menüpontot.

2. A műveletek eszköztárban kattintson az Új gombra.

3. Az Adatszolgáltató kiválasztása párbeszédpanelen válasszon az alábbi adatforrások közül, majd kattintson az OK lehetőségre.

   • OData v4-adatszolgáltató. A Dataverse rendelkezik egy Odata v4 adatszolgáltatóval, ezzel olyan adatforrásokhoz lehet csatlakozni, amelyek támogatják az OData v4 nyílt szabványt.
   • Egyedi adatszolgáltató. Ha importált egy adatszolgáltató beépülő modult, az adatszolgáltató itt fog megjelenni. További információ: Fejlesztői dokumentáció: Ismerkedés a virtuális táblákkal

4. Az Új adatforrás tulajdonságai oldalon töltse ki a következő oszlopokat, és mentse a sort.

   • Név. Írjon be egy nevet, amely leírja az adatforrást.
   • Uri. HA az OData adatszolgáltatót használja, adja meg az OData-webszolgáltatáshoz az URI-t. Ha például arra használja az OData szolgáltatót, hogy egy Azure-alapú webszolgáltatáshoz kapcsolódjon, akkor az URI hasonló lehet ehhez: https://contosodataservice.azurewebsites.net/odata/.
   • Időtúllépés másodpercekben. Írja be azt az időt, amennyit várni kell egy válaszra a webszolgáltatásból, adatlekérési időtúllépés előtt. Például írja be a 30 számot, hogy legfeljebb harminc másodpercet kelljen várni az időtúllépésig.
   • Tördelési mód. Válassza ki, hogy ügyféloldali vagy kiszolgálóoldali tördelést használ a lekérdezés tördeléséhez. Az alapértelmezett érték az ügyféloldali tördelés. A kiszolgálóoldali tördeléssel a kiszolgáló meghatározza, hogy hogyan tördelődnek az eredmények a $skiptoken paraméterrel, amely hozzáadódik a lekérdezési karakterlánchoz. További információk: Lexikális elem rendszer szűrőlekérdezésének kihagyása ($skiptoken)
     • Visszaküldés beágyazott száma. A sorok teljes számát adja vissza az eredménykészletben. Ez a beállítás a következő lap funkciót engedélyezi, amikor adatokat ad vissza egy rácsba. Hamis értéket használjon, ha az OData végpontja nem támogatja az OData $inlinecount paramétert. Az alapértelmezett érték a hamis.
   • Kérésparaméterek. Opcionálisan megadhat egyéni fejlécet vagy lekérdezésikarakterlánc-paramétereket az OData-webszolgáltatással kialakítandó kapcsolathoz (például a külső szolgáltatás hitelesítési paraméterei). A Lekérdezési karakterlánc lehetőségre kattintva válthat a fejléc, a lekérdezésikarakterlánc-paraméter és az érték között. Legfeljebb 10 fejléc vagy lekérdezési karakterlánc vehető fel.

     

Kapcsolódó információk

Külső forrásból származó adatokat tartalmazó virtuális táblák létrehozása és módosítása

Megjegyzés

Megosztja velünk a dokumentációja nyelvi preferenciáit? Rövid felmérés elvégzése. (ne feledje, hogy ez a felmérés angol nyelvű)

A felmérés elvégzése körülbelül hét percet vesz igénybe. Semmilyen személyes adatot nem gyűjtünk (adatvédelmi nyilatkozat).