Aller au contenu

OData

OData se tretira kao punopravan protokol, a ne kao HTTP koji sami morate ukrasiti: Restorm poznaje njegove sustavske opcije, njegove operacije i njegov skupni format.

Desni klik u stablu ▸ Dodaj ▸ OData zahtjev.

OData kartica s uređivačem opcija upita — $filter, $select, $top, $count, $orderby — i pregledom sastavljenog URL-a na dnu

PoljeUloga
URLUlazna točka usluge, uključujući skup entiteta
OData verzijav2, v3, v4 ili v4.01
Vrsta operacijeentity-set, function, action ili batch
Zaglavlja / ParametriKao kod HTTP zahtjeva

Sustavske opcije imaju svaka svoje polje:

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

Polje $filter ima automatsko dovršavanje koje se puni iz uvezenih metapodataka: nude se nazivi svojstava i operatori.

Za function i action dostupan je popis tipiziranih parametara operacije — naziv, kvalificirani CSDL tip, dopuštenost null-vrijednosti, oznaka vezanosti — a za akciju i namjensko JSON tijelo.

Način batch nosi popis podzahtjeva, svaki sa svojom metodom, URL-om, zaglavljima, tijelom i eventualno svojom skupinom atomičnosti (change set). Dvije opcije:

  • Format: multipart (zadano) ili json;
  • Dopusti GET unutar change seta: prema zadanome isključeno; uključivanje pokreće upozorenje jer OData to ne predviđa.

Uvezite $metadata ili .edmx: Restorm stvara po jednu mapu za svaki skup entiteta s njegovim CRUD zahtjevima, uz mape Actions i Functions. Zahtjevi dolaze unaprijed popunjeni tipom entiteta, svojstvima, navigacijskim svojstvima i opcijama upita. Pogledajte Uvoz OData-e.

Restorm zna posluživati simulacijsku OData v4 uslugu: vi dostavljate CSDL dokument metapodataka (poslužuje se takav kakav jest) i podatke po skupu entiteta. Sustavske se opcije primjenjuju na poslužene podatke. Pogledajte Simuliranje OData usluge.