Примеры использования
Продемонстрируем все вышесказанное на небольших примерах.
подробнее
Подробнее познакомиться с обращением к данным информационной базы через REST-интерфейс можно в демонстрационной конфигурации «Примеры работы», которая прилагается к книге.
Прежде всего, чтобы прикладное решение стало доступно через REST-интерфейс, опубликуем интерфейс OData для этого решения на веб-сервере. Для этого в диалоге публикации информационной базы на веб-сервере должен быть установлен флажок Публиковать стандартный интерфейс OData (рис. 1.19).
Рис. 1.19. Публикация конфигурации на веб-сервере
В нашем примере публикация выполняется на локальном компьютере (на сервере «localhost») в каталог REST.
Затем, для того чтобы объекты конфигурации стали доступны через стандартный интерфейс OData, необходимо разрешить это с помощью метода глобального контекста УстановитьСоставСтандартногоИнтерфейсаOData().
В реальных примерах для этого нужно написать и один раз выполнить обработку на встроенном языке, которая укажет, данные каких объектов конфигурации будут доступны через REST-интерфейс. Но в нашей тренировочной базе мы для простоты с помощью команды сделаем доступными справочники Поставщики, Должности, Сотрудники и Товары, документ ПоступлениеТоваров и регистр сведений ЦеныТоваров (листинг 1.80).
Листинг 1.80. Установка списка объектов, доступных через стандартный интерфейс OData
&НаСервереБезКонтекста
Процедура РазрешитьДоступODATA()
МДанные = Новый Массив();
МДанные.Добавить("Справочник.Сотрудники");
МДанные.Добавить("Справочник.Должности");
МДанные.Добавить("Справочник.Поставщики");
МДанные.Добавить("Документ.ПоступлениеТоваров");
МДанные.Добавить("РегистрСведений.ЦеныТоваров");
МДанные.Добавить("Справочник.Товары");
УстановитьСоставСтандартногоИнтерфейсаOData(МДанные);
КонецПроцедуры
Имена нужных объектов конфигурации мы добавляем в массив и передаем его в метод УстановитьСоставСтандартногоИнтерфейсаOData().
Следует иметь в виду, что REST-интерфейс по умолчанию возвращает данные в формате atom-xml. Это «наследие» стандарта. По современным же представлениям приоритетным форматом является JSON. Поэтому во всех примерах в списке параметров запроса мы укажем, что данные должны быть возвращены именно в этом формате – $format=json.
