OData

OData on Restormissa täysivaltainen protokolla eikä HTTP, jota pitäisi koristella itse: Restorm tuntee sen järjestelmävalinnat, operaatiot ja erämuodon.

Napsauta projektipuuta hiiren oikealla painikkeella ▸ Lisää ▸ OData-pyyntö.

Kokoonpano

Kenttä	Tehtävä
URL	Palvelun päätepiste entiteettijoukko mukaan lukien
OData-versio	v2, v3, v4 tai v4.01
Toiminnon tyyppi	entity-set, function, action tai batch
Otsakkeet / Parametrit	Kuten HTTP-pyynnössä

Kyselyvalinnat

Jokaisella järjestelmävalinnalla on oma kenttänsä:

$filter · $select · $top · $skip · $count · $expand · $orderby · $search · $format (json, xml, atom) · $apply (aggregointi, v4.01).

$filter-kentässä on automaattinen täydennys, jonka lähteenä ovat tuodut metatiedot: se ehdottaa ominaisuuksien nimiä ja operaattoreita.

Funktiot ja toiminnot

Tyypeille function ja action on käytettävissä luettelo tyypitettyjä operaatioparametreja — nimi, täydellinen CSDL-tyyppi, nollattavuus ja sidosmerkintä — ja toiminnolle lisäksi oma JSON-sisältö.

$batch-pyynnöt

batch-tila sisältää luettelon alipyyntöjä, joista jokaisella on oma metodinsa, URL-osoitteensa, otsakkeensa ja sisältönsä sekä mahdollisesti oma atomisuusryhmänsä (change set). Kaksi valintaa:

• Muoto: multipart (oletus) tai json
• Salli GET-pyynnöt change setissä: pois käytöstä oletuksena; sen käyttöönotto tuottaa varoituksen, koska OData ei sitä salli

Metatietojen tuonti

Tuo $metadata tai .edmx: Restorm luo yhden kansion entiteettijoukkoa kohti ja sen CRUD-pyynnöt sekä kansiot Actions ja Functions. Pyynnöt saapuvat valmiiksi täytettyinä entiteettityypillä, ominaisuuksilla, navigointiominaisuuksilla ja kyselyvalinnoilla. Katso OData-metatietojen tuonti.

Palvelintila

Restorm osaa isännöidä OData v4 -simulointipalvelua: annat CSDL-metatietoasiakirjan (jota palvellaan sellaisenaan) ja datan entiteettijoukoittain. Järjestelmävalinnat sovelletaan palveltuun dataan. Katso OData-palvelun simulointi.