интеграция ozone, права доступа УТ 11, отчёт на СКД

ЗаписьXML.Параметры

Свойства · Settings

Тип: ПараметрыЗаписиXML. Определяет текущие параметры записи XML.

Полное описание, параметры и ограничения

ЗаписьXML.Параметры (XMLWriter.Settings)

ЗаписьXML (XMLWriter)

Параметры (Settings)

Доступен, начиная с версии 8.1.

Использование:
Только чтение.
Описание:
Тип: ПараметрыЗаписиXML.
Определяет текущие параметры записи XML.
Доступность:

Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Использование в версии:

Доступен, начиная с версии 8.1.

Методическая информация

Практические примеры

Настроить читаемый XML и проверить обратное чтение

UTF-8, версия 1.0, отступы элементов и атрибутов, два пробела. После записи снова читаем свой XML и сравниваем данные.

Где и как запускать

Полный серверный общий модуль собственной учебной базы; не тонкий клиент.

Подготовка

  1. В своей учебной базе 8.5.1.1343 создайте серверный общий модуль УчебнаяЗаписьXML. Вставьте полный модуль одного урока и вызовите УчебнаяЗаписьXML.ВыполнитьПример() из собственной серверной команды.

  2. Все тексты и товары заданы константами: Книга, A&B, количество 3. Учётные данные, файлы организации, HTTP и внешние XML не используются.

  3. Первые шесть уроков работают только со строками/потоком в памяти. Последний создаёт один новый временный XML в собственной учебной базе; имя выводится, файл оставляется для ручной проверки.

  4. Для урока файла имя конфигурации должно быть УчебнаяКонфигурацияСинтаксиса. Существующий файл не перезаписывается. После проверки удалите вручную только показанный собственный временный файл.

  5. ПараметрыЗаписиXML неизменяемы после создания. Все пять параметров задаются конструктором, а не присваиванием свойств.

Процедура ВыполнитьПример() Экспорт
    ПоУмолчанию = Новый ПараметрыЗаписиXML;
    Параметры = Новый ПараметрыЗаписиXML("UTF-8", "1.0", Истина, Истина, "  ");
    Сообщить(Параметры.Версия = "1.0");
    Сообщить(Параметры.Кодировка = "UTF-8");
    Сообщить(Параметры.Отступ И Параметры.ОтступАтрибутов);
    Сообщить(Параметры.СимволыОтступа = "  ");
    Сообщить(ПоУмолчанию.Версия = "1.0");
    Запись = Новый ЗаписьXML;
    Запись.УстановитьСтроку(Параметры);
    Попытка
        Сообщить(Запись.Параметры.Версия = "1.0");
        Запись.ЗаписатьОбъявлениеXML();
        Запись.ЗаписатьНачалоЭлемента("catalog");
        Запись.ЗаписатьНачалоЭлемента("product");
        Запись.ЗаписатьАтрибут("code", "A&B");
        Запись.ЗаписатьАтрибут("quantity", "3");
        Запись.ЗаписатьТекст("Книга <учебник> & пособие");
        Запись.ЗаписатьКонецЭлемента();
        Запись.ЗаписатьКонецЭлемента();
        XML = Запись.Закрыть();
    Исключение
        Запись.Закрыть();
        ВызватьИсключение;
    КонецПопытки;
    Товар = ПрочитатьУчебныйТовар(XML);
    Сообщить(Товар.Код = "A&B");
    Сообщить(Товар.Количество = "3");
    Сообщить(Товар.Текст = "Книга <учебник> & пособие");
    Сообщить(XML);
КонецПроцедуры

