OData v4 andmepakkuja konfigureerimine, nõuded ja head tavad

Kehtib rakenduses Dynamics 365 (veebiversioon), versioon 9.0

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

  • Dynamics 365 nõuab, et kõigil olemitel oleks ID-atribuut, mida nimetatakse ainuidentifikaatoriks 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 Dynamics 365-is ainuidentifikaatori andmeväljaga vastendada.

  • Nullitavate omadustega OData olemid peavad olema määratud vastavusse virtuaalse olemi vastendatud väljaga. Näiteks peab OData olemi atribuudil nullitav = väär Dynamics 365-i välja nõutavuse atribuudis olema vastendatud välja väärtuseks Töö (nõutav).

  • 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 Dynamics 365 Customer Engagementi andmetüüpidega.

OData andmetüüp Dynamics 365-i 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. Valige Sätted > Haldus > Virtuaalse olemi andmeallikad.

  2. Klõpsake tööriistaribal Toimingud valikut Uus.

  3. Valige dialoogiboksist Valige andmepakkuja järgmised andmeallikad ja klõpsake siis nuppu OK.

    • OData v4 andmepakkuja. Dynamics 365 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 pakkujat OData Azure’is majutatava veebiteenusega ühenduse loomiseks, võib URI sarnaneda aadressile http://contosodataservice.azurewebsites.net/odata/.

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

    • Lehekülgjaotuse 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: Vahele jätva sõnega süsteemi päringuvalik ($skiptoken)

      • Tagasta reasisene arv. 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”.
    • Päringu parameetrid. Soovi korral saate lisada kohandatud päise või päringustringi parameetrid, mida kasutatakse veebiteenusega OData ühenduse loomiseks (nt välise teenuse autentimisparameetrid). Klõpsake valikut Päringustring päise ja päringustringi parameetri ning väärtuse vahetamiseks. Lisada saab kuni 10 päise- või päringustringi.

    Virtuaalse olemi andmeallika kirje

Vt ka

Välisest andmeallikast pärinevaid andmeid sisaldavate virtuaalsete olemite loomine ja redigeerimine
TechNeti ajaveeb: Välistest süsteemidest pärinevate andmetega suhtlemine, kasutades uusi virtuaalseid olemeid