Другое · 8 мин
Текст как XML в 1С: чтение, запись и обработка
Как в 1С:Предприятии работать с текстом как с XML: чтение и запись строк, экранирование, кодировка, пространства имён и типичные ошибки при парсинге.
В 1С:Предприятии строку можно рассматривать как XML-документ, только если она соответствует правилам разметки: один корневой элемент, парные теги, корректное экранирование служебных символов и объявленная или определяемая кодировка. Если текст не является полноценным XML, попытка прочитать его через средства работы с XML завершится ошибкой или даст неполный результат.
Основной сценарий — преобразование текстового представления в объектную модель документа, обход узлов, извлечение значений атрибутов и содержимого элементов, а также обратная запись данных в текстовую форму. Платформа предоставляет отдельные объекты для последовательного чтения и записи XML, а также для работы с древовидной моделью документа.
Выбор между потоковым и древовидным подходом зависит от размера данных и задачи. Для больших файлов предпочтительнее последовательное чтение, поскольку оно не требует хранения всего дерева в памяти. Для небольших документов удобнее загрузить XML целиком и обращаться к узлам по именам и путям.
Перед началом работы убедитесь, что источник текста надёжен. XML, полученный извне, может содержать некорректные символы, ссылки на внешние сущности или вредоносные конструкции. Проверка на соответствие схеме и ограничение вложенности помогают снизить риски при обработке посторонних данных.
Если задача заключается только в обмене данными между конфигурациями, стоит оценить альтернативы вроде JSON или встроенных форматов сериализации. XML уместен, когда контрагент требует именно этот формат или когда нужно работать с уже готовыми XML-схемами.
Проверьте первую строку и наличие корневого элемента
Убедитесь, что экранирование соответствует правилам XML
Проверьте кодировку, незакрытые теги и посторонние символы
Что означает «текст как XML» в 1С
Текст как XML означает, что обычная строка интерпретируется не как простой набор символов, как документ с иерархией элементов, атрибутов и текстового содержимого. В 1С такая строка может поступать из файла, сообщения веб-сервиса, поля справочника или результата выгрузки другой системы.
Чтобы начать работу, программа должна распознать строку как XML и создать соответствующий объект. На этом этапе важны кодировка и наличие одного корневого элемента. Если в тексте несколько корневых узлов или нет объявления кодировки, платформа может отказаться от парсинга.
Результат чтения зависит от выбранного режима. Потоковый режим позволяет читать элементы по порядку и сразу извлекать нужные значения. Древовидный режим загружает весь документ в память и даёт возможность перемещаться между узлами в любом порядке.
Как получить объект XML из строки
Исходный текст предварительно проверяют на наличие признаков XML: открывающая скобка тега, закрывающая скобка, корневой элемент. Если строка получена из внешнего источника, рекомендуется удалить невидимые управляющие символы и лишние пробелы в начале и конце, если они не несут смысловой нагрузки.
Затем создаётся объект чтения XML, в качестве источника указывается строка или файл, и выполняется обход узлов. При этом важно отслеживать тип текущего узла: начало элемента, конец элемента, атрибут, текст или комментарий. Точные имена методов уточняются в синтакс-помощнике используемой версии платформы.
При успешном чтении программа получает доступ к именам элементов, их атрибутам и вложенному содержимому. Если в процессе возникает ошибка, обычно это указывает на нарушение структуры XML, несовпадение кодировки или наличие неэкранированных служебных символов.
Как сформировать XML-текст из данных 1С
Для записи данных в XML сначала определяют структуру документа: какой элемент будет корневым, какие вложенные элементы и атрибуты нужны, в каком порядке они следуют. Затем создаётся объект записи XML, указывается целевой приёмник — строка или файл — и поочерёдно записываются opening-теги, атрибуты, содержимое и closing-теги.
Особое внимание уделяется экранированию. Символы &, <, >, кавычки и другие служебные знаки в значениях должны заменяться соответствующими XML-сущностями. Иначе полученный текст окажется некорректным и не сможет быть прочитан другими системами.
После завершения записи результат проверяют повторным чтением или через внешний XML-парсер. Если документ открывается без ошибок и структура совпадает с ожидаемой, запись выполнена корректно.
- 1Определите структуру и кодировку будущего XML
- 2Создайте объект записи и укажите приёмник
- 3Запишите элементы, атрибуты и содержимое с экранированием
- 4Проверьте результат повторным чтением или парсером
Кодировка, экранирование и пространства имён
Кодировка определяет, как буквы и спецсимволы кодируются в байты. Несоответствие между объявленной в XML кодировкой и реальной кодировкой строки приводит к искажению текста, особенно при работе с кириллицей. Перед парсингом полезно сверить объявление кодировки в заголовке документа с фактическим представлением строки.
Экранирование нужно там, где в текстовых значениях встречаются символы, имеющие специальное значение для XML. Без этого парсер может принять часть данных за разметку и прервать чтение или прочитать не те данные.
Пространства имён позволяют объединять элементы из разных схем и избегать имённых конфликтов. При работе с пространствами имён важно использовать полные имена элементов с префиксами, иначе элементы с одинаковыми локальными именами, но разным происхождением, могут быть перепутаны.
Проверка, валидация и безопасность
Результат обработки XML проверяют на нескольких уровнях: синтаксическая корректность, соответствие ожидаемой схеме, наличие обязательных элементов и корректность значений. Если документ не проходит проверку, обработку следует прекратить и уведомить пользователя, а не пытаться продолжить работу с повреждёнными данными.
| Подход | Когда подходит | Ограничение |
|---|---|---|
| Потоковое чтение | Большие файлы и последовательная обработка | Сложнее переходить между удалёнными узлами |
| Древовидная модель | Небольшие документы и частый доступ к разным узлам | Больше потребляет память |
При обработке XML из внешних источников есть риск подмены данных или загрузки вредоносного содержимого. Не следует выполнять код, содержащийся в XML, и не стоит доверять ссылкам на внешние ресурсы без проверки. Если конфигурация позволяет ограничить обработку внешних сущностей, такое ограничение стоит включить.
Как проверить результат
Документ читается полностью
Возникает ошибка синтаксиса или кодировки
Обязательные элементы и атрибуты на месте
Отсутствуют нужные узлы или есть лишние
Текст и числа совпадают с исходником
Символы искажены или данные обрезаны
Альтернативы и когда XML не нужен
XML не всегда является оптимальным выбором. Если стороны обмена поддерживают более компактный формат, например JSON, обработка может быть быстрее и проще. Для внутренних данных 1С часто удобнее использовать встроенные таблицы значений, структуры или сериализацию платформы.
XML оправдан, когда требуется строгая схема, поддержка пространств имён или совместимость с внешними системами, которые принимают только этот формат. В остальных случаях выбор формата определяется требованиями контрагента, объёмом данных и доступными инструментами парсинга.
Что важно запомнить
Текст в 1С становится XML только при соблюдении правил разметки, кодировки и экранирования; результат проверяют повторным чтением, а недоверенные данные обрабатывают осторожно.
Нужно ли объявлять кодировку в каждой XML-строке?
Объявление кодировки помогает парсеру правильно интерпретировать байты, особенно для кириллицы. Если кодировка не объявлена, платформа может попытаться определить её автоматически, но результат не всегда надёжный.
Что делать, если чтение XML завершается ошибкой?
Сначала проверьте наличие одного корневого элемента, закрытые теги и экранирование служебных символов. Затем убедитесь, что кодировка строки совпадает с объявленной, и сравните фрагмент текста с ожидаемой структурой.
Можно ли записывать XML напрямую в строку без файла?
Возможность записи в строку зависит от используемого объекта и версии платформы. Если прямой записи в строку нет, можно использовать временный файл или поток, а затем прочитать полученное содержимое в строковую переменную.
Когда лучше не использовать XML?
XML не нужен, если стороны обмена поддерживают более простой формат, данные небольшие, а строгая схема не требуется. В таких случаях подходят JSON, таблицы значений или встроенные средства сериализации 1С.