Ошибки электронной документации

Ошибки электронной документации возникают не только из-за поврежденного файла или неправильного расширения. Риск появляется всякий раз, когда электронное представление документа перестает однозначно соответствовать его содержанию, актуальной версии и установленному способу представления. Файл может открываться у пользователя и при этом оставаться проблемным для экспертизы: например, если его структура не соответствует применимой XML-схеме, электронная подпись относится к другой версии документа или метаданные не позволяют уверенно идентифицировать содержащуюся в файле информацию.

Поэтому проверять электронный комплект нужно сразу на двух уровнях. Первый — технический: формат, структура файла, XML-поля, подпись, читаемость и машинная обработка. Второй — содержательный: соответствует ли электронный файл тому документу, который должен быть представлен, и является ли он актуальной версией. Исправление только одного уровня не всегда устраняет риск.

Когда электронный комплект становится ненадежным

Один из основных сценариев — использование неподходящего формата или структуры файла. Для документов, для которых предусмотрено формирование в структурированном электронном виде, значение имеет не только возможность открыть файл, но и соответствие применимой XML-схеме. Структурированный документ содержит данные в определенных полях и связях, благодаря чему информационная система может идентифицировать и обработать их машинно.

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

Другой источник риска — расхождение версий. Проектировщик может исправить содержание документа, сохранить новый файл, но оставить в комплекте прежнюю версию или прежнюю подпись. Возможна и обратная ситуация: файл заменен, а сопроводительные сведения продолжают описывать предыдущий вариант. В результате отдельные элементы комплекта существуют, но не образуют единой актуальной версии.

Почему электронная подпись проверяется вместе с самим файлом

Электронная подпись связана с конкретным электронным документом. Поэтому важно проверять не только формальное наличие файла подписи, но и то, какой именно документ этой подписью подтверждается. Если после подписания содержание документа изменили, прежняя подпись не должна восприниматься как подтверждение новой версии только потому, что ее файл остался рядом.

При подготовке комплекта нужно установить последовательность: какой файл является итоговым, соответствует ли ему подпись и совпадает ли эта версия с той, что указана в сопроводительных сведениях. Такой контроль особенно важен после серии корректировок, когда в рабочей папке могут одновременно находиться несколько вариантов одного документа.

Простой признак возможного версионного расхождения — одинаковые или почти одинаковые имена файлов при разных датах, размерах или содержании. Но сами по себе такие признаки еще не доказывают ошибку. Они показывают, что необходимо определить актуальный вариант и проверить связь между документом, подписью и остальными материалами комплекта.

Как обнаружить проблему до подачи документации

Проверка начинается с фиксации фактического состава электронного комплекта. Нужно определить, какие документы должны входить в него, какие файлы действительно представлены и какую функцию выполняет каждый из них. После этого можно искать не отдельные технические дефекты, а разрывы между содержанием, форматом, версией и подтверждающими сведениями.

Практическая проверка включает несколько разных действий:

• Идентификация файлов. По имени, структуре и содержимому устанавливают, какой документ представлен каждым файлом и нет ли нескольких конкурирующих версий.
• Проверка формата. Определяют, соответствует ли фактический формат типу документа и предусмотренному способу электронного представления.
• Проверка XML. Для структурированных документов проверяют применимую схему и корректность заполнения значимых элементов.
• Проверка электронной подписи. Подтверждают связь подписи с конкретной актуальной версией файла.
• Сопоставление метаданных и содержимого. Название, идентификаторы и другие сведения о документе должны соответствовать тому, что фактически находится внутри файла.
• Контроль связей внутри комплекта. Если один документ ссылается на другой или является частью общего набора, проверяют, что связанные файлы относятся к согласованным версиям.

Эти действия нужно сочетать с визуальной проверкой. Машинная проверка способна обнаружить проблемы структуры или формата, но не всегда показывает содержательное расхождение. Например, технически корректный файл может содержать предыдущую редакцию проектного решения. Поэтому итоговый контроль должен отвечать одновременно на вопросы «может ли система корректно обработать документ?» и «тот ли это документ, который должен быть представлен?».

Как отличить ошибку формата от ошибки содержания

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

Если техническая структура корректна, но данные внутри файла относятся к другой редакции проектного решения, проблема уже не в формате. Нужно установить актуальное содержание и пересобрать документ на его основе. Замена расширения файла или повторное формирование той же версии эту причину не устранит.

Отдельно рассматривается ошибка метаданных. Сам документ может содержать правильную информацию, но быть неверно идентифицирован в электронном комплекте. Тогда риск появляется в месте связи файла с его описанием. Исправление должно затронуть именно эту связь, а не содержание, которое уже является корректным.

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

Почему пересылка отдельных исправленных файлов не всегда решает проблему

После обнаружения дефекта часто исправляют только тот файл, на котором он проявился. Такой подход достаточен лишь тогда, когда проблема действительно локальна и не затрагивает другие зависимости. При версионном расхождении этого обычно недостаточно.

Предположим, был исправлен электронный документ, но в комплекте осталось прежнее сопроводительное описание. Новый файл уже содержит правильное решение, однако комплект в целом продолжает передавать противоречивую информацию. Аналогично, замена XML-документа без проверки связанной подписи может оставить прежнюю проблему в другом элементе.

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

Как работать с XML-схемами и резервными форматами

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

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

Особенно опасна рабочая привычка считать PDF автоматически подходящим для любого документа. Читаемость PDF отвечает лишь на вопрос, может ли пользователь увидеть информацию. Она сама по себе не подтверждает соответствие требованиям к структурированному электронному представлению.

Что проверять после исправления

Исправленное состояние подтверждается повторной технической и содержательной проверкой всего непосредственно затронутого набора файлов. Сначала фиксируют актуальные версии, затем снова проверяют форматы и структуру, после чего сопоставляют электронные подписи и сопроводительные сведения.

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

Полезный контрольный вопрос для каждого исправленного элемента звучит так: можно ли теперь однозначно определить, что это за документ, к какой версии проекта он относится, в каком формате представлен и чем подтверждается именно эта редакция? Если хотя бы один из этих ответов остается неопределенным, риск нельзя считать полностью устраненным.

Какой результат должен дать контроль электронного комплекта

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

Если обнаружено расхождение, его следует локализовать: технический формат, XML-структура, содержание, версия, подпись или метаданные. Это позволяет исправлять причину, а не случайный внешний признак. После корректировки соответствующая проверка выполняется повторно.

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

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