Konfigurácia poskytovateľa údajov OData v4 a osvedčené postupy
Táto téma sa vzťahuje na Dynamics 365 Customer Engagement (on-premises). Informácie o verzii Power Apps v rámci tejto témy nájdete v článku: Konfigurácia poskytovateľa údajov OData v4
Táto téma popisuje konfiguráciu poskytovateľa údajov OData v4, ako aj požiadavky a odporúčané osvedčené postupy pre používanie poskytovateľa údajov OData v4 na prepojenie s webovou službou OData v4.
Poskytovateľ údajov OData v4, osvedčené postupy
Vaša inštancia vyžaduje, aby všetky entity mali atribút ID. Tento ID je známy ako jedinečný identifikátor a hodnota musí byť identifikátorom guid. Polia ID môžete mapovať len k vonkajším poliam s údajovým typom EDM.Guid. Nie je možné mapovať údajový typ EDM.Int32 na pole údajového typu s jedinečným identifikátorom.
Entity OData s možnou hodnotou null musia byť nastavené tak, aby zodpovedali mapovanému poľu vo virtuálnej entite. Napríklad vlastnosť entity OData s hodnotou Nullable=False musí mať mapované pole s atribútom Field Requirement nastaveným na Business Required.
Pre načítanie viacerých dotazov, napríklad keď načítavate údaje do mriežky, ovládajte veľkosť množiny údajov vrátených zo zdroja externých údajov pomocou parametrov dotazu na výber a filtrovanie.
Ak to ešte nie je povolené, správcovia systému by mali povoliť sledovanie doplnkov. Po povolení sa všetky chyby z koncového bodu OData zachytávajú v denníku sledovania doplnkov. Ďalšie informácie: Dialógové okno Nastavenia systému – karta Prispôsobenie
Mapovanie typu údajov
Nasledujúca tabuľka zobrazuje mapovanie typu údajov OData Entity Data Model (EDM) k vhodnému typu údajov.
Typ údajov OData | Typ údajov |
---|---|
Edm.Boolean | Dve možnosti |
Edm.DateTime | Dátum a čas |
Edm.DateTimeOffset | Dátum a čas |
Edm.Decimal | Celé číslo alebo mena |
Edm.Double | Číslo s pohyblivou desatinnou čiarkou |
Edm.Guid | Jednoznačný identifikátor |
Edm.Int32 | Celé číslo |
Edm.Int64 | Celé číslo |
Edm.String | Jeden riadok textu alebo viaceré riadky textu |
Typy údajov OData EDM, ktoré nie sú podporované pre mapovanie s virtuálnymi entitami
Edm.Binary
Edm.Time
Edm.Float
Edm.Single
Edm.Int16
Edm.Byte
Edm.SByte
Pridanie zdroja údajov pomocou poskytovateľa údajov OData v4
Tento postup vám ukáže, ako používať pripraveného poskytovateľa údajov OData ako zdroj údajov virtuálnej entity.
Prejdite na Nastavenia>Správa>Zdroje údajov virtuálnych entít.
Na paneli s nástrojmi akcií vyberte Nové.
V dialógovom okne Vybrať poskytovateľa údajov vyberte z nasledujúcich zdrojov údajov a potom vyberte OK.
Poskytovateľ údajov OData v4. Vaše prostredie zahŕňa poskytovateľa údajov Odata v4, ktorý je možné použiť na pripojenie k zdrojom údajov, ktoré podporujú otvorený štandard OData v4.
Poskytovateľ vlastných údajov. Ak ste importovali doplnok poskytovateľa údajov, poskytovateľ údajov sa zobrazí tu. Viac informácií: Začnite s virtuálnymi entitami
Na stránke vlastností Nového zdroja údajov vyplňte nasledovné polia a potom uložte záznam.
Názov. Zadajte názov, ktorý opisuje pre zdroj údajov.
Uri. Ak používate poskytovateľa údajov OData, zadajte identifikátor uri pre webovú službu OData. Ak napríklad používate poskytovateľa OData na pripojenie k webovej službe hosťovanej v Azure, identifikátor URI môže vyzerať podobne ako
https://contosodataservice.azurewebsites.net/odata/
Časový limit v sekundách. Zadajte počet sekúnd pre čakanie na odpoveď z webovej služby pred vypršaním časového limitu požiadavky o údaje. Napríklad zadajte 30, ak chcete čakať maximálne tridsať sekúnd na vypršanie časového limitu.
Režim stránkovania. Vyberte, či chcete používať stránkovanie na strane klienta alebo servera na ovládanie, ako sa majú stránkovať výsledky dotazu. Predvolená hodnota je stránkovanie na strane klienta. Pri stránkovaní na strane servera ovláda výsledky stránkovania server pomocou parametra $skiptoken, ktorý je pridaný do reťazca dotazu. Ďalšie informácie: Preskočiť možnosť systémového dopytu tokenu ($skiptoken)
- Vrátiť počet v riadku. Vráti celkový počet záznamov v množine výsledkov. Toto nastavenie sa používa na podporu funkcie ďalšej stránky, ak vraciate údaje do mriežky. Použite hodnotu false, ak koncový bod OData nepodporuje parameter OData $inclinecount. Predvolená hodnota je „false“.
Parametre požiadavky. Voliteľne môžete pridať parametre ako vlastná hlavička alebo reťazec dotazu, ktoré sa použijú na pripojenie k webovej službe OData, ako napríklad parametre overovania pre externé služby. Vyberte Reťazec dopytu na prepínanie medzi parametrom a hodnotou hlavičky a reťazca dopytu. Pridať je možné maximálne 10 hlavičiek alebo reťazcov dotazu.
Pozrite si tiež
Vytvárajte a upravujte virtuálne entity, ktoré obsahujú údaje z externého zdroj údajov
Blog TechNet: Interakcia s údajmi z externých systémov pomocou nových virtuálnych entít
Pripomienky
https://aka.ms/ContentUserFeedback.
Pripravujeme: V priebehu roka 2024 postupne zrušíme službu Problémy v službe GitHub ako mechanizmus pripomienok týkajúcich sa obsahu a nahradíme ju novým systémom pripomienok. Ďalšie informácie nájdete na stránke:Odoslať a zobraziť pripomienky pre