Перейти до вмісту

OData

OData розглядається як повноцінний протокол, а не як HTTP, який доводиться прикрашати власноруч: Restorm знає його системні параметри, його операції та його пакетний формат.

Клацніть правою кнопкою в дереві ▸ Додати ▸ Запит OData.

Вкладка OData з редактором параметрів запиту — $filter, $select, $top, $count, $orderby — і попереднім переглядом зібраного URL унизу

ПолеРоль
URLТочка входу служби разом із набором сутностей
Версія ODatav2, v3, v4 або v4.01
Тип операціїentity-set, function, action або batch
Заголовки / ПараметриТак само, як для запиту HTTP

Кожен системний параметр має власне поле:

$filter · $select · $top · $skip · $count · $expand · $orderby · $search · $format (json, xml, atom) · $apply (агрегування, v4.01).

Поле $filter має автодоповнення, яке живиться імпортованими метаданими: пропонуються назви властивостей та оператори.

Для function і action доступний перелік типізованих параметрів операції — ім’я, кваліфікований тип CSDL, допустимість порожнього значення, ознака прив’язки — а для дії ще й окреме тіло JSON.

Режим batch містить перелік підзапитів, кожен зі своїм методом, URL, заголовками, тілом і, за потреби, зі своєю групою атомарності (change set). Два налаштування:

  • Формат: multipart (типово) або json;
  • Дозволити GET усередині change set: типово вимкнено; вмикання спричиняє попередження, бо OData цього не передбачає.

Імпортуйте $metadata або .edmx: Restorm створить по теці на кожен набір сутностей із його запитами CRUD, а також теки Actions і Functions. Запити надходять заздалегідь заповненими — із типом сутності, властивостями, навігаційними властивостями та параметрами запиту. Див. Імпорт OData.

Restorm уміє розміщувати службу симуляції OData v4: ви надаєте документ метаданих CSDL (він видається як є) і дані для кожного набору сутностей. Системні параметри застосовуються до даних, які видаються. Див. Імітація служби OData.