OData v4 andmepakkuja konfigureerimine ja head tavad

Selles teemas käsitletakse teenust Dynamics 365 Customer Engagement (on-premises). Vt teemat, milles käsitletakse Power Appsi versiooni: OData v4 andmepakkuja konfiguratsioon

Selles teemas kirjeldatakse, kuidas OData v4 andmepakkujat konfigureerida ning tutvustatakse nõudeid ja soovitatud häid tavasid OData v4 andmepakkuja kasutamiseks, et luua ühendus OData v4 veebiteenusega.

OData v4 andmepakkuja head tavad

• Teie eksemplar nõuab, et kõigil olemitel oleks atribuut ID. Seda ID-d teatakse ainuidentifikaatorina ja selle väärtus peab olema GUID. ID-välju saab väliste väljadega vastendada vaid andmetüübi EDM.Guid abil. Andmetüüpi EDM.Int32 ei saa ainuidentifikaatori andmeväljaga vastendada.

• Nullitavate omadustega OData olemid peavad olema määratud vastavusse virtuaalse olemi vastendatud väljaga. Näiteks OData olemi atribuudi puhul, mille väärtus on Nullable=False, peab olema vastendatud väli, mille atribuudi Välja nõue väärtuseks on seatud Ärivajadus.

• Mitme päringu tulemuste saamiseks, näiteks ruudustikku andmete laadimisel, saab tagastatud andmekogumi suurust kontrollida väliselt andmeallikalt, kasutades päringu parameetrite valimist ja filtreerimist.

• Kui see ei ole juba lubatud, peaksid süsteemi administraatorid lubama lisandmooduli jälgimise. Kui see on lubatud, talletatakse kõik OData lõpp-punkti tõrked lisandmooduli jälgimislogisse. Lisateave: dialoogiboks Süsteemisätted – vahekaart Kohandamine

Andmetüübi vastendamine

Järgmises tabelis on loetletud OData Entity Data Modeli (EDM) andmetüübi vastendused sobivate andmetüüpidega .

OData andmetüüp	Andmetüüp
Edm.Boolean	Kaks suvandit
Edm.DateTime	Kuupäev ja kellaaeg
Edm.DateTimeOffset	Kuupäev ja kellaaeg
Edm.Decimal	Kümnendarv või -vääring
Edm.Double	Ujukomaarv
Edm.Guid	Ainuidentifikaator
Edm.Int32	Täisarv
Edm.Int64	Täisarv
Edm.String	Üks tekstirida või mitu tekstirida

OData EDM-andmetüübid, mille vastendamist virtuaalsete olemitega ei toetata

• Edm.Binary

• Edm.Time

• Edm.Float

• Edm.Single

• Edm.Int16

• Edm.Byte

• Edm.SByte

Andmeallika lisamine OData v4 andmepakkuja abil

Selles protseduuris näidatakse, kuidas kasutada virtuaalse olemi andmeallikana andmepakkuja OData valmislahendust.

1. Avage jaotis Sätete>administreerimine>Virtuaalse olemi andmeallikad.

2. Valige toimingute tööriistaribal Uus .

3. Valige dialoogiboksis Andmepakkuja valimine järgmiste andmeallikate hulgast ja seejärel valige OK.

   • OData v4 andmepakkuja. Teie keskkond sisaldab andmepakkujat OData v4, mida saab kasutada ühenduse loomiseks andmeallikaga, mis toetavad OData v4 avatud standardit.

   • Kohandatud andmepakkuja. Kui olete importinud andmepakkuja lisandmooduli, kuvatakse andmepakkuja siin. Lisateave: Virtuaalsete olemite kasutamise alustamine

4. Täitke uue andmeallika atribuutide lehel järgmised väljad ja salvestage siis kirje.

   • Nimi. Sisestage andmeallikat kirjeldav nimi.

   • Uri. OData andmepakkuja kasutamisel sisestage OData veebiteenuse URI. Näiteks kui kasutate OData pakkujat ühenduse loomiseks Azure’is majutatava veebiteenusega, võib URI välja näha sarnane https://contosodataservice.azurewebsites.net/odata/

   • Aegumine sekunditega. Sisestage veebiteenuse vastuse ootamise sekundite arv enne andmetaotluse ajalõpu saabumist. Näiteks maksimaalselt 30 sekundi määramiseks enne ajalõpu saabumist sisestage 30.

   • Lehitsemise režiim. Valige, kas soovite päringutulemuste lehekülgjaotusena kasutada kliendi- või serveripoolset jaotust. Vaikimisi on määratud kliendipoolne lehekülgjaotus. Serveripoolse lehekülgjaotuse korral kontrollib tulemuste jaotust server, kasutades parameetrit $skiptoken, mis lisatakse päringustringile. Lisateave: Jäta vahele Token System Query Option ($skiptoken)

     • Tekstisisese arvu tagastamine. Annab vastuseks tulemite hulga kõik kirjed. Seda sätet kasutatakse andmete ruudustikku tagastamisel järgmise lehe funktsiooni lubamiseks. Kasutage väärtust „väär” juhul, kui lõpp-punkti ei toeta OData parameetrit $inclinecount. Vaikeväärtus on „väär”.

   • Taotluse parameetrid. Soovi korral saate lisada kohandatud päise või päringustringi parameetrid, mida kasutatakse veebiteenusega OData ühenduse loomiseks (nt välise teenuse autentimisparameetrid). Valige Päringustring päise ning päringustringi parameetri ja väärtuse vaheldumisi aktiveerimiseks. Lisada saab kuni 10 päise- või päringustringi.

   

Vaata ka

Välise andmeallikas andmeid sisaldavate virtuaalsete olemite loomine ja redigeerimine
TechNeti ajaveeb: suhelge väliste süsteemide andmetega uute virtuaalsete olemite abil