„OData v4“ duomenų teikėjo konfigūracija, reikalavimai ir geriausia praktika

Šioje temoje aprašoma, kaip konfigūruoti „OData v4“ duomenų teikėją, taip pat aprašomi reikalavimai ir rekomenduojama geriausia „OData v4“ duomenų teikėjo naudojimo norint prisijungti prie „OData v4“ žiniatinklio tarnybos praktika.

„OData v4‟ duomenų teikėjo naudojimo geriausia praktika

• „Microsoft Dataverse“ būtina, kad visos lentelės turėtų ID atributą, šis ID žinomas kaip unikalus identifikatorius ir vertė turi būti vedlys. Galite tik sukurti ID žemėlapio stulpelius į išorės stulpelius su Edm.Guid duomenų tipu. Negalite sukurti žemėlapio Edm.Int32 duomenų tipo su unikaliu identifikatoriumi duomenų tipo stulpeliu „Dataverse“.
• „OData“ lentelės su nesančiomis ypatybėmis turi būti nustatytos, kad atitiktų žemėlapio stulpelį virtualioje lentelėje. Pavyzdžiui, „OData“ lentelės ypatybė su Nullable=False turi būti pažymėta žemėlapio stulpelyje „Dataverse“ Laukelio reikalavimas atributas nustatytas įVerslo būtinas.
• Norėdami nuskaityti kelias užklausas, pavyzdžiui, kai įkeliate duomenis į tinklelį, valdykite iš išorinio duomenų šaltinio pateikto duomenų rinkinio dydį naudodami užklausų pasirinkimo ir filtravimo parametrus.
• Jei priedų sekimas dar neįjungtas, sistemos administratoriai turėtų jį įjungti. Įjungus visos klaidos iš „OData“ galinio punkto yra fiksuojamos priedų sekimo žurnale. Daugiau informacijos: Administratoriaus vadovas: sistemos parametrų dialogo langas – tinkinimo skirtukas
• Norėdami prisijungti prie kitos aplinkos, negalite naudoti "OData v4 Duomenų tiekėjas.

Duomenų tipo susiejimas

Tolesnė lentelė išvardija „OData“ lentelės duomenų modelį (EDM) duomenų tipo žemėlapius su „Dataverse“ duomenų tipais.

„OData“ duomenų tipas	Dataverse duomenų tipas
Edm.Boolean	Dvi parinktys
Edm.DateTime	Data ir laikas
Edm.DateTimeOffset	Data ir laikas
Edm.Decimal	Sveikasis skaičius arba valiuta
Edm.Double	Skaičiai po kablelio
Edm.Guid	Unikalusis identifikatorius
Edm.Int32	Sveikasis skaičius
Edm.Int64	Sveikasis skaičius
Edm.String	Viena teksto eilutė arba kelios teksto eilutės

„OData EDM“ duomenų tipai, kurie nėra palaikomi žemėlapio su virtualiomis lentelėmis

• Edm.Binary
• Edm.Time
• Edm.Float
• Edm.Single
• Edm.Int16
• Edm.Byte
• Edm.SByte

Duomenų šaltinio įtraukimas naudojant „OData v4“ duomenų teikėją

Ši procedūra rodo jums, kaip naudoti nestandartinį „OData“ duomenų tiekėją siekiant naudoti virtualios lentelės duomenų šaltinį.

1. Pasirinkite Parametrai > Administravimas > Virtualių objektų duomenų šaltiniai.

2. Veiksmų įrankių juostoje spustelėkite Naujas.

3. Dialogo lange Duomenų teikėjo pasirinkimas pasirinkite iš toliau pateiktų duomenų šaltinių, o tada spustelėkite Gerai.

   • „OData v4‟ duomenų teikėjas. Dataverse apima „Odata v4“ duomenų teikėją, kurį galima naudoti norint prisijungti prie duomenų šaltinių, palaikančių „OData v4“ atvirąjį standartą.
   • Pasirinktinis duomenų teikėjas. Jei importavote duomenų teikėjo priedą, duomenų teikėjas bus rodomas čia. Daugiau informacijos: Kūrėjo dokumentai: Pradėkite su virtualiomis lentelėmis

4. Ypatybių puslapyje Naujas duomenų šaltinis užbaikite tolesnius stulpelius ir tuomet įrašykite eilutę.

   • Pavadinimas. Įveskite duomenų šaltinį apibūdinantį pavadinimą.
   • URI. Jei naudojate „OData“ duomenų teikėją, įveskite „OData“ žiniatinklio tarnybos URI. Pvz., jei naudojate „OData“ teikėją norėdami prisijungti prie „Azure“ nuomojamos žiniatinklio tarnybos, URI gali būti maždaug toks https://contosodataservice.azurewebsites.net/odata/.
   • Skirtasis laikas sekundėmis. Įveskite, kiek sekundžių laukti atsakymo iš tinklo tarnybos prieš pasibaigiant duomenų užklausos skirtajam laikui. Pavyzdžiui, įveskite 30, jei prieš pasibaigiant skirtajam laikui reikia laukti trisdešimt sekundžių (maksimali trukmė).
   • Puslapių kaitos režimas. Pasirinkite, ar norite naudoti kliento puslapių kaitą, ar serverio puslapių kaitą, kad valdytumėte, kaip numeruojami užklausos rezultatų puslapiai. Numatytoji reikšmė yra kliento puslapių kaita. Nustačius serverio puslapių kaitą, serveris valdo, kaip numeruojami rezultatai puslapiai, naudodamas parametrą $skiptoken, kuris yra įtrauktas į užklausos eilutę. Daugiau informacijos: Atpažinimo ženklų sistemos užklausos parinkties praleidimas ($skiptoken)
     • Pateikti įterptąjį skaičių. Grąžina bendrą eilučių skaičių į rezultatų rinkinį. Šis parametras naudojamas norint įjungti kito puslapio funkciją, kai pateikiate duomenis į tinklelį. Naudokite reikšmę „false“, jei jūsų „OData“ galinis punktas nepalaiko „OData“ parametro $inlinecount. „false“ yra numatytoji reikšmė.
   • Užklausos parametrai. Jei norite, galite į išorinę tarnybą įtraukti pasirinktinės antraštės arba užklausos eilutės parametrų, naudojamų prie „OData“ žiniatinklio tarnybos prisijungti, pavyzdžiui, autentifikavimo parametrų. Spustelėkite Užklausos eilutė, kad perjungtumėte antraštės bei užklausos eilutės parametrą ir reikšmę. Galima įtraukti iki 10 antraštės arba užklausos eilučių.

     

Taip pat žr.

Virtualių objektų, apimančių duomenis iš išorinių duomenų šaltinio, kūrimas ir redagavimas

Pastaba

Ar galite mums pranešti apie dokumentacijos kalbos nuostatas? Atlikite trumpą apklausą. (atkreipkite dėmesį, kad ši apklausa yra anglų kalba)

Apklausą atliksite per maždaug septynias minutes. Asmeniniai duomenys nėra renkami (privatumo nuostatos).