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ý typ Edm.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.

  1. Přejděte na Nastavení > Správa > Zdroje dat virtuální entity.

  2. Na panelu nástrojů akcí klikněte na tlačítko Nový.

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

      Řádek datového zdroje virtuální tabulky.

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ů).