Функция ПрочитатьУчебныйТовар(XML)
    Чтение = Новый ЧтениеXML;
    Результат = Новый Структура("Корень,Код,Количество,Текст", "", "", "", "");
    ВТоваре = Ложь;
    Попытка
        Чтение.УстановитьСтроку(XML);
        Пока Чтение.Прочитать() Цикл
            Если Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента Тогда
                Если ПустаяСтрока(Результат.Корень) Тогда
                    Результат.Корень = Чтение.ЛокальноеИмя;
                КонецЕсли;
                Если Чтение.ЛокальноеИмя = "product" Тогда
                    ВТоваре = Истина;
                    Результат.Код = Чтение.ПолучитьАтрибут("code");
                    Результат.Количество = Чтение.ПолучитьАтрибут("quantity");
                КонецЕсли;
            ИначеЕсли ВТоваре И (Чтение.ТипУзла = ТипУзлаXML.Текст
                ИЛИ Чтение.ТипУзла = ТипУзлаXML.СекцияCDATA) Тогда
                Результат.Текст = Результат.Текст + Чтение.Значение;
            ИначеЕсли Чтение.ТипУзла = ТипУзлаXML.КонецЭлемента
                И Чтение.ЛокальноеИмя = "product" Тогда
                ВТоваре = Ложь;
            КонецЕсли;
        КонецЦикла;
    Исключение
        Чтение.Закрыть();
        ВызватьИсключение;
    КонецПопытки;
    Чтение.Закрыть();
    Возврат Результат;
КонецФункции

Разбор по шагам

  1. Создать параметры по умолчанию и отдельные параметры с пятью аргументами в правильном порядке. Свойства параметров только читаются.

  2. Передать параметры в УстановитьСтроку и проверить фактические Запись.Параметры.

  3. Объявление XML записать до корня. Атрибут A&B и текст с < и & передать штатным методам: их экранирование делает ЗаписьXML.

  4. Закрыть возвращает строку. Полностью прочитать её и сравнить код, количество и текст, не полагаясь только на внешний вид.

Как проверить результат

  1. Девять булевых проверок дают Истина.

  2. XML выводится для чтения. Кодировка в объявлении строки — метка; настоящие UTF-8 байты показаны в уроке потока.

Ожидаемый результат

Готовая запись и обратное чтение собственного товара с понятными настройками оформления.

На что обратить внимание

  1. Нельзя присвоить Параметры.Отступ: создайте новый объект параметров.

  2. СимволыОтступа могут содержать только пробельные символы.

  3. Не сравнивайте весь XML побайтно из-за отступов: данные проверяются читателем.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Понять, когда переключение Отступ начинает действовать

Переключаем свойство во время записи и показываем, что текущие параметры не меняются до следующей установки строки.

Где и как запускать

Полный серверный общий модуль собственной учебной базы; не тонкий клиент.

Подготовка

  1. В своей учебной базе 8.5.1.1343 создайте серверный общий модуль УчебнаяЗаписьXML. Вставьте полный модуль одного урока и вызовите УчебнаяЗаписьXML.ВыполнитьПример() из собственной серверной команды.

  2. Все тексты и товары заданы константами: Книга, A&B, количество 3. Учётные данные, файлы организации, HTTP и внешние XML не используются.

  3. Первые шесть уроков работают только со строками/потоком в памяти. Последний создаёт один новый временный XML в собственной учебной базе; имя выводится, файл оставляется для ручной проверки.

  4. Для урока файла имя конфигурации должно быть УчебнаяКонфигурацияСинтаксиса. Существующий файл не перезаписывается. После проверки удалите вручную только показанный собственный временный файл.

  5. ПараметрыЗаписиXML неизменяемы после создания. Все пять параметров задаются конструктором, а не присваиванием свойств.

