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.

1. Prejdite na Nastavenia>Správa>Zdroje údajov virtuálnych entít.

2. Na paneli s nástrojmi akcií vyberte Nové.

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

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