Расширение функционала EPLAN. Создание простого Add-Ina на C#
Расширяем функционал EPLAN при помощи Add-Inов на C#
Применение EPLAN
• Автомобилестроение
• Машиностроение
• Металлургия
• Химическая и фармацевтическая промышленность
• Пищевая промышленность
• Добыча нефти и газа
• Трубопроводный транспорт
• Нефте- и газо-переработка
• Производство тепла и электроэнергии
• Передача и распределение электроэнергии
• Железнодорожный транспорт
• Водоснабжение и водоотведение
• Станкостроение
• Легкая промышленность
• Автоматизация зданий
Основные модули платформы
• EPLAN Electric P8 — Модульное и масштабируемое решение для электротехнического проектирования, автоматического создания проектной и рабочей документации.
• EPLAN Fluid — Программное обеспечение для проектирования пневмо/гидроавтоматики, систем смазки и охлаждения и автоматического создания соответствующей проектной и рабочей документации
• EPLAN ProPanel — 3D проектирование электротехнических шкафов с передачей данных в производство. Виртуальное трехмерное моделирование, создание двух- и трех- мерных чертежей, трехмерное изображение проводных и маршрутных схем, наличие шаблонов для работы сверлильного оборудования и интеграция со станками ЧПУ
• EPLAN PrePlanning — программное обеспечение для предварительного (эскизного) проектирования объектов и генерации проектной документации.
• EPLAN Engineering Center — Решение для функционального проектирования. В данном модуле пользователь задет граничные параметры проекта, а само проектирование осуществляется системой автоматически по определенным правилам.
Про расширение функционала
EPLAN – гибкая платформа, позволяющая расширять функционал с помощью скриптов и Add-Inов. Рассмотрим только Add-Inы, поскольку скрипты (сценарии) дают гораздо меньшую свободу действий.
Add-In – это надстройка, дополняющая и расширяющая базовый функционал, предлагаемый EPLAN. Add-In создается при помощи API EPLAN, который, в свою очередь, использует dotNET и поддерживает 3 языка программирования: Visual Basic, C++ и C#. Порядок создания Add-Inов одинаков для всех вышеуказанных языков. Информация по API EPLAN находится в справочнике EPLAN API-Support (в формате *.chm), поставляемом вместе с документацией.
Процесс создания Add-Ina
Рассмотрим непосредственно процесс создания Add-Inов.
1. Для начала, так как используется среда dotNET, создаем проект Class Library в MS Visual Studio.
2. Далее подключаем к проекту библиотеки EPLAN API.
3. Пишем код инициализации Add-Inа
Для регистрации и инициализации Add-Ina, наш класс должен наследовать интерфейс IEplAddIn (подробнее в EPLAN API-Support). Создадим пункт меню в Главном Меню EPLAN и добавим в него одно действие (Action).
Методы OnRegister и OnUnregister вызываются по одному разу, при первом подключении и удалении Add-Ina соответственно.
Метод OnExit вызывается при закрытии EPLANa.
Метод OnInit вызывается при загрузке EPLANa для инициализации Add-Ina.
Метод OnInitGui вызывается при загрузке EPLANa для инициализации Add-Ina и пользовательского интерфейса.
4. Пишем код действия (Action), который будет в нашем меню. Действие (Action) должно наследовать интерфейс IEplAction (подробнее в EPLAN API-Support).
Метод OnRegister регистрирует наш Action под указанным именем.
Метод Execute выполняются при вызове Actiona из платформы EPLAN. В данном случае метод Execute выбирает текущий проект, считывает из него три поля, а именно, название проекта, название фирмы и дату создания, и затем выводит их в MessageBox.
Метод GetActionProperties возвращает описание нашего Actiona (только для документирования).
5. Имя скомпилированной DLL-библиотеки должно соответствовать следующему правилу:
Eplan.EplAddIn.XXXX.dll
где XXXX – это имя вашего Add-Ina
Подключение Add-Ina
К платформе Add-In подключается следующим образом:
1. Выполняем «Сервисные программы»
– «API-AddIns…»
2. Жмем на кнопку «Загрузить»
3. В открывшемся окне выбираем Add-In и нажимаем «Открыть»
4. Кликаем на кнопку «ОК». Add-In загружен и готов к работе.
При загрузке Add-In инициализируется пункт меню «Тест», раскрыв который мы видим наше действие (Action), описанное в Action_Test.
Посмотрим на результат работы Add-Ina:
Нажимаем на пункт меню «Тест» – «Информация по проекту»
Платформа EPLAN предоставляет большой базовый функционал. Однако иногда требуются действия, не входящие в него. В простейших случаях можно создавать и подключать скрипты (сценарии), но если требуется глубокий доступ к данным, необходимо воспользоваться API, создавать и использовать Add-Inы.
Проектные настройки в Eplan
В этой статье мы поговорим о проектных настройках Eplan. Я буду объяснять каждый параметр или настройку, и рассказывать какие я использую, а какие нет и почему. так, у нас создан первый проект и первым делом мы заходим во вкладку “Параметры” и далее выбираем “Настройки”. В Eplan различают следующие категории настроек: «Проект», «Пользователь», «Рабочая станция» и «Фирма».
С помощью проектных настроек можно указать все свойства проекта. Проектные настройки разделяются по электротехническим функциям. Для проектных настроек в программе заданы стандартные значения, которые можно изменить и сохранить вместе с проектом. Программа загружает эти проектные настройки, когда вы или другой пользователь открывает проект. При этом неважно, на какой рабочей станции работает соответствующий пользователь.
Настройки проекта в Eplan Electric P8 — последовательность действий
Заходим в “Проекты” → “Графическая обработка”.
В раскрывающемся списке выбираем “Виды шрифтов”. В этом диалоговом окне указываются виды шрифтов, которые используются при работе в EPLAN. При этом заданные в настройках проекта виды шрифтов имеют преимущество перед видами шрифтов, заданными в фирменных настройках. Если вид шрифта занесен в настройки проекта, которые отсутствуют на компьютере, соответствующий вид шрифта берется из фирменных настроек. В списке “Вид шрифта 1” выбираем нужный шрифт. Я использую шрифт “Gost Type B Eplan” как наиболее удобный. Его можно Вы можете скачать у нас с сайта и затем инсталлировать у себя на рабочей станции. После инсталляции он сразу же появится в списке. “Вид шрифта 2-10” оставляем без изменений. Там везде оставляем шрифт “Из фирменных настроек”. Так как для всех задач нам вполне хватит одного шрифта. А если Вам не хватает, то назначайте другие виды шрифтов, а затем применяйте их в конкретной задаче.
В квадратике “Отобразить увеличенные тексты” рекомендую ставить флажок. Но это совсем не обязательно. Эта опция существует только в настройках проекта. Если этот флажок установлен, тексты увеличиваются, как в предыдущих версиях EPLAN прибл. на 20 %. Рекомендуется устанавливать этот флажок только в том случае, если необходимо точно сохранить формат проектов, созданных с помощью предыдущих версий eplan electric p8. Если этот флажок не установлен, отображение и распечатка текстов выполняются соответственно масштабу.
Выходим из меню “Виды шрифтов” и заходим в меню “Общее”.
Здесь мы видим элемент “Отображать ответвления соединений”. В этом групповом поле указывается, каким образом в схеме соединений будут представлены символы соединений:
Я выбираю “Как начерчено”. И по умолчанию рисую символы соединений с ориентацией на цель.
“Отображать обозначения выводов устройства в повернутом виде” — При создании символов можно создать два набора обозначений вывода устройства: один с обычными обозначениями выводов устройства, а другой с обозначениями, повернутыми на 90 градусов. например, они используются для обработки согласно стандарту DIN. По умолчанию этот флажок снят и используются не повернутые обозначения вывода устройства. Установите этот флажок, чтобы использовать в проекте повернутые обозначения вывода устройства. В своих проектах я еще ни разу не использовал это свойство. Думаю оно не пригодится и Вам.
“Инвертировать последовательность поиска для выводов устройства ПЛК” — в случае выводов устройства ПЛК и выводов устройств поиск функциональных текстов путей сначала выполняется против направления вывода устройства, а затем (если в этом направлении ничего не было найдено) поиск производится в направлении вывода устройства. Установите этот флажок, чтобы инвертировать последовательность поиска (т. е. поиск должен начинаться в направлении вывода устройства). Эту опцию для своих проектов я не использовал еще. Поэтому оставляем ее неактивной.
“Использовать альтернативный порядок свойств” — в символах по ГОСТу (государственному стандарту Российской Федерации) обозначение устройства должно размещаться справа или справа вверху от графики символа.
Если он установлен, то для вставленных специальных символов проекта на вкладке Отображение параметру Порядок свойств по стандарту ГОСТ присвоено значение «Станд. знач. по умолч. (альтернативно)». Для тех символов из библиотеки, которые не имеют соответствующего порядка свойств, установка проходит без изменений — они сохраняют исходный стандартный порядок свойств.
Скажу честно, я стараюсь уходить от старых и неактульных ГОСТов настолько насколько это возможно и использую стандарты МЭК, который, в частности, устанавливает обозначение устройства слева (слева вверху). Да и впринципе это и правильно и логично. Ведь ток в конце концов течет по схеме слева на право и снизу вверх, а не наоборот и поэтому не получится никогда графического пересечения проводов и обозначения. Но это мое мнение. Приглашаю Вас принимать участие в форуме и доказывать свою точку зрения.
“Настроить толщину линии при вставке макроса согласно масштабу страницы”. Если этот флажок установлен, толщина линии масштабируется при вставке макроса; при этом действуют следующие правила:
Если после перерасчета толщина линии лежит между одним из значений 0,13 мм, 0,18 мм, 0,25 мм, 0,35 мм, 0,5 мм, 0,7 мм, 1,0 мм и 2,0 мм, ее параметр округляется до ближайшего значения. Пример, пересчет толщины линии приводит к значению 0,31 мм. Оно округляется до следующей подходящей толщины линии, 0,35 мм.
Далее выходим из вкладки “Общие” и переходим во вкладку “Указание размеров”. В этом диалоговом окне можно указать, как будут отображаться числовые меры и линии с размерами и какая единица будет использоваться для указания размеров.
“Вид шрифта” — в раскрывающемся списке представлены виды шрифтов, которые были определены в проектных или фирменных настройках. Можно выбрать требуемый вид шрифта. Виды шрифтов выводятся в списке в той последовательности, в которой они были присвоены видам шрифтов от 1 до 10 в проектных или фирменных настройках. Если изменить вид шрифта в проектных или фирменных настройках, то он автоматически обновляется и в списке. У меня стоит вид шрифта “GOST type B EPLAN”.
EPlan. Вступительное слово
О таком программном продукте как EPLAN Electric P8 (далее EPLAN) слышали многие инженеры, разрабатывающие электротехнические проекты. Это мощный инструмент, способный значительно облегчить жизнь разработчику, сократить количество ошибок в выдаваемой документации и значительно уменьшить время работы над ней. Но, как и любой инструмент, EPLAN требует от пользователя знаний и умений работать в своей среде. Вот этим знаниям и умениям посвящен настоящий цикл статей.
1. Краткая справка
EPLAN Electric P8 разработан и поддерживается немецкой компанией EPLAN Software & Service (www.eplan.de), которая является дочерним предприятием известного производителя электротехнической продукции Rittal. Помимо программных решений в сфере электротехники (сюда я включаю и промышленную автоматизацию), EPLAN Software & Service предлагает продукты для разработки пневмогидравлических и механических решений. В России компания имеет представительство, официальный сайт которого http://www.eplan-russia.ru/. Там можно почерпнуть больше маркетинговой и рекламной информации, а также скачать демо-версию программного продукта.
2. Функциональность
Прежде чем перечислить основные функциональные возможности EPLAN, разберемся, что же он из себя представляет. EPLAN — это программная система автоматизации проектных работ (САПР).
Напомню, что среди САПР выделяют CAD-, CAM-, CAE-системы.
CAD-системы (сomputer-aided design) — системы поддержки проектирования, предназначенные для решения проектно-конструкторских задач и оформления технической документации.
CAM-системы (computer-aided manufacturing) — системы поддержки изготовления, предназначенные для проектирования обработки изделий на станках с числовым программным управлением (ЧПУ) и выдачи программ для этих станков.
САЕ-системы (computer-aided engineering) — системы поддержки инженерных расчетов (системы инженерного анализа), каждая из которых позволяет решать определенную расчетную задачу (группу задач), начиная моделированием электрических и тепловых процессов, заканчивая расчетом на прочность, формированием технологических карт изготовления изделий.
Компания EPLAN Software & Service позиционирует свой продукт как CAE-систему. Но так ли это? Программа не рассчитает за инженера номинальные токи и токи короткого замыкания, не построит кривые селективности. С точки зрения инженерных расчетов EPLAN беден, хотя и обладает потенциалом, благодаря модульности своей архитектуры. Зато при должной настройке эта САПР позволит разработчику построить свой проект из стандартных блоков, несколькими операциями наполнить их содержанием, затем одним кликом сгенерировать необходимую отчетную документацию, просуммировав при этом необходимые, но разбросанные по схемам параметры и свойства.
Среднестатистический пользователь, скорее всего, не столкнется с расчетными модулями, о которых нет-нет появляется информация на семинарах и презентациях. И тем не менее, сказать, что работает в чертежном пакете вроде AutoCADа, он не сможет. Поэтому я говорю об инструменте проектировщика, находящемся где-то между CAD и CAE уровне.
— проектировать электрические цепи, используя при этом базу изделий, библиотеки символов элементов, рамки для оформления схем;
— организовывать иерархическую структуру для проекта, обеспечивая включение в нее данных других форматов;
— автоматизировать рутинные операций, такие как: именование элементов схемы, нумерация страниц проекта, обозначение соединений, подбор изделий по параметрам и т. д.
— формировать схемы подключения, клеммные колодки, кабельные журналы, спецификации;
— создавать панели пультов и электрошкафов и перечни элементов к ним;
— импортировать и экспортировать данные в DXF, PDF формат;
— гибко настраивать интерфейс среды проектирования.
3. Конкуренты
Конкурентами EPLAN являются AutoСAD (AutoCAD Electrical), КОМПАС (КОМПАС Электрик), E3-series, NanoCad.
Проводить сравнительный анализ, дело не благодарное. У каждого инженера есть свои предпочтения, а у каждого продукта — достоинства и недостатки.
Применение EPLAN оправдано в случаях:
— разработки крупных проектов, при участии большого количества разработчиков;
— у вас есть достаточно денег, чтобы оплатить лицензионную версию (цена, кстати, кусается).
4. Особенности
Разработчиком EPLAN является немецкая компания. Не смотря на довольно качественный перевод как интерфейса, так и справки, сам продукт имеет значительный налет иностранного влияния. Изначально разработанный под европейские стандарты и методы проектирования, EPLAN не всегда можно адаптировать под российские требования. Ну и конечно, отсутствие достаточного количества учебников и методических материалов делает САПР трудно и болезненно осваиваемым для отечественного инженера.
EPlan. Отчет об эксплуатации
В глобальном плане, с тех самых пор, как в далеком уже 2009 году я прошел базовый курс обучения Eplan Electric P8, внедрил это программное средство в процесс разработки схемотехнических решений на нашем предприятии, ничего не изменилось. Мы по прежнему рисуем схемы в EPlan.
С того времени в самом продукте произошло много изменений ( http://www.eplan-russia.ru/ ru/kompanija/novosti/vse- novosti/ ), но мы их специально не отслеживали. Как работали с EPLAN Electric P8 2.1 SP1, так и работаем. И тому есть много причин, о которых, с учетом уже многолетнего опыта я и хочу поведать.
1) Когда наша команда столкнулась с этой платформой первый раз, все были очарованы тем, что часть рутинных функций автоматизирована. Это казалось большим достижением. Повышение эффективности и все такое. Был запал и интерес, чуть-чуть поработали на демке, потом купили одну лицензионную копию. Я сходил на курсы, написал методичку для сотрудников, которым по роду деятельности надо было разрабатывать схемы. Стали работать. Сейчас, с учетом накопленного житейского опыта, я бы уже так не поступил… В смысле — не стал торопиться.
Сначала я бы внимательно изучил рынок, пригласил промоутеров с презентациями, потом провел тендер и после принимал решение, на чем строить глобальный процесс проектирования с учетом будущего развития компании. Цена, оптимальное решение стоящих перед предприятием задач, наличие учебной литературы (напоминаю, мне пришлось самому разрабатывать методички), наличие квалифицированных пользователей на рынке труда, качество технической поддержки, востребованность формата данных, возможность реализовать дополнительные функции — это первые критерии отбора, сразу приходящие на ум.
За время работы ко мне много раз приходили представители компаний, продвигающие тот или иной софт. И скажу, что многие из них предлагали программное обеспечение не хуже, а по каким-то параметрам и лучше, нежели EPlan. Но, увы, мы когда-то потратили приличные деньги — и менять что-либо (особенно в условиях не проходящего кризиса) стало поздно.
2) EPlan для нас остался узкоспециализированным программным продуктом, для которого была наработана база типовых схем и база элементов в виде Microsoft SQL Server. Теперь задача «что-либо разработать «с нуля»» уже практически не ставится. Используется шаблонный проект (которые уже на все случаи жизни), немного дорабатывается, меняется комплектация согласно ТЗ. Все! Выпускается документация. Работа с программным продуктом сведена к минимуму. Менять что-либо, даже для большего удобства сотрудников слишком затратно. Не то нынче время, чтобы проводить эксперименты. Работает, отлажено — и бог с ним. Еще раз подчеркну, EPlan используется только для разработки схем, ни для каких других задач нам его настроить не удалось.
3) С определенными для него задачами EPlan справляется, хотя иногда и выдает необъяснимые сюрпризы, как правило, в спецификациях. И некоторые полезные функции автоматизировать так и не удалось, например, маркировку проводников. Для нас это ручная операция, увы. Еще одна беда, которая иногда случается с нами — KKS. Кто в курсе, тот поймет.
4) Я сознательно не акцентирую внимание на тех самых задачах, с которыми EPlan справляется на «отлично». О них вам расскажет любой представитель компании-разработчика. А вот о проблемах и минусах применения им говорить, думаю, запрещено. Поэтому пройдемся по тем, критериям отбора, о которых я написал выше. Так что с ними?
а) Цена.
б) Оптимальное решение стоящих перед компанией задач.
У каждой организации задачи свои, повторюсь. Но надо думать и на перспективу. Пока у нас не было своего щитового производства, схем и эскизов щитов было достаточно. Полноценным строительным проектированием тоже тогда не занимались, работали с известными Заказчиками, которых предоставленная в pdf-версии документация устраивала. Пусть не по ГОСТ, зато в достаточном для эксплуатации объеме. Потом стало хуже… С эскизами, кстати, были проблемы. Мы потратили уйму времени, чтобы подвязать к базе габаритные размеры, макросы внешних видов для оборудования… но все работало в EPlan так криво и косо, что практика готовить чертежи в нем не прижилась. При значительном количестве элементов весь внешний вид шкафа подвисал и что-то скорректировать, добавить становилось все труднее. Почему так, выяснить не удалось. Спрашивали службу технической поддержки, цитирую:
Как итог — инженерам легче и быстрее было накидать чертежи в КОМПАСе или даже nanoCADе.
Появилось щитовое производство, потребовалась 3d модель ошиновки и мы логично стали делать ее в КОМПАСе, благо элементная база была уже частично подготовлена. Исполнители от EPlan в этом разрезе плевались, поэтому тогдашний ECabinet даже не рассматривали. Может субъективное и эмоциональное решение, но какое есть! Купили КОМПАС. Знаю, что теперь функции ECabinet входит в EPlan штатно, но опять же, тратить время на создание базы, чтобы посмотреть, как это все теперь работает, мы уже не будем.
в) Учебная литература.
На этапе 2010-2011 годов полный провал политики компании-разработчика. Сначала было только дорогостоящее обучение в офисе компании, потом вышла одна книга (покупали в офисе и тоже за весьма дорого). В комплекте с продуктом, конечно, имелись обзор «Начало работы» и справочная система на русском языке. Начать работать можно, но функционал освоить в полной мере не получится. О справке вообще можно говорить бесконечно долго — удивительная штука! Вроде описано все, но при этом так, что разобраться без знания основ (то есть без предварительного обучения) ну никак! Очень много времени ушло сначала на самостоятельное освоение программы, потом после обучения (пошел потому, что было чувство, что половину функций так в полной мере запустить не удалось, хотя читали всем отделом методички и на немецком — сервер поднимали по ним) — на написание методичек. После выхода книги и запуска технической поддержки стало легче. Сейчас ситуацией не интересовался, уже не нужно.
г) Наличие квалифицированных пользователей на рынке труда.
На первом этапе тоже картина была печальная. Так, чтобы взять сотрудника и посадить работать, ну никак. EPlan долго был экзотикой. В последние годы ситуация изменилась. Регулярно встречаются резюме кандидатов, работавших в EPlan. Но, конечно, не так часто, как в AutoCAD и КОМПАС. И еще! Как мы стали выпускать проектную (рабочую) документацию для строительства, от нас постоянно требуют электронные комплекты документации в редактируемой форме AutoCAD. Экспортировать страницы из проекта EPlan в файлы dwg возможно, вопрос цены. Скажу так, времени и усилий это занимает достаточно. Я имею в виду нормальный экспорт, чтобы можно было с документами работать, читать, редактировать. Ладно, один раз пройти процедуру конвертации допустимо. Так при любом изменении документации — все по новой. А в уже сконвертированных файлах редактировать потом не вариант, оригиналы-то в EPlan, да и ошибок можно допустить больше… Геморрой, одним словом.
д) Полнота технической поддержки.
Сейчас вопросом не интересовался, а ранее за доступ к телу эксперта требовалось платить. Сопровождение на год стоило денег не самых маленьких. Качество среднее. Отвечали оперативно, но ответы бывали иногда мутными, проблему не решали. Ну тут, наверное, как у всех.
е) Востребованность формата данных.
По сути уже написано. За все время работы с различными компаниями в России только два раза у нас приняли документацию в формате EPlan. И один раз на заводе «Фольксваген» в Калуге.
ж) Возможность реализовать дополнительные функции.
Ну вот были у нас две интересные идеи.
→ Первая, скрестить базу EPlan с 1С. Очень удобно, генерируешь спецификацию, а по ней автоматически списывается комплектация под проект. Посидел наш программист 1С над ней да и плюнул. Решения, конечно, есть разные. Но надо как-то сначала синхронизировать базы. В общем, документированной возможности у EPlan нет, а самим ковырять — овчинка выделки не стоит.
→ Но и более приземленная идея потерпела крах. Хотели хотя бы проекты АСУТП компоновать в проекте EPlan. Там ведь много документов: текстовые, схемы и планы CAD, рисунки — все в разных форматах. Казалось бы, создал структуру в менеджере проекта, добавляй файлы, удобно… и тут сразу из ниоткуда возникают проблемы с поддержанием актуальной версии составляющих проект документов. Изменения в них вносятся постоянно, разными исполнителями, отследить невозможно. Обновляются в проекте не всегда! Там поди разберись, заменили ли файлы в самом проекте, все мамой клянутся, что так и делали, но получилась какая-то ерунда. Но даже это вопрос больше организационный. Пронумеровать автоматически внешние файлы нельзя — все вручную. И самое печальное, не сделать из этого массива данных единого файла pdf для Заказчика. Внес два изменения, заново и вручную все компоную. Ерунда получается. При объеме даже в пару десятков проектных файлов — ну его к черту. Легче просто в папке одной все держать и там работать, пусть без структуры.
→ Расчет кабельной продукции. Не знаю, как сейчас, но раньше представители EPlan хвастались, что сделали макрос, автоматом считающий длину кабеля в зависимости от масштаба на графическом документе. В стандартный комплект программы это, естественно, не включалось. А реализовать самим… ну система EPlan настолько закрытая система, что написать макрос самостоятельно…
з) Адаптация к требованиям ГОСТ.
Больная тема для любого иностранного программного продукта.
Есть рамки по ГОСТ, можно доделать библиотеку символов, шаблоны разные. Есть отчеты, не все, которые нужны, но есть. Какие-то из них можно довести до ума, какие-то нет. По хорошему надо держать отдельного человека, который будет всем этим заниматься. Базы поддерживать актуальные, стандарты обновлять, внедрять, рассылать, исправлять… Но дорого это.
После того, как мы ушли из уютного мира проверенных Заказчиков, много раз сталкивались с тем, что схемы, разработанные в EPlane не устраивают конечного пользователя. Им надо все кондово, как в Советском Союзе. Чтобы на каждой строчки спецификации была одна строка текста, например. Поди такого добейся от буржуйского продукта…
Далее, при наличии времени буду адаптировать и выложу некоторые материалы моих методичек.