OData

OData je zpracován jako plnohodnotný protokol, a ne jako HTTP, které si musíte sami vyzdobit: Restorm zná jeho systémové možnosti, jeho operace i jeho formát dávek.

Klikněte pravým tlačítkem ve stromu ▸ Přidat ▸ Požadavek OData.

Karta OData s editorem možností dotazu — $filter, $select, $top, $count, $orderby — a náhledem sestavené URL dole

Konfigurace

Pole	Role
URL	Koncový bod služby, včetně sady entit
Verze OData	`v2`, `v3`, `v4` nebo `v4.01`
Typ operace	`entity-set`, `function`, `action` nebo `batch`
Hlavičky / Parametry	Stejně jako u požadavku HTTP

Možnosti dotazu

Systémové možnosti mají každá své pole:

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

Pole $filter má automatické dokončování napájené importovanými metadaty: nabízejí se v něm názvy vlastností a operátory.

Funkce a akce

Pro function a action je k dispozici seznam typovaných parametrů operace — název, kvalifikovaný typ CSDL, nullovatelnost, příznak vazby — a pro akci navíc vyhrazené tělo JSON.

Požadavky `$batch`

Režim batch nese seznam podřízených požadavků, každý se svou metodou, URL, hlavičkami, tělem a případně se svou skupinou atomicity (change set). Dvě možnosti:

Formát: multipart (výchozí) nebo json;
Povolit GET v rámci change setu: ve výchozím stavu vypnuto; jeho zapnutí vyvolá varování, protože OData s tím nepočítá.

Import metadat

Naimportujte $metadata nebo .edmx: Restorm vytvoří jednu složku pro každou sadu entit s jejími požadavky CRUD, plus složky Actions a Functions. Požadavky přijdou předvyplněné typem entity, vlastnostmi, navigačními vlastnostmi a možnostmi dotazu. Viz Import metadat OData.

Režim serveru

Restorm umí hostovat simulační službu OData v4: dodáte dokument metadat CSDL (obsluhovaný tak, jak je) a data po jednotlivých sadách entit. Systémové možnosti se na obsluhovaná data aplikují. Viz Simulace služby OData.