1c-homeworks/homework-7-1.md

# Задание к занятию "XML и JSON"

## Стандартная сериализация объектов ИБ

### Описание задачи

Записать в файл XML объект справочника и прочитать его в другой информационной базе.
Повторить операцию, но использовать для обмена формат JSON.

### Требования к результату

Выгрузка информационной базы (.dt) с Внешней обработкой, позволяющей выбрать элемент справочника и сохранить (сериализовать) его в файл данных. Эта же обработка должна позволять выбрать файл на диске и создать на основании его содержимго элемент справочника (десериализовать). Внешняя обработка должна обеспечивать обмен записями справочника между несколькими информационными базами идентичной структуры.

### Процесс выполнения

1. Возьмите чистую конфигурацию и создайте в ней справочник "Товары". Создайте реквизиты справочника "Цена (Число 18.2)", "Артикул (Строка 15)", "Брэнд Строка (50)"
2. Создайте внешнюю обработку с двумя закладками "Запись в файл" и "Чтение из файла"
3. На закладке "Запись в файл" разместите поле выбора "Товар" для выбора элемента из справочника Товары, а также кнопку "Сохранить в файл"
4. В обработчике нажатия кнопки вызовите серверный метод СформироватьФайл, который сгенерирует имя временного файла с расширением xml, запишет данные в файл, поместит файл во временное хранилище и вернет на клиент адрес временного хранилища
5. Для записи данных в файл используйте объект ЗаписьXML. В файл должен быть записан СправочникОбъект той записи, которая выбрана в поле "Товар". Обратите внимание, в файл должна быть записана не ссылка, а именно СправочникОбъект, т.е. необходимо вызвать метод ПолучитьОбъект у ссылки в поле "Товар"
6. Для записи объекта используйте СериализаторXDTO и его метод `ЗаписатьXML`. 
7. На клиенте, после получения адреса временного хранилища, сохраните файл с помощью метода `ПолучитьФайлССервераАсинх`, для файла по умолчанию должно быть указано расширение xml.
8. Изучите содержимое полученного файла.
9. На закладке "Чтение из файла" разместите кнопку "Прочитать файл"
10. В обработчике нажатия кнопки передайте файл на сервер с помощью метода `ПоместитьФайлНаСерверАсинх`, для выбора должны быть доступны только файлы xml
11. После выбора файла напишите алгоритм чтение файла с помощью объекта ЧтениеXML
12. Для чтения из файла в СправочникОбъект используйте СериализаторXDTO и его метод `ПрочитатьXML`. Не забудьте вторым параметром метода указать тип, в который нужно прочитать (десериализовать) объект справочника.

В результате, должна получиться внешняя обработка, которая позволит передать запись справочника "Товары" между двумя одинаковыми информационными базами через файл XML.

13. Скопируйте получившуюся обработку и модифицируйте ее таким образом, чтобы вместо объектов ЧтениеXML и ЗаписьXML использовались объекты ЧтениеJSON и ЗаписьJSON соответственно. Не забудьте так же изменить метод СериализатораXDTO на Прочитать/ЗаписатьJson

# Задание "Ручное формирование XML"

## Описание задачи

Довольно часто требуется не просто записать данные базы в XML-файл, а соблюсти определенную структуру файла, имена полей и их формат. Для этих целей используется ручное поэлементное формирование документа XML.

### Требования к результату

Выгрузка информационной базы (.dt) с Внешней обработкой, создающей документ передачи данных о бронировании в гипотетический отель.
Результат записи XML обработка должна выводить в поле текстового документа, расположенное на форме этой обработки.

### Процесс выполнения 

1. Создайте внешнюю обработку с кнопкой, нажатие на которую формирует документ следующего содержания, используя методы объекта `ЗаписьXML`

```xml
<?xml version="1.0" encoding="utf-8"?>
<guests>
    <guest name="Иван" arrives="2020-08-25">
      <room>
         <type>double</type>
         <withShower>true</withShower>
      </room>
      <meals breakfast="true" dinner="false" supper="false" />
    </guest>
    <guest name="Петр" arrives="2020-09-10">
      <room>
         <type>single</type>
         <withShower>true</withShower>
      </room>
      <meals breakfast="true" dinner="true" supper="true" />
    </guest>
</guests>
```

Вам потребуются методы:

* ЗаписатьОбъявлениеXML
* ЗаписатьНачалоЭлемента
* ЗаписатьКонецЭлемента
* ЗаписатьАтрибут
* ЗаписатьТекст

2. Выведите XML в виде строки в поле текстового документа, размещенное на форме обработки.

# Задача "Формирование JSON"

## Описание задачи

Формат JSON является более легковесным, и на практике чаще всего является текстовым представлением того или иного объекта (например, Структуры)
Ручное формирование JSON поэлементно используется редко, поэтому в данном задании будет применена методика создания JSON из готового объекта, как наиболее частая.

## Требования к результату

Выгрузка информационной базы (.dt) с Внешней обработкой, выводящая в поле текстового документа содержимое коллекции для передачи в гипотетический отель для бронирования

Результат должен иметь вид:

```json
[
  {
    "name": "Иван",
    "arrives": "2020-08-25",
    "room": {
      "type": "double",
      "withShower": true
    },
    "meals": [
      "brealfast"
    ]
  },
  {
    "name": "Петр",
    "arrives": "2020-09-10",
    "room": {
      "type": "single",
      "withShower": true
    },
    "meals": [
      "brealfast",
      "dinner",
      "supper"
    ]
  }
]
```

Обратите внимание, что в JSON существуют Структуры (Объекты) обозначенные фигурными скобками, и Массивы, обозначенные квадратными скобками. Каждый тип 1С:Предприятия при записи в JSON отображается именно в эти элементы JSON. Иными словами, для списков в квадратных скобках применяются Массивы 1С, для объектов в фигурных скобках - Структуры 1С или Соответствия.

## Процесс выполнения

1. Разместите на форме внешней ообработки поле текстового документа и кнопку "Создать JSON"
2. В обработчике нажатия кнопки создайте структуру для "Гостя", в качестве имен свойств структуры используйте именно такие названия, как в требуемом примере документа "name, arrives" и т.д. Для "комнат" и "питания" также используйте коллекции 1С.
3. Создайте Массив таких "гостей", как в примере (2 записи-структуры) в Массиве
4. С помощью метода глобального контекста `ЗаписатьJSON` и объекта `ЗаписьJSON` запишите массив гостей в виде JSON
5. Результат записи, в виде строки, отобразите в поле текстового документа на форме обработки.