177 lines
16 KiB
Markdown
177 lines
16 KiB
Markdown
# Задание к занятию "HTTP-сервисы и SOAP-сервисы"
|
||
|
||
В качестве результата прислать полную конфигурацию, полученную из всех трех задач - одним файлом.
|
||
|
||
## Задание 1. Создание схемы данных
|
||
|
||
Улучшение взаимодействия с сервисом бронирования отелей из занятия 7.1
|
||
Как видно из заданий 2 и 3 домашней работы 7.1 - и в варианте JSON и в варианте XML используется одна и та же логическая структура данных:
|
||
|
||
* Фамилия и имя
|
||
* Дата заезда
|
||
* Тип номера
|
||
* Признак наличия душа
|
||
* Признаки приемов пищи (завтрак/обед/ужин), которые включены в стоимость номера
|
||
|
||
Таким образом, можно структурировать эту модель данных и сделать ее более формальной и удобной для заполнения.
|
||
|
||
### Описание задачи
|
||
|
||
Необходимо создать ПакетXDTO с пространством имен "https://netology.ru/1c/data-models/hotels/v1" и описать в нем структуру типов указаннной модели данных.
|
||
|
||
```
|
||
Бронирование
|
||
Гость: Множество элементов типа "Гость"
|
||
|
||
Гость
|
||
Имя гостя: Строка
|
||
Дата заезда: Дата
|
||
Комната: Комната
|
||
Тип комнаты: перечисление Одиночный/Двойной
|
||
С душем: Булево
|
||
Питание: Питание
|
||
Завтрак: Булево
|
||
Обед: Булево
|
||
Ужин: Булево
|
||
```
|
||
|
||
|
||
### Требования к результату
|
||
|
||
Выгрузка информационной базы (.dt) с конфигурацией, в пакетах XDTO которой находится пакет "БронированиеОтеля" с указанной структурой.
|
||
ПакетXDTO должен позволять сформировать XML требуемой структуры, с правильным именованием узлов и их типом (атрибут, текст, элемент)
|
||
|
||
### Процесс выполнения
|
||
|
||
* Создайте чистую конфигурацию
|
||
* Создайте ПакетXDTO и назовите его БронированиеОтеля. Задайте пространство имен "https://netology.ru/1c/data-models/hotels/v1"
|
||
* Добавьте (из подменю кнопки Добавить) ТипОбъекта и назовите его "Бронирование"
|
||
* Повторите для типов-объектов Гость, Комната и Питание
|
||
* В типе "Бронирование" создайте свойство "Гость" (правой кнопкой по типу, подменю Добавить/Свойство) и задайте ему тип "Гость" из этого же пространства имен. Обратите внимание, для задания значения свойства нужно сначала "включить" изменения свойства, нажав на кнопку с зеленой галочкой. Наше пространство имен будет в самом низу списка доступных для выбора типов.
|
||
* Далее, для свойства Гость задайте "ЛокальноеИмя" равное "guest".
|
||
* Также, свойству Гость задайте "МаксимальноеКоличество" равное -1 (неограничено) Это превратит свойство Гость в списковое и даст возможность указать несколько гостей в бронировании.
|
||
* В **типе объекта** "Гость" добавьте свойство "Имя", укажите ему тип "string (http://www.w3.org/2001/XMLSchema)", форму "Атрибут" и локальное имя "name"
|
||
* Добавьте гостю свойство "ДатаЗаезда" с типом "date (http://www.w3.org/2001/XMLSchema)" формой Атрибут и локальным именем "arrives"
|
||
* Добавьте гостю свойство "Комната" с типом "Комната (https://netology.ru/1c/data-models/hotels/v1)" и свойство "Питание" с типом "Питание (https://netology.ru/1c/data-models/hotels/v1)" Не забудьте настроить локальные имена "room" и "meals" соответственно.
|
||
* В **типе объекта** "Комната" создайте свойства "ТипНомера" и "СДушем". Не забудьте указать локальные имена, т.к. в требуемой схеме они отличаются от названия свойств. Тип - string и boolean соответственно
|
||
* В **типе объекта** "Питание" создайте три свойства с типом boolean, назовите Завтрак, Обед, Ужин, задайте локальные имена "breakfast", "dinner", "supper"
|
||
|
||
Обратите внимание, что задавать локальные имена необязательно. В приниципе, можно было создать схему с англоязычными названиями свойств и типов. В общем и целом, пакеты XDTO часто создают сразу именуя свойства и типы так, как требуется в результирующем XML, но в учебных целях мы рассмотрим ситуацию, когда имена свойств в модели не совпадают с тем, что будет записываться в поток XML. Кроме того, если бы модель имела англоязычные термины, тогда с ней было бы не так удобно работать из языка 1С, постоянно переключая раскладку.
|
||
|
||
## Задание 2 - сервис бронирования в формате SOAP
|
||
|
||
### Описание задачи
|
||
|
||
Конфигурация, принимающая заявки на бронирование по SOAP-протоколу
|
||
|
||
### Требования к результату
|
||
|
||
Выгрузка информационной базы (.dt) с конфигурацией, содержащей веб-сервис и логику сохранения поступившей заявки в базу данных.
|
||
|
||
### Процесс выполнения
|
||
|
||
* Создайте метаданные для приема заявок о бронировании:
|
||
* Справочник Гости
|
||
* Документ "Бронирование"
|
||
* Перечисление "ТипКомнаты"
|
||
* Регистр сведений "Бронирования" подчиненный регистратору "Документ.Бронирование" с измерением Гость и ресурсами "ТипКомнаты", "Душ", "Завтрак", "Обед", "Ужин", "ДатаЗаселения"
|
||
|
||
* Наполните метаданные документа "Бронирование":
|
||
* Табличная часть "Гости" с реквизитами "Гость", "ТипКомнаты", "Душ", "Завтрак", "Обед", "Ужин", "ДатаЗаселения"
|
||
* Напишите алгоритм проведения документа "Бронирование". При проведении документ должен формировать движения в регистре сведений "Бронирования"
|
||
|
||
* Создайте веб-сервис, принимающий заявки от внешних систем по заданному формату
|
||
|
||
* Добавьте в ветку Веб-Сервисы корня метаданных новый веб-сервис "Бронирования", откройте окно редактора веб-сервиса.
|
||
* Укажите пространство имен сервиса (на закладке "прочие") "https://netology.ru/1c/services/hotels/v1" и пакет XDTO "БронированиеОтеля" из задания 1
|
||
* Имя файла публикации (на закладке "прочие") можно указать произвольно, но чтобы оно было информативным. Например, "booking.1cws"
|
||
* На закладке "Операции" редактора веб-сервиса создайте новую операцию и назовите ее "Booking"
|
||
* Добавьте к операции "Booking" параметр операции, назовите его "bookData" и назначьте ему тип "Бронирование" из пространства имен "https://netology.ru/1c/data-models/hotels/v1"
|
||
* Далее, для самой операции Booking нажмите в свойстве "Имя процедуры" кнопку с лупой. Система создаст в модуле веб-сервиса функцию "Booking" с параметром "bookData". Теперь, когда внешняя система будет вызывать нашу систему - именно в этот метод попадет управление, когда надо будет сформировать запись о бронировании. В качестве значения параметра bookData будет передан `ОбъектXDTO` соответствующий типу "Бронирование" из нашего пространства имен.
|
||
* Переименуйте параметр `bookData` в `ДанныеБронирования` для дальнейшего удобства.
|
||
* Сформируйте алгоритм создания и проведения документа "Бронирование" по данным, полученным от внешней системы. В качестве шаблона используйте следующий код:
|
||
|
||
```bsl
|
||
ДокументБронирование = Документы.Бронирование.СоздатьДокумент();
|
||
ДокументБронирование.Дата = ТекущаяДатаСеанса();
|
||
Для Каждого Гость Из ДанныеБронирования.Гость Цикл
|
||
|
||
ГостьСсылка = НайтиИлиСоздатьГостя(Гость.Имя);
|
||
СтрокаТЧ = ДокументБронирование.Гости.Добавить();
|
||
СтрокаТЧ.Гость = ГостьСсылка;
|
||
СтрокаТЧ.ДатаЗаселения = Гость.ДатаЗаезда;
|
||
СтрокаТЧ.Душ = Гость.Комната.СДушем;
|
||
Если Гость.Комната.ТипКомнаты = "double" Тогда
|
||
СтрокаТЧ.ТипКомнаты = Перечисления.ТипыНомеров.Двойной;
|
||
Иначе
|
||
СтрокаТЧ.ТипКомнаты = Перечисления.ТипыНомеров.Одиночный;
|
||
КонецЕсли;
|
||
|
||
СтрокаТЧ.Завтрак = Гость.Питание.Завтрак;
|
||
// и так далеее
|
||
|
||
КонецЦикла;
|
||
|
||
Результат = "ОК";
|
||
Попытка
|
||
ДокументБронирование.Записать(РежимЗаписиДокумента.Проведение);
|
||
Исключение
|
||
Результат = ОписаниеОшибки();
|
||
ЗаписьЖурналаРегистрации("Бронирование", УровеньЖурналаРегистрации.Ошибка,,,
|
||
Результат);
|
||
КонецПопытки;
|
||
```
|
||
|
||
Обратите внимание, мы работаем с объектной моделью бронирования из нашего пакета XDTO, обращаясь к ним через точку и используя цикл Для Каждого.
|
||
|
||
## Задание 3 - HTTP-сервис бронирования
|
||
|
||
### Описание задачи
|
||
|
||
Создать параллельный сервис для приемки бронирований по протоколу HTTP. В качестве формата взаимодействия будет использоваться JSON (но мог бы и XML)
|
||
|
||
### Требование к результату:
|
||
|
||
Выгрузка информационной базы (.dt) с конфигурацией из заданий 1 и 2, которая должна быть дополнена HTTP-сервисом "Бронирования", выполняющим ту же логику.
|
||
|
||
### Порядок выполнения
|
||
|
||
* Создайте в ветке метаданных "http-сервисы" новый сервис и назовите его "Бронирования"
|
||
* Задайте информативное название свойству "Корневой URL" например hotel. Это будет префикс всех URL-адресов создаваемого сервиса
|
||
* На закладке "Шаблоны URL" создайте новый шаблон "Бронирования", в качестве свойства "Шаблон" укажите "bookings"
|
||
* Далее в редакторе, добавьте шаблону "Бронирования" новый "Метод" (кнопка добавить метод в редакторе шаблонов URL) Укажите название "Создать" и в палитре свойств задайте ему HTTP-метод POST
|
||
* В свойстве "Обработчик" метода "Создать" нажмите кнопку с лупой. Система создаст новый метод для обработки входящего запроса.
|
||
* В обработчике реализуйте логику чтения пришедшего JSON текста, которая по данным JSON формирует проведение документа Бронирование. Обратите внимание, что тут не контролируется правильность пришедшего на вход документа, как это было в SOAP (XML) сервисе.
|
||
* Используйте следующий шаблон кода:
|
||
|
||
```bsl
|
||
// предполагается, что на вход поступил JSON из задания 7-1-3
|
||
Попытка
|
||
|
||
ТекстJSON = Запрос.ПолучитьТелоКакСтроку();
|
||
ЧтениеJSON = Новый ЧтениеJSON;
|
||
ЧтениеJSON.УстановитьСтроку(ТекстJSON);
|
||
|
||
СтруктураДанных = ПрочитатьJSON(ЧтениеJSON, Ложь);
|
||
ДокументБронирование = Документы.Бронирование.СоздатьДокумент();
|
||
ДокументБронирование.Дата = ТекущаяДатаСеанса();
|
||
|
||
Для Каждого Гость Из СтруктураДанных Цикл
|
||
// тут алгоритм разбора массива гостей
|
||
КонецЦикла;
|
||
ДокументБронирование.Записать(РежимЗаписиДокумента.Проведение);
|
||
Исключение
|
||
Результат = ОписаниеОшибки();
|
||
ЗаписьЖурналаРегистрации("Бронирование", УровеньЖурналаРегистрации.Ошибка,,,
|
||
Результат);
|
||
|
||
Ответ = Новый HTTPСервисОтвет(400);
|
||
Ответ.УстановитьТелоИзСтроки(Результат);
|
||
Возврат Ответ;
|
||
КонецПопытки;
|
||
|
||
// ВАЖНО - вернуть ответ с успешным кодом 200
|
||
Возврат Новый HTTPСервисОтвет(200);
|
||
```
|
||
|