Содержит варианты необходимости назначения типа элементу XML при сохранении значения.
Полное описание, параметры и ограничения
НазначениеТипаXML (XMLTypeAssignment)
НазначениеТипаXML (XMLTypeAssignment)
Доступен, начиная с версии 8.0.
Значения
Неявное (Implicit)
Явное (Explicit)
Описание:
Содержит варианты необходимости назначения типа элементу XML при сохранении значения.
Доступность:
Мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Возможен обмен с сервером.
См. также:
Глобальный контекст, метод ЗаписатьXML
НазначениеТипаXML, свойство Явное
НазначениеТипаXML, свойство Неявное
СериализаторXDTO, метод ЗаписатьXML
ФабрикаXDTO, метод ЗаписатьXML
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Записать дату в XML с явным типом и прочитать обратно
Сериализуем одну собственную дату, закрываем оба потока и проверяем тип/точное значение. Часовой пояс здесь не конвертируется.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Дата фиксирована и не содержит объявленного часового пояса: учебный контракт сохраняет локальные компоненты как есть.
Чтение использует только строку XML, созданную этим же уроком. Произвольные внешние XML сюда не подставляйте.
Сериализатор = Новый СериализаторXDTO;
ИсходнаяДата = Дата(2026, 9, 15, 12, 30, 0);
Запись = Новый ЗаписьXML;
Запись.УстановитьСтроку();
Попытка
Сериализатор.ЗаписатьXML(Запись, ИсходнаяДата, НазначениеТипаXML.Явное);
XML = Запись.Закрыть();
Исключение
Запись.Закрыть();
ВызватьИсключение;
КонецПопытки;
Сообщить(XML);
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(XML);
Попытка
ВосстановленнаяДата = Сериализатор.ПрочитатьXML(Чтение, Тип("Дата"));
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Сообщить(ТипЗнч(ВосстановленнаяДата) = Тип("Дата"));
Сообщить(ВосстановленнаяДата = ИсходнаяДата);
Сообщить(Час(ВосстановленнаяДата) = 12 И Минута(ВосстановленнаяДата) = 30);Разбор по шагам
УстановитьСтроку создаёт XML в памяти. ЗаписатьXML без имени элемента использует имя типа значения.
НазначениеТипаXML.Явное записывает информацию о типе; чтению дополнительно передаём ожидаемый Тип("Дата").
Закрыть освобождает запись/чтение и при успехе, и при исключении. Исключение не превращаем в пустую дату.
После чтения проверяем тип, точное значение и отдельные компоненты часа/минуты.
Как проверить результат
Восстановленный тип Дата, дата равна 15.09.2026 12:30:00, обе проверки времени — Истина.
Удалите закрывающий тег у копии XML: чтение должно завершиться ошибкой, не успешным частичным значением.
Нет записанных файлов или изменений прикладных документов.
Ожидаемый результат
Одна дата прошла полный XML-цикл с явным типом и контролируемым временем жизни потоков.
На что обратить внимание
Это не перевод времени в UTC и не доказательство корректной обработки timezone внешнего сервиса.
Представление даты платформы не обязательно совпадает с требованием чужого API.
Не сериализуйте коллекции метаданных ради эксперимента: в некоторых режимах такой экспорт может включать доступные записи объектов. Здесь используется только скаляр.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.