Задание на проектирование в xml
Особенности заполнения элементов:
Элемент tDocument / Requisites (Реквизиты документа)

Структура элементов:
Requisites (родительский элемент)
├── Date (дочерний элемент)
├── Number (дочерний элемент)
├── Authors (дочерний элемент)├── Author (вложенный элемент)…
└── SecurityLabel (дочерний элемент)

При заполнении полей в строках дочерних и вложенных элементов обратите внимание на следующие условия их заполнения:
- для элемента tRequisites / Date (Дата разработки документа) - дата утверждения документа соответствует
дате формирования электронной цифровой подписи к документу утверждающего лица;
- для элемента tRequisites / Number (Номер документа) есть ограничения по содержанию: «Непустая текстовая строка (максимальной длиной 1000
символов)»;
- для элемента tRequisites / Authors (Авторы документа) - в составе роли автора установлена проверка, что должен быть указан как минимум утверждающий документа (если у документа один автор, то укажите его с ролью «Утверждено», если авторов несколько, укажите хотя бы у одного из них роль «Утверждено»). Для всех остальных доступна роль «Согласовано»);
- для элемента SecurityLabel (Гриф ограничения доступа к документу)
значение заполняется из Справочника «Коды грифов ограничения доступа к
документу»: «Без грифа», «Конфиденциально», «Коммерческая тайна», «Данный материал запрещается размножать, передавать другим организациям и лицам для целей, не предусмотренных настоящим документом». Рекомендуется не использовать значение «Без грифа» (см. «Важно»).

Важно:
На сервисах, которыми вы будите пользоваться для формирования ЗнП.xml, есть встроенный механизм форматно-логических проверок (далее - ФЛП): см. кнопка «Проверить» на выпадающей справа вкладке сервиса ЕЦПЭ и кнопка «Проверить ошибки и скачать» на xmlonline.

И здесь нюанс:
- если формируете ЗнП.xml на сервисе ЕЦПЭ и в поле строки «Гриф ограничения доступа к документу» выбрали значение «Без грифа» - при проверке XML на соответствие XML-схеме встроенной ФЛП на ЕЦПЭ и при проверке файла ЗнП.xml на сайте https://checkxml.platformaexpert.ru - ошибки не возникает;
- если формируете ЗнП.xml на сервисе https://xmlonline.ru/ и в поле строки «Гриф ограничения доступа к документу» выбрали значение «Без грифа» - при проверке XML на соответствие XML-схеме встроенной ФЛП на xmlonline и при последующей проверке того де файла XML на сайте https://checkxml.platformaexpert.ru - возникает ошибка следующего вида:

https://xmlonline.ru/:

Ошибка:
Содержимое элемента 'Реквизиты документа' не является полным. Заполните элемент 'Гриф ограничения доступа к документу'.
Где ошибка:
Документ: задание на проектирование → Реквизиты документа
№ строки в XML файле: 4
Просмотр ошибки: TypeCode... <Requisites>

https://checkxml.platformaexpert.ru

Ошибка:
содержимое элемента 'Requisites' не является полным. Ожидается один из '{SecurityLabel}'. (33, 15)

В этой связи, при работе на сервисе https://xmlonline.ru/ в поле строки «Гриф ограничения доступа к документу» выбирайте любое другое значение кроме значения «Без грифа». Либо пользуйтесь ЕЦПЭ, либо напишите разработчику сервиса https://xmlonline.ru/ (на сервисе пока есть и другие недоработки).

UPD: проблему «Без грифа» коллеги с xmlonline.ru устранили. Спасибо.

#XML_схема
#Задание_на_проектирование
#Элемент_tDocument_Requisites
#bimsert

Задания на проектирование в xml: ошибка на сервисе формирования ЗнП на ЕЦПЭ

Активно сегодня тестировали возможности создания Задания на проектирование в xml формате на сервисе ЕЦПЭ.

Решили не ограничиваться только лишь встроенной форматно-логической проверкой (ФЛП) на сервисе ЕЦПЭ и проверили сформированный файл ЗнП.xml на внешнем сервисе, что на сайте https://checkxml.platformaexpert.ru (ФАУ «ГГЭ»).

С чем столкнулись.

В рамках встроенных ФЛП проверок на сервисе ЕЦПЭ - проверка файла ЗнП.xml прошла успешно, но на внешнем сервисе checkxml.platformaexpert.ru была выявлена ошибка:

Ошибка: Атрибуту 'SchemaVersion' не разрешено появляться в элементе 'Document'. (4, 217)
Ошибка: Недействительный контент был обнаружен, начиная с элемента 'QualitySolutions'. Ожидается один из '{MarginalCost}'. (93, 44)

При этом, повторимся, на сервисе ЕЦПЭ, встроенная ФЛП проверка файла ЗнП.xml пройдена была успешно.

