OData

OData è trattato come un protocollo a tutti gli effetti, e non come HTTP da decorare a mano: Restorm conosce le sue opzioni di sistema, le sue operazioni e il suo formato di batch.

Clic destro nell’albero ▸ Aggiungi ▸ Richiesta OData.

Configurazione

Campo	Ruolo
URL	Il punto di ingresso del servizio, insieme di entità compreso
Versione OData	v2, v3, v4 o v4.01
Tipo di operazione	entity-set, function, action o batch
Header / Parametri	Come per una richiesta HTTP

Opzioni di query

Le opzioni di sistema hanno ciascuna il proprio campo:

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

Il campo $filter beneficia di un completamento automatico alimentato dai metadati importati: vengono proposti i nomi delle proprietà e gli operatori.

Funzioni e azioni

Per function e action è disponibile un elenco di parametri di operazione tipizzati — nome, tipo CSDL qualificato, nullabilità, indicatore di associazione — e, per un’azione, un corpo JSON dedicato.

Richieste $batch

La modalità batch porta un elenco di sottorichieste, ciascuna con il proprio metodo, il proprio URL, i propri header, il proprio corpo ed eventualmente il proprio gruppo di atomicità (change set). Due opzioni:

• Formato: multipart (predefinito) o json;
• Consenti i GET in un change set: disattivato per impostazione predefinita; attivarlo genera un avviso, perché OData non lo prevede.

Importare i metadati

Importando un $metadata o un .edmx, Restorm crea una cartella per insieme di entità con le relative richieste CRUD, più cartelle Actions e Functions. Le richieste arrivano precompilate con il tipo di entità, le proprietà, le proprietà di navigazione e le opzioni di query. Si veda Importare OData.

Modalità server

Restorm sa ospitare un servizio OData v4 di simulazione: si fornisce il documento CSDL dei metadati (servito così com’è) e i dati per insieme di entità. Le opzioni di sistema vengono applicate ai dati serviti. Si veda Simulare un servizio OData.