OData

Az OData teljes értékű protokollként szerepel, nem pedig saját kézzel feldíszítendő HTTP-ként: a Restorm ismeri a rendszerbeállításait, a műveleteit és a kötegelt formátumát.

Jobb kattintás a projektfában ▸ Hozzáadás ▸ OData-kérés.

OData-lap a lekérdezési beállítások szerkesztőjével — $filter, $select, $top, $count, $orderby — és lent az összeállított URL előnézetével

Konfiguráció

Mező	Szerepe
URL	A szolgáltatás végpontja, az entitáskészlettel együtt
OData verzió	`v2`, `v3`, `v4` vagy `v4.01`
Műveleti típus	`entity-set`, `function`, `action` vagy `batch`
Fejlécek / Paraméterek	Ugyanúgy, mint egy HTTP-kérésnél

Lekérdezési beállítások

Minden rendszerbeállításnak saját mezője van:

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

A $filter mező automatikus kiegészítést kap, amelyet az importált metaadatok táplálnak: a tulajdonságnevek és az operátorok felajánlásra kerülnek.

Függvények és műveletek

A function és az action esetében típusos műveleti paraméterek listája áll rendelkezésre — név, minősített CSDL-típus, nullázhatóság, kötési jelző —, művelet esetén pedig egy külön JSON-törzs.

`$batch` kérések

A batch mód alkérések listáját hordozza, mindegyiket a maga metódusával, URL-jével, fejléceivel, törzsével és esetleg a saját atomicitási csoportjával (change set). Két beállítás:

Formátum: multipart (alapértelmezett) vagy json;
GET-kérések engedélyezése change seten belül: alapértelmezés szerint kikapcsolva; bekapcsolása figyelmeztetést vált ki, mert az OData nem rendelkezik róla.

Metaadatok importálása

Egy $metadata vagy .edmx importálásakor a Restorm entitáskészletenként egy mappát hoz létre a CRUD-kérésekkel, továbbá egy Actions és egy Functions mappát. A kérések előre kitöltve érkeznek az entitástípussal, a tulajdonságokkal, a navigációs tulajdonságokkal és a lekérdezési beállításokkal. Lásd: OData importálása.

Kiszolgálómód

A Restorm szimulációs OData v4 szolgáltatást is képes üzemeltetni: meg kell adni a CSDL metaadat-dokumentumot (amelyet változatlanul szolgál ki) és az adatokat entitáskészletenként. A rendszerbeállítások a kiszolgált adatokra alkalmazásra kerülnek. Lásd: OData-szolgáltatás szimulálása.