OData v4 -tietopalvelun määrittäminen ja parhaat käytännöt
Tässä ohjeaiheessa käsitellään Dynamics 365 Customer Engagement (on-premises) -sovellusta. Ohjeaiheen Power Apps -versio on täällä: OData v4 -tietojen tarjoajan määritys
Tässä ohjeaiheessa kerrotaan, miten OData v4 -tietojen tarjoaja ja OData v4 -tietojen tarjoajan vaatimukset ja parhaat käytännöt määritetään, kun OData v4 -tietojen tarjoajaa käytetään muodostettaessa yhteys OData v4 -verkkopalveluun.
OData v4 -tietojen tarjoajan parhaat käytännöt
Esiintymä edellyttää, että kaikilla entiteeteillä on ID-määrite. Tämä ID on yksilöivä tunniste, ja sen arvon on oltava guid. Voit yhdistää ID-kentät vain sellaisiin ulkoisiin kenttiin, joiden tietotyyppi on EDM.Guid. Et voi liittää EDM.Int32-tietotyyppiä uniqueidentifer-tietotyypin kenttään.
OData-entiteetit, joilla on tyhjä arvo -ominaisuuksia, on määritettävä vastaamaan virtuaalisen entiteetin yhdistettyä kenttää. Esimerkiksi OData-entiteetin ominaisuuden, jonka tyhjä arvo = epätosi, on oltava yhdistetty kenttä ja Kenttävaatimus-määritteeksi on annettava Pakollinen.
Voit hakea useita kyselyjä esimerkiksi ladatessasi tietoja ruudukkoon, jos ohjaat ulkoisesta tietolähteestä palautettavan tietojoukon kokoa käyttämällä kyselyparametrien valintaa ja suodatusta.
Jos tämä ei ole käytössä, järjestelmänvalvoja voi ottaa laajennuksen seurannan käyttöön. Kun tämä on käytössä, kaikki OData-päätepisteen virheet kerätään laajennuksen seurantalokiin. Lisätietoja: Järjestelmäasetukset-valintaikkuna – Mukauttaminen-välilehti
Tietotyyppien yhdistämismääritys
Seuraavassa taulukossa ovat OData Entity Data Model (EDM) -tietotyyppien yhdistämismääritykset ja asianmukainen tietotyyppi.
| OData-tietotyyppi | Tietotyyppi |
|---|---|
| Edm.Boolean | Kaksi asetusta |
| Edm.DateTime | Päivämäärä ja aika |
| Edm.DateTimeOffset | Päivämäärä ja aika |
| Edm.Decimal | Desimaaliluku tai valuutta |
| Edm.Double | Liukuluku |
| Edm.Guid | Yksilöllinen tunnus |
| Edm.Int32 | Kokonaisluku |
| Edm.Int64 | Kokonaisluku |
| Edm.String | Yksi tekstirivi tai useita tekstirivejä |
OData EDM -tietotyypit, joita ei tueta virtuaalisten entiteettien vastaavuusmäärityksissä
Edm.Binary
Edm.Time
Edm.Float
Edm.Single
Edm.Int16
Edm.Byte
Edm.SByte
Tietolähteen lisääminen OData v4 -tietojen tarjoajan avulla
Tässä toimintosarjassa on esitetty, miten voit käyttää virtuaalisen entiteetin tietolähteenä valmista OData-tietojen tarjoajaa.
Siirry kohtaan asetukset>hallinto>näennäisentiteettitietolähteet.
Valitse Toiminnot-työkalurivillä Uusi.
Valitse seuraavista tietolähteistä Valitse tietopalvelu-valintaikkunassa ja valitse sitten OK.
OData v4 -tietojen tarjoaja. Ympäristösi sisältää Odata-v4 -tietojen toimittajan, jonka avulla voidaan muodostaa yhteys tietolähteiden tietoihin, jotka tukevat OData v4 avoin standardia.
Mukautettujen tietojen tarjoaja. Jos olet tuonut tietopalvelulaajennuksen, tietopalvelu tulee näkyviin tähän. Lisätietoja: Virtuaalientiteettien käytön aloittaminen
Uusi tietolähde ominaisuudet -sivulla Suorita seuraavat kentät ja tallenna tietue.
Nimi. Kirjoita tietolähteen kuvaava nimi.
Uri. Jos käytössäsi on OData-tietojen tarjoaja, kirjoita OData-verkkopalvelun uri-arvo. Esimerkiksi käytettäessä OData-palvelua muodostamaan yhteyden azuren isännöimään WWW-palveluun, URI-osoite voi näyttää tällaiselta:
https://contosodataservice.azurewebsites.net/odata/Aikakatkaisu sekunteina. Anna verkkopalvelun vastauksen odotusaika sekunteina. Tämän jälkeen tietopyyntö aikakatkaistaan. Voit esimerkiksi antaa arvoksi 30, jolloin odotusaika on enintään 30 sekuntia ennen aikakatkaisua.
Sivutustila. Määritä, käytetäänkö kyselyn tulosten sivutuksessa asiakas- vai palvelinpuolen sivutusta. Oletusarvo on asiakaspuolen sivutus. Palvelinpuolen sivutuksessa palvelin ohjaa tulosten sivutusta $skiptoken-parametrin avulla. Parametri lisätään kyselymerkkijonoon. Lisätietoja: Tunnusjärjestelmän kyselyvaihtoehdon ohittaminen ($skiptoken)
- Palauta sidottu määrä. Palauttaa tulosjoukon tietueiden kokonaismäärän. Tätä asetusta käytetään, kun seuraava sivu -toiminto otetaan käyttöön palautettaessa tietoja ruudukkoon. Käytä epätosi-arvoa, jos OData-päätepiste ei tue ODatan $inclinecount-parametria. Oletusarvo on epätosi.
Pyyntöparametrit. Vaihtoehtoisesti voit lisätä oman otsikon tai kyselyn kyselymerkkijonon parametrit, joiden avulla voidaan muodostaa yhteys OData verkkopalveluun, kuten todennusparametrit ulkoisen palveluun. Valitse että kyselymerkkijonon avulla tila voidaan vaihdella ylätunniste- ja kyselyn kyselymerkkijonon parametrin ja arvo välillä. Enintään 10 ylätunniste- tai kyselymerkkijonoa voidaan lisätä.
Katso myös
Virtuaalisten entiteettien, jotka sisältävät ulkoisen tietolähteen tietoja, luominen ja muokkaaminen
TechNet-blogi: Vuorovaikutus ulkoisten järjestelmien tietojen kanssa uusien virtuaalisten entiteettien avulla