Code Builder — интегрированная среда разработки в составе Winlog, предназначенная для расширения функциональности и настройки приложения. Её язык позволяет взаимодействовать со всеми компонентами Winlog Evo — портами, мнемосхемами, рецептами, отчётами и другими, — а редактор автоматически проверяет корректность синтаксиса. Через Code Builder реализуют циклы, условия и функции (макросы), которые выполняются автоматически или по команде оператора.

Где находится Code Builder и как он связан с другими инструментами

Точка входа в разработку — Project Manager, интегрированная среда с набором инструментов. В неё входят Gate Builder, Template Builder, Code Builder, Application Builder и другие средства. Project Manager же обеспечивает доступ к редактору переменных (Gate Builder), редактору шаблонов (Template Builder) и редактору программного кода (Code Builder).

Полезно понимать разделение задач между инструментами:

  • Gate Builder — редактор переменных. В Winlog поддерживаются численные, цифровые (дискретные), строковые и составные переменные, события и тревоги. Для каждого тэга настраивается частота обновления данных, запись в архивы, блочное чтение, запись по изменению; переменные импортируются и экспортируются в csv-файлы.
  • Template Builder — визуальное средство создания мнемосхем и video pages. На экран размещают объекты (bitmap, metafile, текст, значения, status bar, LED, controls) и определяют их свойства. Каждому объекту мнемосхемы можно назначить управление, доступное только авторизованным группам пользователей по уровням паролей.
  • Code Builder — редактор внутренних программ, то есть собственно логики проекта.

Таким образом, переменные и экраны создаются в своих редакторах, а Code Builder связывает их в работающую логику. Это не замена Gate Builder или Template Builder, а слой программирования поверх них.

Что умеет язык Code Builder

Язык задуман простым, но охватывает все элементы проекта Winlog Pro: переменные, шаблоны, рецепты, отчёты. На нём можно:

  • строить циклы;
  • задавать условия;
  • создавать функции (макросы), выполняемые автоматически или по команде оператора.

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

Типовые задачи для макросов хорошо видны по смежным подсистемам Winlog. Рецепты — это наборы характерных значений рабочего процесса или конфигурации аппаратуры; их можно создавать, обновлять, импортировать и экспортировать во время процесса, а запуск рецепта может инициировать оператор, он может выполняться автоматически при запуске или вызываться по программе. Отчёт может быть создан оператором, автоматически по циклу (интервал, день недели) или программой. Именно «по программе» и «по команде оператора» — зона ответственности функций Code Builder.

Как функции запускаются на выполнение

У функций (макросов) два режима вызова, и это ключевое для проектирования:

Способ запуска Когда используется
Автоматически Логика выполняется без участия человека: при старте, по циклу, при наступлении условия в проекте
По команде оператора Действие инициируется с мнемосхемы или через элемент управления

Автоматический запуск удобен для периодических расчётов, контроля уставок и обработки событий. Командный — для операций, которые оператор должен подтвердить осознанно: смена рецепта, формирование отчёта, переключение режима. Поскольку управление объектами шаблона назначается с определённым уровнем доступа, командные макросы естественно встраиваются в систему разграничения прав.

Code Builder в контексте остальных Builder'ов

Чтобы выбрать правильный инструмент, полезно сравнить их назначение.

  • Application Builder — инструмент автоматического создания SCADA-приложений, значительно сокращающий время разработки. Приложение строится выбором из библиотеки и комбинированием объектов, представляющих устройства различных производителей. Программные объекты включают шаблоны диспетчеризации и конфигурации (лицевая панель, тренды и т. д.), а также список событий и аварий с процедурами обработки. Объекты включают тэги, протоколы, шаблоны и информацию для управления устройством и его программирования.
  • Template Builder — не только мнемосхемы: он позволяет создавать web templates для Web Client, предоставляет графическую библиотеку с тысячами статических символов в векторном формате SVG и библиотеку цифровых анимированных объектов (кнопки, переключатели, индикаторы), аналоговых объектов (стрелочные индикаторы, потенциометры, LED-дисплеи) и сложных объектов.
  • Smart App Builder — интерактивный инструмент быстрого создания веб-приложений Smart App, оптимизированных для мобильных устройств iOS и Android. Структура Smart App — меню из категорий, элементов и подэлементов с навигацией, аналогичной мобильным устройствам, а данные каждого элемента отображаются стандартными элементами управления: Label, StatusBar, Bitmap UpDown, Edit Box, Slider, Combo Box, N-States Box, Switch.

Логика проекта, написанная в Code Builder, дополняет все эти слои: Application Builder собирает приложение из готовых объектов, Template Builder рисует экраны, а Code Builder программирует поведение, которое не покрывается настройками.

Практические замечания

Несколько моментов, которые стоит держать в голове при работе с редактором кода.

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

Проверка синтаксиса — не проверка логики. Автоматический контроль корректности синтаксиса в редакторе ловит ошибки записи конструкций, но не гарантирует, что алгоритм ведёт себя правильно в технологическом процессе. Тестирование сценариев остаётся за разработчиком.

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

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

Профиль проекта определяет набор инструментов. Пакет WinLog Pro построен по модульному типу и включает среду разработки и среду исполнения (RunTime). «Run-time»-лицензия не позволяет вносить изменения в исполняемый проект, добавлять и удалять переменные — следовательно, правка функций Code Builder возможна только в среде разработки.

Частые вопросы

Что такое Code Builder в Winlog Evo? Это интегрированная среда разработки для расширения функциональности и настройки приложения. Она входит в набор инструментов Project Manager наряду с Gate Builder, Template Builder и Application Builder.

С какими компонентами можно взаимодействовать через язык Code Builder? Со всеми компонентами Winlog Evo: портами, мнемосхемами, рецептами, отчётами и другими. В Winlog Pro тот же язык даёт доступ к переменным, шаблонам, рецептам и отчётам.

Можно ли создавать циклы, условия и функции (макросы)? Да, язык позволяет определять циклы, задавать условия и создавать функции (макросы). Редактор предоставляет доступ ко всем функциям и конструкциям языка и позволяет вставлять их в проект.

Как макросы запускаются на выполнение? Двумя способами: автоматически или по команде оператора.

Проверяет ли редактор синтаксис автоматически? Да, редактор автоматически проверяет корректность синтаксиса при работе с кодом проекта.

Что входит в Project Manager? Интегрированная среда разработки с набором инструментов: Gate Builder (редактор переменных), Template Builder (редактор шаблонов), Code Builder (редактор программного кода), Application Builder (разработчик прикладных систем) и другие средства.