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ásról szóló verziót a következő helyen találja: OData v4 adatszolgáltató konfigurálása
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 Nullable=False értékű OData-entitástulajdonság leképezett mezőjének a Mezőkövetelmény attribútummal Szükséges értékre kell állítania.
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ó.
Lépjen a Beállítások felügyelete>virtuális entitás adatforrásai> részre.
A műveletek eszköztáron válassza az Új lehetőséget.
Az Adatszolgáltató kiválasztása párbeszédpanelen válasszon az alábbi adatforrások közül, majd kattintson az OK gombra.
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.
Egyéni adatszolgáltató. Ha importált egy adatszolgáltató beépülő modult, az adatszolgáltató itt fog megjelenni. További információ: Első lépések a virtuális entitásokkal
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óval csatlakozik egy Azure-ban üzemeltetett webszolgáltatáshoz, az URI a következőhöz hasonló lehet
https://contosodataservice.azurewebsites.net/odata/Időtúllépés másodpercben. Í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ó: Jogkivonat-rendszerlekérdezési beállítás kihagyása ($skiptoken)
- Beágyazott szám visszaadása. 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.
Paraméterek kérése. 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). Válassza a Lekérdezési sztring lehetőséget a fejléc és a lekérdezési sztring paramétere és értéke közötti váltáshoz. Legfeljebb 10 fejléc vagy lekérdezési karakterlánc vehető fel.
Kapcsolódó információk
Külső adatforrás adatait tartalmazó virtuális entitások létrehozása és szerkesztése
TechNet-blog: Külső rendszerekből származó adatok kezelése az új virtuális entitások használatával