Процедура ВыполнитьПример() Экспорт
    Запись = Новый ЗаписьXML;
    Запись.Отступ = Ложь;
    Запись.УстановитьСтроку();
    Сообщить(НЕ Запись.Параметры.Отступ);
    Запись.Отступ = Истина;
    Сообщить(НЕ Запись.Параметры.Отступ);
    Попытка
        Запись.ЗаписатьНачалоЭлемента("catalog");
        Запись.ЗаписатьНачалоЭлемента("product");
        Запись.ЗаписатьАтрибут("code", "A&B");
        Запись.ЗаписатьАтрибут("quantity", "3");
        Запись.ЗаписатьТекст("Книга <учебник> & пособие");
        Запись.ЗаписатьКонецЭлемента();
        Запись.ЗаписатьКонецЭлемента();
        КомпактныйXML = Запись.Закрыть();
    Исключение
        Запись.Закрыть();
        ВызватьИсключение;
    КонецПопытки;
    Запись.УстановитьСтроку();
    Сообщить(Запись.Параметры.Отступ);
    Попытка
        Запись.ЗаписатьНачалоЭлемента("catalog");
        Запись.ЗаписатьНачалоЭлемента("product");
        Запись.ЗаписатьАтрибут("code", "A&B");
        Запись.ЗаписатьАтрибут("quantity", "3");
        Запись.ЗаписатьТекст("Книга <учебник> & пособие");
        Запись.ЗаписатьКонецЭлемента();
        Запись.ЗаписатьКонецЭлемента();
        ФорматированныйXML = Запись.Закрыть();
    Исключение
        Запись.Закрыть();
        ВызватьИсключение;
    КонецПопытки;
    Первый = ПрочитатьУчебныйТовар(КомпактныйXML);
    Второй = ПрочитатьУчебныйТовар(ФорматированныйXML);
    Сообщить(Первый.Код = Второй.Код);
    Сообщить(Первый.Текст = Второй.Текст);
    Сообщить(КомпактныйXML);
    Сообщить(ФорматированныйXML);
КонецПроцедуры

Функция ПрочитатьУчебныйТовар(XML)
    Чтение = Новый ЧтениеXML;
    Результат = Новый Структура("Корень,Код,Количество,Текст", "", "", "", "");
    ВТоваре = Ложь;
    Попытка
        Чтение.УстановитьСтроку(XML);
        Пока Чтение.Прочитать() Цикл
            Если Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента Тогда
                Если ПустаяСтрока(Результат.Корень) Тогда
                    Результат.Корень = Чтение.ЛокальноеИмя;
                КонецЕсли;
                Если Чтение.ЛокальноеИмя = "product" Тогда
                    ВТоваре = Истина;
                    Результат.Код = Чтение.ПолучитьАтрибут("code");
                    Результат.Количество = Чтение.ПолучитьАтрибут("quantity");
                КонецЕсли;
            ИначеЕсли ВТоваре И (Чтение.ТипУзла = ТипУзлаXML.Текст
                ИЛИ Чтение.ТипУзла = ТипУзлаXML.СекцияCDATA) Тогда
                Результат.Текст = Результат.Текст + Чтение.Значение;
            ИначеЕсли Чтение.ТипУзла = ТипУзлаXML.КонецЭлемента
                И Чтение.ЛокальноеИмя = "product" Тогда
                ВТоваре = Ложь;
            КонецЕсли;
        КонецЦикла;
    Исключение
        Чтение.Закрыть();
        ВызватьИсключение;
    КонецПопытки;
    Чтение.Закрыть();
    Возврат Результат;
КонецФункции

Разбор по шагам

  1. Отключить Запись.Отступ перед первой установкой строки.

  2. Включить свойство после открытия: текущие Запись.Параметры.Отступ остаются выключенными.

  3. Завершить первую запись и снова вызвать УстановитьСтроку. Теперь новые параметры используют включённый отступ.

  4. Повторить запись того же товара и сравнить значения после чтения: формат отличается, содержимое нет.

Как проверить результат

  1. Пять сравнений дают Истина.

  2. Сравните две выведенные строки: первый документ компактный, второй форматированный.

Ожидаемый результат

Проверяемый пример отложенного применения настройки, частой причины непонятного форматирования.

На что обратить внимание

  1. Свойство Отступ у писателя изменяемо, одноимённое свойство ПараметрыЗаписиXML — нет.

  2. Изменение свойства не переформатирует уже записанные данные.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Связанные темы

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу
1c-only | Фриланс © 2026
Политика обработки персональных данных · Пользовательское соглашение
1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.