OData v4 Adatszolgáltató konfigurálása és gyakorlati tanácsok

Ez a témakör a Dynamics 365 Customer Engagement (on-premises) szolgáltatásra vonatkozik. A témakör Power Apps szolgáltatásra vonatkozó verzióját itt találja: OData 4-es verziójú adatszolgáltató konfigurációja

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

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

• A példánya megköveteli, hogy minden entitásnak legyen egy azonosító attribútuma. Ezt az azonosítót egyedi azonosítónak nevezik, és értéke kötelezően guid. Az azonosítómezők külső mezőkre csak az EDM.Gui adattípussal képezhető le. Egy EDM.Int32 adattípus nem képezhető le egy uniqueidentifer adattípusú mezőre a rendszerben.

• Az OData entitásokat üresre állítható tulajdonságokkal a virtuális entitásban lévő leképezett mezőnek megfelelően kell beállítani. Például egy OData entitástulajdonság Nullable=False beállítással a leképezett mezőnek a mezőkövetelmény-attribútumban Üzleti követelmény é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ó: Rendszerbeállítások párbeszédpanel – Testreszabás lap

Adattípus-leképezés

A következő táblázat az OData Entity Data Model (EDM) adattípus leképezéseit sorolja fel a megfelelő adattípusokkal.

OData adattípus	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 entitásokkal 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 entitás 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áron válassza az Új lehetőséget.

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

   • OData v4-adatszolgáltató. Az Ön környezete rendelkezik egy Odata v4 adatszolgáltatóval, amellyel 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ó: Ismerkedés a virtuális entitásokkal

4. Az Új adatforrás tulajdonságai oldalon töltse ki a következő mezőket, és mentse a bejegyzést.

   • 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 az OData-szolgáltatót használja egy Azure-ban üzemeltetett webszolgáltatáshoz való csatlakozáshoz, az URI a következőhöz hasonlóan nézhet ki: 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ó: Kihagyás jogkivonat rendszer lekérdezés lehetőség ($skiptoken)

     • Visszaküldés beágyazott száma. A bejegyzések 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 $inclinecount 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 entitások létrehozása és módosítása
TechNet Blog: Külső rendszerekből származó adatok használata az új virtuális entitások segítségével

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