Konfigurace zprostředkovatele dat OData v4, požadavky a osvědčené postupy
Toto téma popisuje, jak konfigurovat zprostředkovatele dat OData v4, a uvádí také požadavky a doporučené osvědčené postupy pro použití zprostředkovatele dat v4 OData pro připojení k webové službě OData v4.
Osvědčené postupy pro zprostředkovatele dat OData v4
- Microsoft Dataverse vyžaduje, aby všechny tabulky měly atribut ID. Tento ID se označuje jako jedinečný identifikátor a hodnota musí být identifikátor GUID. Sloupce ID můžete mapovat pouze na externí sloupce s datovým typem
Edm.Guid
. Ve službě Dataverse nelze datový typEdm.Int32
mapovat na sloupec datového typu Jedineční identifikátor. - Tabulky OData s vlastnostmi s možnou hodnotou Null musí být nastaveny tak, aby odpovídaly namapovanému sloupci ve virtuální tabulce. Například vlastnost tabulky OData s hodnotou Nulllable=False musí mít namapovaný sloupec v atributu Dataverse Požadavek na pole nastaven na Požadováno podnikem.
- Pro načtení více dotazů, například při načítání dat do mřížky, kontrolujte velikost datové sady vrácené z externího zdroje dat použitím parametrů dotazu výběru a filtru.
- Pokud to již není povoleno, měli by správci systému povolit trasování modulů plug-in. Po povolení budou všechny chyby z koncového bodu OData zachyceny v protokolu trasování modulu plug-in. Další informace: Příručka správce: Dialogové okno Nastavení systému – karta Vlastní nastavení.
- Poskytovatele dat OData v4 nelze použít k připojení k jinému prostředí.
Mapování datového typu
V následující tabulce jsou uvedena mapování datového typu tabulky OData Data Model (EDM) s datovými typy Dataverse.
Datový typ OData | Datový typ Dataverse |
---|---|
Edm.Boolean |
Dvě možnosti |
Edm.DateTime |
Datum a čas |
Edm.DateTimeOffset |
Datum a čas |
Edm.Decimal |
Desetinné číslo nebo měna |
Edm.Double |
Číslo s plovoucí desetinnou čárkou |
Edm.Guid |
Jedinečný identifikátor |
Edm.Int32 |
Celé číslo |
Edm.Int64 |
Celé číslo |
Edm.String |
Jeden řádek textu nebo více řádků textu |
Datové typy OData EDM, které nejsou podporovány pro mapování s virtuálními tabulkami
Edm.Binary
Edm.Time
Edm.Float
Edm.Single
Edm.Int16
Edm.Byte
Edm.SByte
Přidání zdroje dat pomocí zprostředkovatele dat OData v4
Tento postup ukazuje, jak použít předpřipraveného zprostředkovatele dat OData jako zdroj dat virtuální tabulky.
Přejděte na Nastavení > Správa > Zdroje dat virtuální entity.
Na panelu nástrojů akcí klikněte na tlačítko Nový.
V dialogu Vybrat zprostředkovatele dat vyberte některý z následujících zdrojů dat a klikněte na tlačítko OK.
- Zprostředkovatel dat OData v4. Dataverse obsahuje zprostředkovatele dat Odata v4, kterého lze použít pro připojení ke zdrojům dat, jež podporují otevřený standard OData v4.
- Vlastní zprostředkovatel dat. Pokud jste importovali modul plug-in zprostředkovatele dat, zprostředkovatel dat se zobrazí zde. Další informace: Dokumentace pro vývojáře: Začínáme s virtuálními tabulkami
Na stránce vlastnosti Nový zdroj dat vyplňte následující sloupce a potom uložte řádek.
- Name (Název): Zadejte název, který popisuje zdroj dat.
- Identifikátor URI. Pokud používáte zprostředkovatele dat OData, zadejte identifikátor URI webové služby OData. Pokud například používáte zprostředkovatele OData pro připojení k webové službě hostované na platformě Azure, může identifikátor URI vypadat podobně jako
https://contosodataservice.azurewebsites.net/odata/
. - Časový limit v sekundách. Zadejte počet sekund při čekání na odpověď z webové služby před vypršením časového limitu žádosti o data. Zadejte například 30, aby se čekalo maximálně třicet sekund před vypršením časového limitu.
- Režim stránkování. Vyberte, zda chcete použít stránkování na straně klienta nebo na straně serveru pro určení toho, jak jsou stránkovány výsledky dotazu. Výchozí hodnota je stránkování na straně klienta. Při stránkování na straně serveru bude server určovat, jak jsou výsledky stránkovány, pomocí parametru $skiptoken, který je přidán do řetězce dotazu. Další informace: Možnost systémového dotazu Přeskočit token ($skiptoken)
- Vrátit počet vložených entit. Vrátí celkový počet řádků v sadě výsledků dotazu. Toto nastavení se používá, chcete-li povolit funkci další stránky při vrácení dat do mřížky. Použijte hodnotu false, pokud koncový bod OData nepodporuje parametr OData $inlinecount. Výchozí hodnota je false.
- Parametry požadavku. Volitelně můžete přidat vlastní parametry řetězce hlavičky nebo dotazu používané pro připojení k webové službě OData jako například parametry ověřování k externí službě. Klikněte na tlačítko Řetězec dotazu pro přepnutí mezi parametrem řetězce hlavičky a dotazu a hodnotou. Lze přidat až 10 řetězců hlavičky nebo dotazu.
Viz také
Vytvoření a úprava virtuálních tabulek, které obsahují data z externího zdroje dat
Poznámka
Můžete nám sdělit, jaké máte jazykové preference pro dokumentaci? Zúčastněte se krátkého průzkumu. (upozorňujeme, že tento průzkum je v angličtině)
Průzkum bude trvat asi sedm minut. Nejsou shromažďovány žádné osobní údaje (prohlášení o zásadách ochrany osobních údajů).