Lue englanniksi

Jaa


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.

  1. Siirry kohtaan asetukset>hallinto>näennäisentiteettitietolähteet.

  2. Valitse Toiminnot-työkalurivillä Uusi.

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

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

    Virtuaalisen entiteetin tietolähteen tietue

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