Очередное обновление XMLONLINE.RU
Мы стремимся сделать опыт пользования сервисом формирования обработки XML-документов более позитивным и простым, поэтому в сервисе XMLONLINE.RU реализованы доработки при работе с XML-документами Пояснительная записка, Заключение экспертизы и Пояснительная записка к сметной документации.
При внедрении изменений учитывалась структура и описания элементов XSD-схем Минстроя. Ниже приводим ключевые доработки документа Пояснительная записка к сметной документации:
- Выпадающие списки для элементов с фиксированными значениями
В предыдущих схемах значения с ограниченным перечнем, как правило, задавались через отдельные типы (simpleType), что позволяло сервису корректно их обрабатывать.
В схеме ПЗ к сметам подход изменён:
перечни допустимых значений во многих случаях описаны не через отдельные типы, а непосредственно внутри элементов — через вложенный simpleType с restriction и enumeration.
В рамках обновления XMLONLINE.RU доработан разбор XSD, и теперь такие inline-ограничения также корректно обрабатываются. За счёт этого элементы с фиксированным набором значений автоматически отображаются в интерфейсе в виде выпадающих списков.
Примеры:
- Формат файла (FileFormat): выбор допустимого формата вместо ручного ввода
- Тип документа (DocType): строгое соответствие классификатору документов
Элементы в составе типов:
- tDocument
- tTechnicalRequirements
- и других complexType, где используются перечисления
Теперь пользователь выбирает значение из допустимого списка, что:
- исключает ошибки, связанные с несоответствием XSD;
- ускоряет заполнение;
- обеспечивает корректную валидацию XML.
- Предзаполнение служебных элементов XML-файла
Реализовано автоматическое заполнение служебных элементов, связанных с формированием файла:
- Дата и время формирования файла: ExportDateTime
- Программный комплекс, использованный для формирования файла: Software
- Формат файла: FileFormat
Значения подставляются автоматически при формировании XML.
Это позволяет:
- не заполнять технические поля вручную;
- избежать ошибок формата даты/времени;
- обеспечить корректное формирование служебной части документа.
- Формирование элемента FileChecksum с учётом требований схемы
В схеме используется элемент: Контрольная сумма файла - FileChecksum.
Согласно описанию схемы, контрольная сумма рассчитывается по алгоритму CRC32-IEEE для проверки целостности при передаче.
В XMLONLINE.RU реализовано:
- расчёт по содержимому XML;
- исключение элемента ExportDateTime из расчёта (для xml-файлов);
- приведение значения:
- к верхнему регистру;
- к формату 32 символа (hex) — как требует данная схема.
Это критично для прохождения проверок, так как:
- при включении ExportDateTime сумма становится некорректной;
- при неверной длине значение не проходит валидацию.
При этом для других схем (где используется 8-символьный формат) логика остаётся отдельной.
- Приведение интерфейса к составу элементов XSD
В структуре схемы ПЗ к сметам отсутствуют элементы, связанные с подписью файлов.
В связи с этим:
- убрана загрузка файлов подписи (.sig, .p7s);
- оставлены только элементы, предусмотренные XSD: Имя файла, формат, контрольная сумма.
Интерфейс приведён в полное соответствие с моделью данных схемы.
- Поддержка ссылок на документы через GUID
В схеме предусмотрена возможность ссылаться на ранее добавленные документы через GUID.
Это реализовано в текстовых и табличных блоках. Согласно описанию, такие элементы поддерживают вставку ссылки на документ, включённый в состав ПЗ, через его идентификатор (GUID).
В XMLONLINE.RU добавлена кнопка «добавить ссылку на файл», которая:
- подставляет корректный GUID документа;
- вставляет ссылку именно в тот элемент, где это допускается схемой;
- исключает ошибки ручного ввода идентификатора.
- Выравнивание ячеек в табличных блоках
В схеме Пояснительной записки к сметной документации на уровне описания элементов предусмотрены требования к представлению табличных данных, в том числе выравниванию значений в ячейках.
В связи с этим в XMLONLINE.RU реализована поддержка выравнивания для соответствующих табличных блоков:
- значения в ячейках отображаются с учётом требований схемы;
- улучшена читаемость строк технико-экономических показателей;
- таблицы визуально соответствуют ожидаемому виду.
Важно, что такая логика применяется именно для данной схемы, поскольку в других XSD-схемах Минстроя требования к выравниванию ячеек не задаются.
Таким образом, отображение таблиц в сервисе напрямую приведено в соответствие с описанием элементов, предусмотренным схемой.
- Вставка ТЭПов из буфера обмена для блоков типа ТЭП, используемых в Пояснительных записках и Заключениях экспертизы, в XMLONLINE.RU реализована отдельная функция вставки данных из буфера обмена.
Пользователь может открыть окно «Вставка данных из таблицы», скопировать таблицу в буфер (выделить таблицу в Word/Excel/PDF и нажать «Копировать») и загрузить значения сразу в XML-структуру без ручного заполнения строк по одной.
Поддерживаются таблицы:
- с 3 колонками;
- с 4 колонками.
В зависимости от структуры блока данные распределяются по полям:
- Наименование (Name)
- Единица измерения (Measure)
- Значение (Value)
- Предыдущее значение (OldValue)
Реализованы два режима вставки:
- Добавить новые строки → строки из буфера добавляются к уже существующему списку;
- Заменить текущие строки → ранее заполненные строки очищаются, и вместо них вставляются новые данные из буфера.
Такой механизм особенно удобен при переносе ТЭПов из:
- Excel;
- расчётных таблиц;
- табличных текстовых данных, скопированных через буфер обмена.
Это позволяет существенно ускорить заполнение технико-экономических показателей и снизить количество ручных ошибок при переносе данных.
В ИТОГЕ:
Мы продолжаем дорабатывать ваш любимый специализированный сервис XMLONLINE.RU с акцентом на то, чтобы работа с машиночитаемыми XML-документами была проще, понятнее и быстрее.
В первую очередь изменения направлены не просто на формальное соответствие XSD-схемам Минстроя, а на то, чтобы:
- снизить количество ошибок при заполнении;
- убрать лишние ручные действия;
- ускорить подготовку XML-документов.
Надеемся, что реализованные доработки упростят вам работу с машиночитаемыми документами и сделают процесс формирования XML более удобным и предсказуемым.
Работа над сервисом продолжается — мы и дальше будем адаптироваться под изменения схем и улучшать пользовательский опыт!
141