Konfigurácia poskytovateľa údajov OData v4, požiadavky a osvedčené postupy

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

• Microsoft Dataverse vyžaduje, aby všetky tabuľky mali atribút ID. Toto ID je známe ako jedinečný identifikátor a hodnota musí byť identifikátorom guid. Stĺpce ID môžete mapovať len k vonkajším stĺpcom s údajovým typom Edm.Guid. Nie je možné mapovať údajový typ Edm.Int32 k stĺpcu typu údajov jedinečného identifikátora v Dataverse.
• Tabuľky OData s možnou hodnotou null musia byť nastavené tak, aby zodpovedali mapovanému stĺpcu vo virtuálnej tabuľke. Napríklad vlastnosť tabuľky OData s Nullable = False musí mať mapovaný stĺpec v atribúte Požiadavka na pole Dataverse nastavené na Požadované podnikom.
• 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: Príručka správcu: dialógové okno Systémové nastavenia – karta prispôsobenie
• Poskytovateľa údajov OData v4 nemôžete použiť na pripojenie k inému prostrediu.

Mapovanie typu údajov

Nasledujúca tabuľka zobrazuje mapovanie typu údajov OData Table Data Model (EDM) k typu údajov Dataverse.

Typ údajov OData	Typ údajov Dataverse
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 tabuľkami

• 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 tabuľky.

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

2. Na akčnom paneli s nástrojmi kliknite na tlačidlo Nové.

3. V dialógovom okne Vyberte poskytovateľa údajov vyberte z nasledujúcich zdrojov údajov a potom kliknite na tlačidlo OK.

   • Poskytovateľ údajov OData v4. Dataverse zahŕňa poskytovateľa údajov Odata v4, ktorý je možné použiť na pripojenie k zdrojom údajov, ktoré podporujú otvorený štandard OData v4.
   • Vlastný poskytovateľ údajov. Ak ste importovali doplnok poskytovateľa údajov, poskytovateľ údajov sa zobrazí tu. Ďalšie informácie: Dokumentácia vývojára: Začíname s virtuálnymi tabuľkami

4. Na stránke vlastností Nového zdroja údajov vyplňte nasledovné stĺpce a potom uložte riadok.

   • Názov. Zadajte názov, ktorý opisuje pre zdroj údajov.
   • Identifikátor 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 systéme Azure, 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: Možnosť systémového dotazu Skip Token ($skiptoken)
     • Vrátiť počet vnorených entít. Vráti celkový počet riadkov 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 $inlinecount. Predvolená hodnota je „false“.
   • Parametre žiadosti. 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. Kliknutím na tlačidlo Reťazec dotazu môžete prepínať medzi hlavičkou a parametrom reťazca dotazu a hodnotou. Pridať je možné maximálne 10 hlavičiek alebo reťazcov dotazu.

     

Pozrite si tiež:

Vytváranie a úprava virtuálnych tabuliek, ktoré obsahujú údaje z externého zdroja údajov

Poznámka

Môžete nás informovať o svojich voľbách jazyka pre dokumentáciu? Absolvujte krátky prieskum. (upozorňujeme, že tento prieskum je v angličtine)

Prieskum bude trvať približne sedem minút. Nezhromažďujú sa žiadne osobné údaje (vyhlásenie o používaní osobných údajov).