OData

OData est traité comme un protocole à part entière, et non comme du HTTP à décorer soi-même : Restorm connaît ses options système, ses opérations et son format de lot.

Clic droit dans l’arbre ▸ Ajouter ▸ Requête OData.

Configuration

Champ	Rôle
URL	Le point d’entrée du service, jeu d’entités compris
Version OData	v2, v3, v4 ou v4.01
Type d’opération	entity-set, function, action ou batch
En-têtes / Paramètres	Comme pour une requête HTTP

Options de requête

Les options système ont chacune leur champ :

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

Le champ $filter bénéficie d’une autocomplétion alimentée par les métadonnées importées : les noms de propriétés et les opérateurs sont proposés.

Fonctions et actions

Pour function et action, une liste de paramètres d’opération typés est disponible — nom, type CSDL qualifié, nullabilité, indicateur de liaison — et, pour une action, un corps JSON dédié.

Requêtes $batch

Le mode batch porte une liste de sous-requêtes, chacune avec sa méthode, son URL, ses en-têtes, son corps, et éventuellement son groupe d’atomicité (change set). Deux options :

• Format : multipart (par défaut) ou json ;
• Autoriser les GET dans un change set : désactivé par défaut ; l’activer déclenche un avertissement, car OData ne le prévoit pas.

Importer les métadonnées

Importez un $metadata ou un .edmx : Restorm crée un dossier par jeu d’entités avec ses requêtes CRUD, plus des dossiers Actions et Functions. Les requêtes arrivent pré-remplies avec le type d’entité, les propriétés, les propriétés de navigation et les options de requête. Voir Importer OData.

Mode serveur

Restorm sait héberger un service OData v4 de simulation : vous fournissez le document CSDL de métadonnées (servi tel quel) et les données par jeu d’entités. Les options système sont appliquées aux données servies. Voir Simuler un service OData.