Перепроверили себя. Описание. Схему. Значения атрибутов в элементах. Но поняли, что ошибка вне нашей зоны ответственности, и обратились в техническую поддержку платформы ЕЦПЭ на адрес support@platformaexpert.ru, предварительно описав ошибку (скопируйте описание ошибки с checkxml.platformaexpert.ru), приложите скриншот ошибки и файл ЗнП.xml. Далее - получили ответ от коллег (ответ во всяком случае пока приходит довольно быстро - менее 5 минут).

Ответ службы технической поддержки:

Добрый день! 
Ошибка в сервисе ЗнП, в ближайшее время планируется исправление. 
Можете вручную добавить -01-00 и проверка будет пройдена.

И вторым сообщение, коллеги любезно оказали услугу, прислали откорректированный в ручную файл, правда сайт checkxml.platformaexpert.ru при повторной проверке по исправленному в ручную файлу коллегами «падает»…но дождемся upd.

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

#XML_схема
#Задание_на_проектирование
#ошибка_ЕЦПЭ
#bimsert

Задание на проектирование в xml
Особенности заполнения элементов:
Элемент EngineeringSurvey (Необходимость выполнения инженерных изысканий для подготовки проектной документации)

Структура элементов:
tEngineeringSurvey
├── Common: tTextBlock (Общие требования)
└─── Choice (Выбор одного из двух вариантов)
│
├── Вариант 1: "Необходимо выполнить инженерные изыскания"
│ ├── Address: tSurveyAddress [1..*] (Адрес)
│ ├── SurveysRequirements: tSurveysRequirements (Требования к изысканиям)
│ ├── DocumentsRequirements: tSurveyDocumentsRequirements (Требования к документам);
│ │ └── Document/@Type (Уникальность)
│ ├── Norms: tNorms [0..1] (Нормативы)
│ └── ReuseDocuments (Переиспользуемые материалы) [0..1]
│ ├── ReferenceToDocumentId: IDREF [1..*] (Ссылка на документ)
│ └── ReferenceToDocumentId (Уникальность)
│
└── Вариант 2: "Использовать материалы прошлых лет"
└── SurveyDocuments (Документы изысканий)
├── ReferenceToDocumentId: IDREF [1..*] (Ссылка на документ)
└── ReferenceToDocumentId (Уникальность).

Условные обозначения:
«[1..*]» - один или несколько элементов (аналог «maxOccurs="unbounded"»);
«[0..1]» - необязательный элемент (аналог «minOccurs="0"»);
«Choice» - выбор одного из вариантов (аналог «xs:choice»);
- «Уникальность» - проверка на уникальность или неповторяемость («xs:unique»).

При заполнении полей в строках дочерних и вложенных элементов обратите внимание на следующие условия их заполнения:
- для элемента tEngineeringSurvey наличие вложенного элемента tTextBlock (Общие требования) всегда является обязательным;
- далее, необходимо выбрать одно из условий, если предметом договора (контракта) является только выполнение проектных работ (разработка проектной и/или рабочей документации), и заказчик передает в составе ИРД в адрес подрядчика ранее выполненные РИИ, то достаточно заполнить атрибуты поля «Переиспользуемые материалы инженерных изысканий и обследований прошлых лет»; если предметом договора (контракта) является одновременно выполнение изыскательских и проектных работ, то необходимо заполнить атрибуты полей «Общие требования» через выбор значения из списка «Местоположение района (площадки, трассы) проведения инженерных изысканий», «Требования к инженерным изысканиям (по виду изысканий)», Требования к содержанию выпускаемых документов (по виду документа)», «Перечень ссылок на нормативные документы. При этом, атрибуты элемента «Переиспользуемые материалы инженерных изысканий и обследований прошлых лет» (если планируется использовать) также может быть заполнен как и для случая, когда предметом договора (контракта) является только выполнение проектных работ, если наряду с проведением новых инженерных изысканий будут использоваться еще и материалы прошлых лет.
- при заполнении атрибутов «Переиспользуемые материалы инженерных изысканий и обследований прошлых лет» необходимо указать в составе атрибута «IDREF» (ссылка на ID ранее описанного документа)* значение из элемента tContent / DecisionDocuments (Перечень документов, являющихся основанием для проектирования объекта строительства). Причем значение должно начинаться с букв ID или id (регистр букв и цифр должен совпадать со аналогичным значение указанного документа в элемента tContent / DecisionDocuments (см. слайд). Вот почему важно при описании вложенных элементов раздела «Перечень документов, являющихся основанием для проектирования объекта строительства» не забыть описать все ИРД, присвоив им соотвествующие значение их ID. См.слады.
___
* «IDREF» - тип данных, который ссылается на уникальный идентификатор («ID») некого документа, который уже содержится где-то в том же XML-документе и описан ранее. В отношении атрибута «IDREF» установлена проверка не повторяемости, т.е. атрибут не должен содержать дубликатов в виде ссылок на один и тот же документ. Отличие атрибута «IDREF» от «ID»:
- «ID» - уникальный идентификатор (как первичный ключ);
- «IDREF» - как ссылка на «ID».

#XML_схема
#Задание_на_проектирование
#Элемент_EngineeringSurvey
#bimsert