OData

OData wordt als een volwaardig protocol behandeld en niet als HTTP dat u zelf mag opsieren: Restorm kent de systeemopties, de operaties en het batchformaat.

Rechtsklik in de boom ▸ Toevoegen ▸ OData-verzoek.

Configuratie

Veld	Rol
URL	Het eindpunt van de service, inclusief de entiteitsverzameling
OData-versie	v2, v3, v4 of v4.01
Operatietype	entity-set, function, action of batch
Headers / Parameters	Net als bij een HTTP-verzoek

Queryopties

Elke systeemoptie heeft een eigen veld:

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

Het veld $filter heeft automatisch aanvullen op basis van de geïmporteerde metadata: de namen van eigenschappen en de operatoren worden voorgesteld.

Functies en acties

Voor function en action is er een lijst met getypeerde operatieparameters — naam, gekwalificeerd CSDL-type, nullability, bindingsindicator — en voor een actie een aparte JSON-body.

$batch-verzoeken

De modus batch bevat een lijst met subverzoeken, elk met zijn methode, URL, headers, body en eventueel zijn atomiciteitsgroep (change set). Er zijn twee opties:

• Formaat: multipart (standaard) of json;
• GET’s toestaan in een change set: standaard uitgeschakeld; als u het aanzet, verschijnt er een waarschuwing, want OData voorziet daar niet in.

De metadata importeren

Importeer een $metadata of een .edmx: Restorm maakt één map per entiteitsverzameling met de bijbehorende CRUD-verzoeken, plus de mappen Actions en Functions. De verzoeken komen voorgevuld binnen met het entiteitstype, de eigenschappen, de navigatie-eigenschappen en de queryopties. Zie OData importeren.

Servermodus

Restorm kan een OData v4-mockservice hosten: u levert het CSDL-metadatadocument (dat ongewijzigd wordt aangeboden) en de gegevens per entiteitsverzameling. De systeemopties worden toegepast op de gegevens die worden aangeboden. Zie Een OData-service mocken.