Справка|Инструкция для разработчиков

Инструкция для разработчиков программ по автоматизации проектирования

Общие положения

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

Описание всех элементов файла вы можете прочитать в разделе описание файла XML.

Создание XML файла посредством Excel

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

Настройка файла Excel под персональные требования.

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

Сделать это очень просто. Откройте скачанный с нашего сайта файл Excel и запустите редактор кода. (Нажмите сочетание клавиш Alt+F11). Файл XML устроен так, что все узлы должны быть обязательно, но некоторые узлы могут иметь пустые значения. Соответственно на чертеже они отображаться не будут. Для примера, давайте уберем из раздела "Общие данные" строку "Разработал". Вот как выглядит код, для создания этого элемента:

		'Добавление элемента "author"
		Set child = XML.createElement("author")
		child.Text = Range("start_common").Offset(10, 2).Value	
		stamp.appendChild child
		
Исправив всего одну строчку вот таким образом:
child.Text = ""	
мы получим в файле XML в элементе "author" пустое значение. И, соответственно, в листе Excel эта строчка нам больше не нужна. Таким образом можно удалить все ненужные строки, если в описании файла XML не указано, что данные в узле должны соответствовать определенному паттерну или в узле должны быть цифры. В подобные узлы нельзя вносить пустые значения, но можно установить значения по умолчанию. Например возьмем строку "Дата" в разделе "Общие данные". Вот как выглядит код для создания этого элемента:
		'Добавление элемента "date"
		Set child = XML.createElement("date")
		child.Text = Range("start_common").Offset(13, 2).Value
		stamp.appendChild child
изменим строку следующим образом:
child.Text = "01.01"
и теперь в поле дата всегда будет выводится значение по умолчанию "01.01", и данная строчка в листе Excel на больше не нужна.

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

Если вы совершенно не разбираетесь в языке VBA или не хотите разбираться, то обратитесь в наш отдел разработки. Мы можем выполнить за вас эту работу быстро и качественно. Все вопросы по стоимости и срокам исполнения вы можете задать нашим разработчикам.

Создание XML файла посредством других программ

Тут мы, к сожалению, бессильны. Обратитесь к документации своей программы.

Проверка файла XML на правильность вводимых данных

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

Проверка осуществляется путем верификации файла XML на соответствие схеме документа. Файл XSD со схемой документа вы можете скачать в разделе Файлы.

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

Тестирование файла XML

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

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

Успехов вам и плодотворной работы!