Справочник V11 - Энергосистемы...Справочник V11.0 5 В данном Справочнике есть больше, чем кажется на первый

Справочник V11.0


1

Содержание 1. Об этом руководстве ............................................................................................................... 4

2. Как использовать поиск .......................................................................................................... 4

2.1 Поиск по справке ............................................................................................................... 4

2.2 Основные особенности поиска ........................................................................................ 5

2.3 Расширенные методы поиска .......................................................................................... 7

3. Установка программного обеспечения ................................................................................. 9

4. Проект и библиотека .............................................................................................................. 9

4.1 О проектах .......................................................................................................................... 9

4.2 О конфигурационных файлах проекта .......................................................................... 11

4.3 Что такое библиотека ? ................................................................................................... 13

4.4 Совместимость с проектами и библиотеками, созданными в предыдущих версиях

Супервизора .......................................................................................................................... 20

4.5 Сохранение и восстановление проектов и библиотек ................................................ 22

4.6 Использование шаблона проекта .................................................................................. 25

5. Использование централизованного управления проектом .............................................. 26

5.1 О централизованном управлении проектом ................................................................ 26

5.2 Создание и управление версиями проекта .................................................................. 28

5.2.1 Окно Централизованное управление проектом ................................................... 28

5.2.2 Как создать новую версию ...................................................................................... 31

5.2.3 Как обновить существующую версию .................................................................... 32

5.2.4 Как изменять статус версии ..................................................................................... 33

5.3 Как использовать контроль версий с библиотеками ................................................... 34

5.4 Как выбрать и загрузить версию при запуске проекта ................................................ 36

5.4.1 Как выбирать версию проекта при запуске ........................................................... 36

5.4.2 Использование ключа -r в командной строке ....................................................... 37

5.4.3 Использование ключа -x в командной строке ....................................................... 37

5.4.4 Использование ключа -d в командной строке ...................................................... 39

5.5 Переменные центрального управления проектом ...................................................... 40

5.6 Пример централизованного управления проектом .................................................... 41

6. Конфигурация среды ............................................................................................................ 43

6.1 Интерфейс ........................................................................................................................ 43

6.1.1 Рабочая область ....................................................................................................... 43


2

6.1.2 Изменение свойств рабочей области ..................................................................... 45

6.1.3 Поддержка мыши IntelliMouse ............................................................................... 47

6.1.4 Использование регионов ........................................................................................ 48

6.2 Application Explorer .......................................................................................................... 49

6.2.1 Что такое Application Explorer .................................................................................. 49

6.2.2 Окно Application Explorer ......................................................................................... 51

6.2.3 Использование операций вырезать, копировать и вставить в Application

Explorer ............................................................................................................................... 54

6.2.4 Объекты Application Explorer, поддерживающие операции вырезать,

копировать и вставить ...................................................................................................... 56

6.3 Smart Generator ............................................................................................................... 58

6.3.1 Что такое Smart Generator? ..................................................................................... 58

6.3.2 Работа Smart Generator ............................................................................................ 59

6.4 Application Architect ........................................................................................................ 60

6.4.1 Что такое Application Architect?............................................................................... 60

6.4.2 Окно Application Architect ........................................................................................ 61

6.4.3 Вкладка Шаблоны .................................................................................................... 62

6.4.4 Вкладка Параметры ................................................................................................. 64

6.4.5 Вкладка Экземпляры ............................................................................................... 65

6.4.6 Свойства .................................................................................................................... 66

7. О проектах Супервизора ....................................................................................................... 68

7.1 О конфигурационных файлах проекта .......................................................................... 68

7.2 Совместимость с проектами, созданными в предыдущих версиях Супервизора .... 69

7.3 Сохранение и восстановление проекта ........................................................................ 71

7.4 Использование шаблона проекта .................................................................................. 74

8. Application Explorer ................................................................................................................ 76

9. Application Architect .............................................................................................................. 76

10. Smart Generator ................................................................................................................... 76

11. Разработка HMI ................................................................................................................... 76

12. Языки программирования .................................................................................................. 76

12.1 О языках программирования ....................................................................................... 76

12.2 SCADA Basic .................................................................................................................... 77

12.3 VBA and Enable ............................................................................................................... 77

12.3.1 Differences between Enable and VBA ..................................................................... 77

12.3.2 Understanding Objects, Properties, Methods and Events ...................................... 78


3

12.3.3 Using Collections ...................................................................................................... 79

12.3.4 The Supervisor's objects .......................................................................................... 80

12.3.5 Making drawing elements respond to the mouse pointer ...................................... 82

12.3.6 Using Cypress Enable ............................................................................................... 83

12.3.7 Using MS VBA ........................................................................................................... 83

12.3.7.1 About VBA ......................................................................................................... 83

12.3.7.2 The VBA development environment ................................................................ 83

12.3.7.2.1 How the VBA project explorer interacts with the HMI .............................. 83

12.3.7.3 Developing VBA programs ................................................................................ 84

12.3.7.3.1 Error handling when using VBA ................................................................. 84

12.3.7.3.2 Using HMI drawing elements in a program ............................................... 86

12.3.7.3.3 Coding events dynamically using the Dim WithEvents statement ............ 87

12.3.7.3.4 Developing code for use in symbols .......................................................... 87

12.3.7.3.4.1 About developing code for use in Symbols ........................................ 87

12.3.7.3.4.2 Using drawing elements within a Symbol as VBA controls ................. 88

12.3.7.3.4.3 What happens to Symbol events? ...................................................... 89

12.3.7.3.4.4 Using BeforeEvent and Dim WithEvents to dynamically code events 89

12.3.7.3.5 Using database variables in a program ...................................................... 90

12.3.7.3.5.1 About using database variables in a program .................................... 90

12.3.7.3.5.2 Subscribing and unsubscribing a variable ........................................... 90

12.3.7.3.5.3 Shortcuts for access to variables ........................................................ 91

12.3.7.3.5.4 Running code when a variable's value changes .................................. 92

12.3.7.3.6 Managing scroll bar controls from VBA ..................................................... 92

12.3.7.3.7 How to extend the functionality of the VBE .............................................. 93

12.3.7.3.8 Hints and tips ............................................................................................. 94

13. Web-сервисы ....................................................................................................................... 95

14. Специализированные темы ............................................................................................... 95

15. ПО стороннего производителя .......................................................................................... 95

15.1 Dream Report ................................................................................................................. 95


4

1. Об этом руководстве

Об этом руководстве

Это руководство для версии Супервизора 11.0.

Чего нет в этом руководстве?

Руководство к VBA встроено в среду программирования VBA и может быть вызвано нажатием на кнопку F1 из редактора VBA.

Используйте указатель, чтобы найти информацию по вкладке, окну или

панелям инструментов

Если нужна справка по конкретной вкладке, окну или панели инструментов:

Напечатайте имя элемента в поле поиска. Вам будет выведен список

подходящих разделов

Какие стилевые соглашения используются в этом руководстве?

Маркированный список используется для списка пунктов, у которого нет

никакого обязательного порядка, и для списков опций вкладок.

1. Пронумерованный список используется для списка, в котором важна

последовательность, например, в описаниях действий при настройке. Текст в моноширинный шрифт и с фоновым цветом используется для

фрагментов файла или кода.

Иллюстрация - при нажатии на ссылку показывается иллюстрация к тексту.

Используются следующие иконки:

Важное замечание.

Предупреждение.

Предложения для дополнения

Если вы нашли каких-либо очевидные ошибки, любые пропуски, или есть

предложения по улучшению документации, пожалуйста, напишите об этом по адресу [email protected].

Благодарим вас.

Команда разработчиков документации.

2. Как использовать поиск

2.1 Поиск по справке

Поиск по справке


5

В данном Справочнике есть больше, чем кажется на первый взгляд. Многие

пользователи умеют пользоваться Справкой простым способом, используя

вкладки Содержание, Указатель, Поиск, но все же не могут найти нужную информацию, хотя она есть в руководстве.

Этот раздел расскажет об инструментах поиска, которые Вы можете

использовать для поиска информации в справках типа Microsoft Help. Иллюстрация

Дополнительная информация

Это краткое руководство было адаптировано от Microsoft's Help для Help Viewer.

Последняя версия доступна со страницы HTML Help Downloads сайта Microsoft Developer Network (MSDN) или откройте и сохраните архив здесь: VIEWHLP.ZIP

Вне тем этого раздела, справка по Help Viewer рассказывает о особенных

возможностях, горячих клавишах, отслеживании любимых тем, настройке окна

Справки и использовании метода IME(input method editor) для ввода текста на

восточноазиатских языках.

2.2 Основные особенности поиска

Основные особенности поиска

Строка поиска может использовать буквы или цифры. Не чувствительна к

регистру. Знаки пунктуации игнорируются за исключением цитирования

../Resources/viewhlp.zip


6

(однако нельзя искать сами кавычки).

Используя выпадающий список можно выбрать выражения для предыдущих

поисков.

Использование групповых символов в строке поиска

Можно искать слова, используя простые групповые символы, знак вопроса и звездочку вперемешку с другими символами.

Поиск Пример Содержание раздела

Одно слово visible Слово 'visible' (так же такие варианты как 'visibility').

Фраза "register variable"

Фраза 'register variable' и ее грамматические варианты, такие как "register variables".

Выражения с

групповыми символами

gen* Слова, начинающиеся с 'gen', такие как

'genuine', 'general', 'generic', 'generate', 'generator' и т.д.

gener?? Слова с любыми символами в этих позициях,

такие как 'general' и 'generic'.

Фокусировка поиска

Вкладка Поиск включает некоторые дополнительные элементы, такие как

Предыдущий поиск, Похожие слова, Только в заголовках. Иллюстрация


7

Элемент Действие Пример

Предыдущий

поиск

Ограничивает поиск результатами

предыдущего поиска

Похожие

слова

Найти слова, которые

соответствуют ключевому слову

или отличаются только суффиксом

'add' будет соответствовать

'added' или 'adding', но не

'additive'.

Только в

заголовках

Поиск только по заголовкам

разделов

2.3 Расширенные методы поиска

Расширенные методы поиска

Использования логических выражений для поиска


8

Логические операторы AND, OR, NOT и NEAR позволяют уточнить запросы

поиска, указывая несколько критериев. Вы можете вводить их вручную или вставить, используя кнопку со стрелочкой справа от поля поиска.

Логические выражения поиска читаются слева направо, если они не содержат

круглые скобки (см. ниже). Примеры использования этих операторов

представлены в таблице.

Для поиска Пример Темы, содержащие...

Оба термина в одной теме alarm AND #t

Оба слова 'alarm' и '#t'.

Один из терминов в

разделе

alarm OR #t Слово 'alarm' или слово '#t' или оба.

Первый термин без второго alarm NOT #t

Слово 'alarm' но без слова '#t'

Оба термина в одном разделе, рядом

alarm NEAR #t

Слово 'alarm' и слово '#t' в 8 словах друг от друга

Если никакой оператор не задан, подразумевается AND. Например, запрос

'alarm display window' эквивалентен 'alarm AND display AND window'.

Использование вложенных выражений

Вложенные выражения используют круглые скобки '(...)' для сложных поисков.

Основные правила использования вложенных выражений при поиске:

Выражения в круглых скобках вычисляются перед остальным запросом

Затем запрос считывается слева направо

Нельзя использовать более 5ти уровней вложений , т.е. '(уровень_1...(уровень_2...(уровень_3...(уровень_4...(уровень_5...))))).

Проще пользоваться опцией поиска в предыдущем результате, чем

использовать многоуровневые вложенные выражения. См. раздел

Основные особенности поиска(See 2.2).

Пример Операторы Содержание раздела

alarm AND ((display

OR window) NEAR select)

'AND', 'OR', 'NEAR', '(...)'

Слово 'alarm' наряду со словами 'display'

и 'select' рядом; или 'alarm' вместе с 'window' и 'select' рядом.

alarm NOT display OR window

'NOT', 'OR';

правило слева-направо

Слово 'alarm' без слова 'display'; или слово 'window'.

alarm NOT (display OR window)

'NOT', 'OR', '(...)' Слово 'alarm' без слов: 'display' или 'window'.


9

3. Установка программного обеспечения

4. Проект и библиотека

4.1 О проектах

О проектах

Проект - это конфигурация, необходимая для настройки работы Супервизора в

соответствии с требованиями для индивидуального использования. Обычно

проект включает мнемосхемы, переменные базы данных, связи, запись данных,

конфигурацию пользователей и программы.

Вы можете сами создать новый проект или выбрать существующий в окне

"Выбор проекта", вызываемом из меню Конфигурация.Проект.Выбор проекта... Иллюстрация

Как создать новый проект

1. Из подменю Проект отобразите диалоговое окно Выбор проекта;

2. Введите имя нового проекта в текстовом поле диалогового окна. См.

ниже ограничения для имени проекта;

3. Нажмите кнопку OK. Супервизор создаст новый проект;

4. Закройте и перезапустите Супервизор. Затем может быть выбран новый

проект.


10

Как выбрать существующий проект

1. Из подменю Проект отобразите диалоговое окно Выбор проекта;

2. Выберите имя проекта, дважды щелкнув на его имени в списке;

3. Нажмите кнопку OK;

4. Закройте и перезапустите Супервизор.

Структура каталогов проекта

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

Обычно папка проекта находится в корневом каталоге Супервизора USR, хотя с

помощью опции -B в командной строке запуска Супервизора, можно задать другое расположение. Иллюстрация

Использование основных папок следующее (заметьте, что некоторые из папок

предназначены для внутреннего пользования и поэтому не упоминаются здесь):

Папка Назначение

3D Трехмерные мнемосхемы (если используются).

B Изображения, которые появляются в локальной библиотеке

C Конфигурационные файлы

C1 Конфигурационные файлы для импорта.

CTEMP Временные копии файлов конфигурации (C + C1),

используемых во время загрузки проекта.

DataExports Папка по умолчанию для экспорта данных.


11

DataExportTemplatess Папка по умолчанию для шаблонов для экспорта данных

HDS Файлы сервера исторических данных

Lib Корневая папка локальных библиотек. Смотрите раздел

Что такое библиотека?(See 4.3).

P Файлы программ SCADA BASIC

PER Файлы использованные и созданные инструкцией SVBATCH

R Файлы описания рецептов

S Символы, которые появляются в локальной библиотеке

SCR Файлы VBA

Templates Шаблоны и параметры

TH Файлы архивного модуля, содержащего исторические данные

TP Заданное по умолчанию размещение любых файлов, используемых SCADA BASIC

W Файлы определения окон (мнемосхем)

WEB Файлы ресурсов WebVue и кэш изображений

WT Файлы шаблонов окна

Имя проекта

К имени проекта применяются следующие ограничения:

• Длина, включая путь, ограничена 200 символами.

• Имя проекта не может :

включать символы /\?:*"<>¦

включать символы подстановки

содержать пробелы в начале или конце имени

быть '.' или '..'

иметь имя зарезервированное системой, такое как 'AUX', 'PRN', 'NUL', 'COM1' и т.д.

4.2 О конфигурационных файлах проекта

О конфигурационных файлах проекта

Большинство информации, введенной разработчиком через меню

Конфигурация, хранится в ASCII файлах с разделением данных запятой, или в XML файлах. Это имеет два преимущества:


12

файлы могут быть легко проверены автономно с помощью подходящего

текстового или XML редактора.

очень легко копировать файлы в другой проект.

ASCII файлы, которые хранятся в каталоге "С" проекта:

Файл Назначение

ACTION.DAT Конфигурация ассоциированных действий.

COMM.DAT Конфигурация связанных сетей, узлов и фреймов.

CRON.DAT Конфигурация действий планировщика.

CYCLIC.DAT Конфигурация циклических действий.

DB.DAT

DRAWDEFAULT.DAT Свойства по умолчанию для графических элементов

при их создании.

EVENT.DAT Конфигурация любых событийно управляемых действий.

EXPRM.DAT Модели выражений.

EXPRV.DAT Выражения переменных базы данных.

FORMULA.DAT Конфигурация всех используемых формул.

GPCONF.DAT

HDSCONF.DAT Конфигурационный файл исторического сервера

данных (HDS).

HDSTREND.DAT Конфигурационный файл трендов исторического сервера данных.

HISTO.DAT Конфигурация файлов архива, фильтров журналов и

отчетов, а так же список всех переменных базы данных, которые записываются.

IMPORTREFERENCES.DAT Информация о файлах, импортированных в Smart generator.

KEY.DAT Конфигурация любых действий клавиатуры.

LPRINTER.DAT Конфигурация принтера.

MRUFILES.DAT Список последних по времени использования мнемосхем.

OPTIONS.DAT Разнообразные конфигурационные опции.

PALCOL.DAT Конфигурационный файл цветовой палитры.

PARAM.DAT Конфигурация запуска проекта, предпочтения, имена пользователей и т.д.

PARAMWS.DAT Конфигурационные настройки окна.

PREFCOL.DAT Цветовые предпочтения.

POPU.DAT Совокупные конфигурации.

RECIPE.DAT Список рецептов. Рецепты хранятся отдельно в каталоге R.

SCRIPT.DAT


13

STATION.DAT Конфигурации сети.

TABLE.DAT Связанные метки, области и характеры.

TSPREFS.DAT

UIVCONF.DAT

USER.DAT Конфигурационный файл с именами пользователей,

паролями и правами. В зависимости от выбранной опции, файл может быть зашифрован.

VARCONF.DAT Конфигурационный файл свойств переменных.

VAREXP.DAT Конфигурация базы данных в расширенном формате файла.

VARTREAT.DAT Конфигурационный файл особой обработки

переменных.

XML файлы, хранящиеся в каталоге "С" проекта:


MAILCONFIG.XML Настройка способности Супервизора отправлять почту.

SCHEDULER.XML Настройка планировщика задания для HDS.

4.3 Что такое библиотека ?

Что такое библиотека ?

Библиотека — имя для набора папок, в которых Супервизор сохраняет файлы,

которые определяют его мнемосхемы шаблоны мнемосхем, символы,

изображения и программы SCADA BASIC. Всякий раз, когда вы открываете

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

Существует два типа различных библиотек, дифференцированных по их расположению в структуре папок Суепрвизора.

Локальные библиотеки - расположены в папках для конкретного

проекта и доступны только для этого проекта.

Общие библиотеки - расположены в корневой папке проекта (то есть в корневой папке всех проектов) и доступны для всех проектов.


14

О локальных библиотеках Иллюстрация


15


16

По умолчанию существует одна локальная библиотека для каждого проекта -

по имени LOCAL. Эту библиотеку нельзя удалить. Когда вы разрабатываете

интерфейс, если вы не измените выбор библиотеки, все будет сохраняться в

этой библиотеке. Библиотека расположена в корневой папке проекта, и она

состоит из следующих папок.

Папка Содержимое

3D 3D-мерные мнемосхемы

B Изображения

P Программы SCADA Basic

S Символы

SCR Скрипты VBA

Templates Шаблоны и параметры Application Architect

W Окна (Мнемосхемы)

WT Шаблоны окон (шаблоны мнемосхем)

Дополнительные локальные библиотеки, созданные с помощью Application

Explorer как часть настройки проекта, расположены в папке LIB, которая

находится в корневой папке проекта. Для каждой библиотеки создается одна

папка. Каждая папка содержит те же восемь вложенных папок, как описано в приведенной выше таблице.

Имя, по которому идентифицируется библиотека, не обязательно

совпадает с именем ее папки.


17

Об общих папках Иллюстрация


18


19

Всегда есть по крайней мере одна Общая библиотека проекта,

идентифицируемая именем COMMON. Эту библиотеку нельзя удалить. Она состоит из следующих папок.

Папка Содержимое

BMP Изображения

PRG Программы SCADA Basic

SCR Скрипты VBA

SYM Символы

WIN Окна (Мнемосхемы)

WTP Шаблоны окон (шаблоны мнемосхем)

Дополнительные общие библиотеки, созданные как часть настройки проекта,

расположены в папке LIB, которая находится в корневой папке Супервизора.

Создается одна папка для каждой библиотеки. Каждая папка содержит те же восемь вложенных папок, как описано в первой таблице выше.

Если выбрана Типичная установка при установке Супервизора, то несколько

предварительно определенных библиотек устанавливаются с именами, такими

как например shared_ARROWS, shared_MOTORS и др. Эти библиотеки также расположены в папке LIB, которая находится в корневой папке Супервизора.

Имя, по которому идентифицируется библиотека, не обязательно

совпадает с его именем папки.

Если вы используете общие библиотеки в вашем проекте, то при

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

скопировать общие библиотеки, которые вы использовали.

Изменение местоположения папок общей библиотеки

Параметр командной строки -b изменяет расположение папок общей

библиотеки и корневую папку проекта. Смотрите раздел Установка программного обеспечения.Супервизор. Опции командной строки.

Обратите внимание на разницу между корневой папкой проекта и корневой

папкой проектов.

Корневая папка проекта — это папка, с тем же именем, как и проект,

расположенная в корневой папке USR проекта.

Корневая папка проектов по умолчанию расположена в корневой папке Супервизора.

Управление библиотеками

Библиотеки управляются с помощью Application Explorer. Используя Application Explorer вы можете:

Добавить новую библиотеку.

Удалить библиотеки из настройки Супервизора и опционально удалить соотвествующие папки.


20

Изменить свойства библиотеки.

Добавить изображения в библиотеку.

Удалить из библиотеки отдельные мнемосхемы, шаблоны мнемосхем, символы, программы или изображения.

Смотрите разделы Библиотеки в справочнике по Application Explorer.

4.4 Совместимость с проектами и библиотеками, созданными в

предыдущих версиях Супервизора

Совместимость с проектами и библиотеками более ранних

версий Супервизора

Этот раздел содержит сведения о некоторых хорошо известных ограничениях

или мерах предосторожности, которые должны быть приняты в отношении

проекта и библиотек при обновлении с одной версии Супервизора на другую.

Технические ресурсы в интернете содержат дополнительные сведения о

стратегиях переноса и наилучших практиках.

Обратная совместимость

Обратная совместимость - это когда проект выполняется и полностью

поддерживается (если не указано иное) в среде более поздней версии

Супервизора, чем та версия Супервизора, в которой проект был создан.

В тех редких случаях, когда новые функциональные возможности меняют

конкретные настройки так, что не выполняется условие обратной

совместимости, то добавляется параметр обратной совместимости для

включения предыдущего поведения.

Если запустить проект и библиотеки из более ранней версии Супервизора, то

отображается окно предупреждения о том, что после того, как проект и

библиотеки запущены в текущей версии, они больше не могут быть

совместимы с любой более ранней версией.

Это ответственность пользователя следить за регулярным резервным

копированием проекта и библиотек. В частности, следует делать


21

резервные копии проекта и библиотек перед удалением или

запуском обновления Супервизора. Смотрите раздел Сохранение и

восстановление проектов и библиотек(See 4.5).

Прямая совместимость

Прямая совместимость не поддерживается, при которой проект, созданный в

новой версии Супервизора, будет работать в среде более старой версии

Супервизора. Любая попытка сделать это является исключительным риском

пользователя.

Совместимость с проектами, созданными в более ранней версии Супервизора (Версии 6, 7, 8, 9 и 10)

1. Расширение для функционирования HDS означает, что структуры

таблиц, используемых в версии 9.0 и более ранних версиях, не

совместимы со структурами таблиц в более поздних версиях. Для

информации о том, как записанные данные могут быть перенесены, смотрите разделе Миграция из 9.0 в 10.0 в книге Архивы.

2. Общие библиотеки, поставляемые в дистрибутиве Супервизора,

постоянно совершенствуются. В частности, новый набор библиотек

поставляется с версией 11. Пользователям с проектами, использующими

общие библиотеки, необходимо убедиться, что они принимают

необходимые меры резервного копирования перед запуском процесса

обновления. Если резервные копии доступны, то библиотеки могут быть

просто восстановлены, как только обновление установлено, используя

процедуру, описанную в разделе Сохранение и восстановление проектов и библиотек.

Совместимость с 16-разрядными (Windows 3.1) проектами Супервизора

(Версии 2, 3 и 4)

Проекты, созданные 16-разрядной версией Супервизора, как правило,

совместимы. Однако некоторые из более ранних выпусков 32-разрядной

версии имеют незначительные ограничения в функциональных возможностях.

Также некоторые из протоколов, доступных в 16-разрядной версии, не были

реализованы из-за ограничений в инструментальных средствах, доступных от

изготовителей. Если есть сомнения, пожалуйста, свяжитесь с технической поддержкой.

Вы должны установить программное обеспечение в новый каталог и затем

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

Как только Вы запустили приложение в 32-разрядной версии, оно не будет совместимо с 16-разрядной версией.

Совместимость с DOS проектами

Проекты, созданные с DOS-версией, не являются прямо совместимыми. Однако

высокий процент конфигурационной информации может быть восстановлен, и

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


22

Настройки совместимости

1. Откройте Application Explorer и выберите верхнюю папку (Проект).

2. Выберите Настройки. Откроется окно настроек проекта и там выберите

пункт Совместимость.

4.5 Сохранение и восстановление проектов и библиотек

Сохранение и восстановление проектов и библиотек

Этот раздел не является полным руководством по резервному копированию и

восстановления. Он включает в себя минимальные меры предосторожности,

которые вы должны принять, чтобы не потерять какие-либо компоненты,

необходимые для запуска проекта.

Создание резервных копий и проверка их корректности являются

важной частью разработки.

Резервное копирование

Содержимое резервной копии приложения Супервизора должно содержать как

минимум:

• Сам проект.

• Все общие библиотеки, котрые используются.

Кроме того, вашему приложению могут требоваться сторонние приложения,

инструменты и файлы для настройки, не описанные далее.

Использование Централизованного управления проектами может помочь

вам управлять резервными копиями вашего проекта. Смотрите книгу

Использование централизованного управления проектами.

Смотрите также важное замечание о библиотеках в разделе Удаление

программного обеспечения в книге Установка программного


23

обеспечения.

Как сделать резервную копию проекта

Каждый проект содержится в папке с тем же именем, что и проект в папке

ROOT\USR, где ROOT — корень проекта.

Корень проекта обычно является тем же самым что и расположение

Супервизора, хотя его можно изменить, используя параметр командной строки

-b. Если вы сомневаетесь, проверьте свойства ярлыка, который используется

для запуска Супервизора.

Для создания резервной копии проекта используйте инструменты

сжатия, чтобы сохранить содержимое проекта в одном файле.

Если проект содержит любые дополнительные локальные библиотеки,

то они уже включены в структуру папок проекта.

Как сделать резервную копию общих библиотек

Общие библиотеки из папки LIB размещаются в папке ROOT.

• Для резервного копирование общей библиотеки используйте инструменты

сжатия, чтобы сохранить библиотеки и их содержимое как единый файл.

Как восстановить проект из резервной копии

• Распакуйте файл резервной копии проекта в папке ROOT\USR.

Как восстановить общие библиотеки из резервной копии

1. Распакуйте резервную копию папки LIB во временную папку.


24

2. Замените (не объединяйте) установленную папку LIB на папку LIB, которую

вы распаковали на шаге 1.

Как использовать общие библиотеки, поставляемые с текущей версией

Супервизора и библиотеки из резервной копии

1. Распакуйте резервную копию папки LIB во временной месте.

2. Скопируйте папки каждой библиотеки, которые вам нужны, в папку LIB

текущей версии.

3. Используйте Менеджер библиотек в Супервизоре для добавления каждой из

библиотек, которую вы импортировали в проект из резервной копии. Смотрите

раздел Как добавить существующую библиотеку в книге Application

Explorer.Библиотеки.

Устаревшие инструменты PKZIP

Утилита PKZIP не совместима с 64-битными операционными системами.

Совместно с Супервизором поставляются устаревшие пакетные файлы для

сохранения и восстановления проектов. Эти пакетные файлы используют

инструмент сжатия PKZIP25, предоставляемый PKWARE, лицензированная

версия которого устанавливается с Супервизором. Пакетные файлы могут быть

найдены в корневой папке Супервизора, и должны выполняться из командной строки DOS. Доступны следующие пакетные файлы:

Пакетный файл Действие

sProject.bat ProjectName

Проект ProjectName и все его подкаталоги

архивируются и сохраняются в ProjectName.Zip, расположенном в корневом каталоге Супервизора.

Это может использоваться только с проектами в заданном по умолчанию проектном корневом каталоге.

sProject_a.bat

ProjectName

Проект и все его подкаталоги сжимаются и

сохраняются в ProjectName.Zip на диске A: (гибкий диск).

s1Lib.bat LibraryName Единая общая библиотека LibraryName сжимается и

сохраняется в LibraryName.Zip, расположенном в корневом каталоге Супервизора.

sAllLib.bat Все общие библиотеки сжимаются и сохраняются в

Lib.Zip, расположенном в корне Супервизора.

sPro&Lib.bat ProjectName

Проект ProjectName и все его подкаталоги сжимаются и

сохраняются в ProjectName.Zip. Общие библиотеки

сжимаются и сохраняются в Lib.Zip. Оба файла размещаются в корне Супервизора.

sPro-His.bat Проект ProjectName и все его подкаталоги кроме


25

ProjectName исторических файлов данных сжимаются и

сохраняются в ProjectName.Zip, расположенном в корне

Супервизора.

LoadAll.bat ProjectName Проект ProjectName и все его подкаталоги извлекаются

из ProjectName.Zip и сохраняются в каталоге

ProjectName, расположенном в каталоге проектов Супервизора.

Общие библиотеки извлекаются из Lib.Zip и

сохраняются в каталоге Lib. ProjectName.zip и Lib.Zip должны быть расположены в корне Супервизора.

4.6 Использование шаблона проекта

Использование шаблона проекта

Шаблон проекта - это проект Супервизора, который сконфигурирован обычным

образом и затем скопирован в папку шаблонов. Когда Супервизор стартует он

проверяет папку шаблонов, и, если находит шаблон, то содержимое его папки

копируется в папку текущего проекта. ТОЛЬКО ПАПКИ И ФАЙЛЫ КОТОРЫЕ

ЕЩЕ НЕ СУЩЕСТВУЮТ МОГУТ БЫТЬ СКОПИРОВАНЫ. Таким образом

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

Для обновления проекта Супервизора после изменений любых файлов в

каталоге TPL необходимо остановить Супервизор, удалить аналогичные

файлы в проекте и перезапустить Супервизор.

Как создать шаблон проекта

1. Создайте проект и настройте в нем то, что необходимо.

2. Создайте новую папку с именем TPL для шаблона проекта. По

умолчанию Супервизор рассчитывает найти папку шаблона в корневой папке проекта. Это папка, которая содержит USR, LIB, ETC, и т.д.

3. Скопируйте подпапку проекта (3D, B, C, etc.) в папку TPL.

Вы можете хранить шаблон проекта в любом другом месте, доступном

Супервизору, но тогда будет необходимо настроить путь способом, описанном

ниже.

Настройка работы шаблона проекта

Вы можете настроить работу шаблона проекта добавлением параметров в файл

инициализации Супервизора SV32.INI, расположенный в каталоге BIN.

Не изменяйте файл SV32.INI другими способами.


26

Параметры должны быть добавлены в раздел начиная с заголовка [Template

Project]. Они могут содержать следующие настройки.

Опция Значение

Disabled Отключение функциональности (значение 1) или разрешение ее

(значение 0, по умолчанию).

Dir Задание папки шаблона проекта. По умолчанию:

% ProjectsDir%\TPL.

Параметры пути обозначают следующее

Полный путь, можно задать любую папку.

% ProjectsDir%: корневой каталог проекта. Это каталог, в который был

установлен Супервизор, за исключением случаев использования

команды -b для определения альтернативного местоположения папки проекта.

% ProgramFilesDir%: папка программы. Это папка, которая содержит

программы и средства, которые содержаться в Супервизоре. Обычно это

каталог BIN.

Пример параметров в SV32.INI

Установка Шаблон проекта ...

[Template Project]

Disabled=1

не используется.

[Template Project]

Dir=C:\SV_TEMPLATE

находится в C:\SV_TEMPLATE.

[Template Project]

Dir=%ProjectsDir%\SV_TEMPLATE

находится в подкаталоге SV_TEMPLATE папки

проекта.

[Template Project]

Dir=%ProgramFilesDir%\TPLPROJ

находится в подкаталоге TPLPROJ папки

программы Супервизора.

5. Использование централизованного управления проектом

5.1 О централизованном управлении проектом

О централизованном управлении проектом

Централизованное управление проектом дает возможность управлять проектом и версиями библиотек. Используя его возможно:


27

определить место хранения проекта

на станции выбрать версию проекта из центрального хранилища проекта, загрузить и запустить ее

сохранить локальную версию в папке проекта как новую версию или как обновление старой

управлять статусом версий проекта в папке центрального проекта,

определяя их как разрабатываемая, рабочая или эталонная(как

объяснено ниже).

все вышеперечисленное можно делать и с библиотеками.

Вы можете управлять любым количеством проектов в одной центральной папке

проекта. Однако на отдельной станции можно только смотреть версии

проектов, которые в данный момент загружены в Супервизор на этой станции.

Сохранение и загрузка

Процесс сохранения версий проекта со станции в центральную папку проекта и

управление их статусами осуществляется из даилогового окна, вызываемого из

меню Конфигурация.Проект.Версии .

Процесс выбора и загрузки различных версий проекта или версий библиотек

из центрального хранилища проекта в станцию происходит при старте

Супервизора. Эта возможность доступна при использовании командной строки

и (для некоторых настроек) отдельных настроек для версий проекта и библиотеки.

Супервизор всегда запускает локальную копию проекта.

Исходное и основное использование Централизованного управления

проектом - централизованное руководство сетевым, многостанционным

проектом, но этот функционал так же может быть использован для

проекта, состоящего из одной станции, или для проекта, состоящего из

нескольких автономных станций.

При использовании Централизованного управления проектом необходимо

убедится, что включена синхронизация времени на всех станциях.

О папке, используемой для хранения централизованного проекта

Папка может быть расположена в любом месте, где к ней могут получить

доступ все станции. При использовании централизованного управления

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

Путь к папке ограничен 80 символами.

Статус версии проекта

Каждая версия проекта классифицируется как разрабатываемая, рабочая или эталонная.

Статус Значение


28

Статус Значение

DEV В разработке, может быть обновлена.

OPE Рабочая. По умолчнию, версия OPE не может быть изменена.

REF Одна из рабочих версий, которая в текущий момент используется на

всех станциях пользователей. Может быть только одна эталонная

версия. Как и рабочая, она не может быть модифицирована.

Библиотеки

Возможности Централизованного управления проектом могут быть использованы с библиотеками Супервизора.

Чем не является централизованное управление проектом

Централизованное управление проектом не является общим инструментом для

централизованного контроля версий программного обеспечения и библиотек.

Такие средства существуют и являются коммерческими, они могут быть

настроены для этого.

Так же это данное средство не является средством архивирования проекта.

Оно не архивирует проект для экономии занимаемого места. Использование

PKZIP25 для этих целей описано в разделе Хранение и восстановление

проектов.

5.2 Создание и управление версиями проекта

5.2.1 Окно Централизованное управление проектом

Централизованное управление проектом

Окно "Централизованное управление проектом" вызывается из меню Конфигурация.Проект.Версии.

При первом запуске появится окно с предупреждением о том, что

централизованное управление проектом не настроено. Нажмите ОК и откроется

окно настроек.

Используя централизованное управление проектом, Вы можете:

выбирать папку, используемую для Централизованного управления

проектом

просматривать доступные версии проекта

создавать новые версии, основанные на локальном проекте

обновлять существующие версии, заменяя ее локальной версией

изменять статус версии, изменяя ее описание и добавляя комментарии

применять подобные функции к версиям библиотек

Выбор папки, используемой Централизованным управлением проектов

1. Выберите Общие параметры

2. Отметьте свойство Включитьцентрализованное управление проектом


29

3. Введите имя папки в поле Каталог центральной версии. Вы можете

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

папки Windows. Строка каталога ограничена 80 символами.Иллюстрация

4. Для получения доступа к папке в сети, которая в данный момент не

доступна, нажмите кнопку Подключение сетевого диска , откроется окно Подключение сетевого диска.

Папка может быть расположена в любом месте, в котором будет доступна всем

станциям. При использовании централизованного управления проектом файлы

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

Выбор папок проекта и файлов, которые будут сохраняться

1. Выберите Проект.Включенные файлы и папки

2. Отметьте галочкой файлы и папки. Иллюстрация


30

Используйте выбранные по умолчанию папки, если у Вас нет собственных

требований и Вы не знакомы со структурой папок проекта.

Чтобы выбрать папки библиотеки, проделайте те же действия, выбрав

Библиотеки.Включенные каталоги.

После изменения списка каталогов появится окно для подтверждения

изменений.

Отображение списка версий доступного проекта или библиотеки

Для отображения списка доступных версий библиотеки выберите Библиотеки.

Для отображения списка доступных версий проекта выберите Проект.

Иллюстрация


31

Нумерация версий проекта и библиотеки

Для нумерации версий проекта используются две цифры. Основная цифра (так

же известная как серия) представляет главную версию , вторая цифра

представляет собой второстепенную версию. Например, для 1.5 - серия 1,

второстепенная версия 5. Номер серии может быть выбран при создании новой

версии в окне Централизованное управление проектом. Второстепенная версия

увеличивается автоматически каждый раз, когда Вы создаете новую версию в этой серии.

Номер версии так же используется как имя подкаталога, в котором версия хранится.

номера версий применяются независимо к проектам и библиотекам.

Например, проект XYZ версия 1.3 и версия 1.3 библиотеки могут не соответствовать друг другу.

5.2.2 Как создать новую версию

Как создать новую версию

Действия по созданию новой версии копируют локальный проект в

центральную папку проекта под выбранным номером версии. Новой версии

дается статус DEV (статус разработки) и номер версии локального проекта обновляется соответственно версии, которую Вы создали.

1. Откройте окно Централизованное управление проектом и выберите

Проект . В правой части окна отобразится описание версий проекта.


2. Нажмите кнопку Создание новой версии. Откроется окно Создание

новой версии, где Вы сможете выбрать новый номер версии или

использовать существующий . Второстепенный номер версии

генерируется автоматически и не может быть изменен.


32

3. Нажмите OK, начнется процесс копирования. Новая версия будет

создана в папке центрального проекта с помощью копирования

выбранных файлов из локального проекта.

Информация о том, какие папки проекта копируются и как их выбрать

находится в разделе Окно Централизованного управления проектом(See 5.2.1).

5.2.3 Как обновить существующую версию

Как обновить или удалить версию центрального проекта

Обновление копии (сохранение) локального проекта в папку центрального проекта под выбранным номером версии.

Обновление

По умолчанию, можно обновить только версию DEV, однако это можно

исправить. В окне управления версиями проекта выберите опцию "Можно обновить версию до рабочей или референсной".

Обновление версии

1. Откройте окно Централизованное управление проектом и выберите

Проект

2. В правой части окна выберите версию, которую Вы хотите обновить

3. Выберите кнопку Обновить версию. Вас спросят, хотите ли Вы обновить

полностью или частично версию. Иллюстрация

4. Если выберите Частичное обновление, нажмите на стрелочку справа для

отображения календаря.

5. В календаре выберите самую раннюю дату и время для содержания

проекта , которое будет скопировано.

6. Выбранные локальные файлы будут скопированы в папку центрального

проекта. Нажмите OK.

В окне Централизованное управление проектом, стрелочка над колонкой позволяет упорядочить список в алфавитном порядке. Иллюстрация


33

Удаление версии

1. Откройте окно Централизованное управление проектом и выберите в

левой панели Проект.

2. В списке версий нажмите на версию, которую хотите удалить.

3. Нажмите Удалить и, когда попросят подтверждения, нажмите Да.

4. Нажмите ОК, чтобы закрыть окно.

5.2.4 Как изменять статус версии

Как изменять статус версии

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

Статус Значение Экземпляры Действия

DEV Разработка Любое количество Загрузка, обновление, удаление

REF Эталон Один на проект Только загрузка *

OPE Рабочая Любое количество Только загрузка *

*пока не разрешите обновление (см. раздел как обновить версию проекта)

Изменение статуса версии, описания или комментария

1. Откройте окно Централизованное управление проектом

2. В списке версий нажмите на версию, которая будет изменяться

3. Нажмите на кнопку Изменение статуса версии Иллюстрация


34

4. Выберите статус версии (DEV, OPE или REF)

5. Вы можете изменить описание версии

6. Вы можете написать комментарий или редактировать уже написанный

7. Нажмите кнопку OK

Если Вы применяете свойство Эталон при существующей эталонной версии , то статус бывшей эталонной версии изменится на рабочую.

Вы не можете напрямую изменить состояние версии из «В разработке» в

«Референсная». Необходимо сперва изменить в «Рабочая», а потом в «В разработке».

5.3 Как использовать контроль версий с библиотеками

Создание и управление версиями библиотеки

В дополнение к использованию с проектами, Централизованное управление

проектом может также использоваться, чтобы создавать и управлять версиями

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

Корневая папка проекта - это тот же корневой каталог Супервизора , если

не был задан альтернативный с помощью ключаe -b в командной строке

Супервизора.


35

Чтобы использовать Централизованное управление проектом с библиотеками

выберите Библиотеки в окне "Централизованное управление проектом". Работа с библиотеками аналогична работе с проектом. Иллюстрация

Выберите, какие папки библиотеки будут сохраняться при сохранении

версии библиотеки

1. Выберите Библиотеки.Включенные каталоги

2. Отметьте папки библиотеки. Иллюстрация


36

5.4 Как выбрать и загрузить версию при запуске проекта

5.4.1 Как выбирать версию проекта при запуске

Как выбирать версию проекта при запуске

Чтобы выбрать версию проекта при запуске, нужно добавить свойство (известное как ключ) в командную строку Супервизора. Например:

C:\Program Files\SV\8.11\bin\sv32.exe -d

В Windows 7 и Vista, программное обеспечение Супервизора расположено в папке C:\Program Files.

Ключи командной строки

Существует три ключа, используемые для Централизованного управления

версией.

Ключ Действие

-r Автоматически запускает Супервизор с версией Ref (Эталон) проекта

(если она существует).

-x Открывает диалог Выбор версии в ходе запуска. В окне будут

перечислены Рабочие и Эталонные версии проекта из которых можно

выбрать нужную.

-d Открывает диалог Выбор версии в ходе запуска. В окне будут перечислены все версии проекта из которых можно выбрать нужную.

Что происходит при копировании версии из центрального проекта в локальную папку

1. Папки выбранного проекта копируются во временное хранилище.

2. Если копирование завершено успешно, папки копируются в директорию проекта, заменяя уже существующие файлы.

3. Если копирование не выполнено, то появится сообщение об ошибке.

4. Необходимые папки выбранной версии будут скопированы на

локальную станцию.

Если один из этих пунктов не выполняется, например, файловая система

повреждена или жесткий диск центрального хранилища заполнен:

1. Появится сообщение об ошибке

2. Все копии будут удалены, предыдущие папки будут восстановлены и копии с добавлением '.OLD' будут удалены

3. Оригинальный проект запустится


37

Если сообщение проигнорировано, то Супервизор запускается с другой версией проекта, чем планировалось.

5.4.2 Использование ключа -r в командной строке

Использование ключа -r в командной строке

Использование ключа -r в командной строке позволяет запускать версии

Эталон проекта и библиотек. Перед стартом Супервизора не появляется окно

выбора версии. Возможны следующие сценарии.

если локальный проект не является той же самой эталонной (REF)

версией, то эталонная версия копируется из папки централизованного

упраления проекта, и Супервизор запускается с ней;

если нет никакой версии Эталон, Супервизор запускается с локальным

проектом;

если локальная в эталонная версии совпадают, ничего не копируется и

Супервизор запускает локальную версию.

Подробности о копировании смотрите в разделе Как выбирать версию проекта

при запуске (See 5.4.1).

5.4.3 Использование ключа -x в командной строке

Использование ключа -x в командной строке

Использование ключа -x в командной строке открывает окно "Выбор версии" в

ходе запуска Супервизора. Это диалоговое окно отображает информацию о

текущей локальной версии проекта и список доступный рабочих (OPE) и эталонной (REF) версий.

Если в хранилище центрального проекта нет рабочих или эталонной версии,

диалоговое окно не отобразится, и Супервизор запустится с существующей

локальной версией.

Использование существующих локальных версий проекта и библиотек

Чтобы использовать существующие локальные версии проекта и библиотек

нажмите кнопку Запуск в окне выбора. Супервизор продолжит стартовать с использованием существующей версии проекта и библиотек.

Копирование и запуск рабочей и эталонной версии проекта


38

1. Окно выбора версии проекта открывается первым. Вы можете проверить

версию локального проекта в верхней области окна. Иллюстрация

2. Выберите нужную версию из списка и нажмите Загрузить. Выбранная

версия будет скопирована в локальную папку проекта. Иллюстрация

3. Нажмите кнопку Дальше, чтобы скопировать библиотеки, или кнопку Запустить, чтобы пропустить этот шаг и запустить Супервизор.

Копирование и запуск рабочей и эталонной версии библиотек

Это продолжение процесса, описанного выше.


39

1. Вы можете проверить локальную версию библиотеки в верхней части

окна. Иллюстрация

2. Выберите нужную версию из списка и нажмите кнопку Загрузить. Версия будет скопирована в корневой каталог Супервизора.

3. Нажмите кнопку Запуск. Супервизор продолжит процесс запуска с выбранной версией проекта и/или библиотеками.

Более подробная информация по копированию находится в разделе Как

выбрать версию проекта(See 5.4.1).

5.4.4 Использование ключа -d в командной строке

Использование ключа -d в командной строке

Ключ -d в командной строке дает такой же эффект, как и -x, за исключением

того, что вместо рабочей и эталонной версии может быть выбрана версия со

статусом Разработка. Иллюстрация


40

Смотрите раздел Использование ключа -x в командной строке(See 5.4.3) для

более детальной информации по выбору версий проекта и библиотек.

5.5 Переменные центрального управления проектом

Переменные центрального управления проектом

Системные переменные центрального управления проектом предоставляют

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

Сетевые станции

В приведенных примерах <StationName> - имя станции в сетевой

конфигурации.

Для проекта:

SYSTEM.<StationName>.VERSION.PROJECT


41

Тип переменной - TEXT.

Версия проекта загруженная и запущенная в текущий момент.

Пример:

SYSTEM.SERVER_A.VERSION.PROJECT

Для библиотек:

SYSTEM.<StationName>.VERSION.LIBRARY


Версия библиотеки загруженная и запущенная в текущий момент.

Пример:

SYSTEM.SERVER_A.VERSION.LIBRARY

Для одной станции

В приведенных примерах <localhost> - имя станции

Для проекта:

SYSTEM.LocalHost.VERSION.PROJECT


Запущенная в текущий момент версия проекта.

Для библиотек:

SYSTEM.LocalHost.VERSION.LIBRARY


Запущенная в текущий момент версия библиотеки.

5.6 Пример централизованного управления проектом

Пример централизованного управления проектом

Станции

Приложение работало некоторое время, но потребовало улучшения

функциональности и обновления. Архитектура станций представлена ниже.

2 сервера, Station 10 и Station 11, находятся в ассоциации (для "горячего" резервирования), Association 20.

3 клиент соединен с ассоциацией.

1 файловый сервер (MYSERVER), является хранилищем центрального проекта.


42

Централизованное управление проектом разрешено на всех станциях,

MYSERVER\DISK1\CENTRALSTORE - назначено как центральное метро хранения.

Station 11 имеет полную (разработка и run-time) лицензию и запускается с использованием ключа -d в командной строке.

Остальные станции имеет лицензию run-time и запускаются с использованием

ключа -r в командной строке.

Версии

Версии, которые будут управляться, в различных стадиях цикла разработки.

Версия Описание Статус

1.7 Окончательная версия предыдущего релиза, заархивированная

в целях поиска и устранения неисправностей.

OPE

2.1 Версия, использующаяся на станциях Stations 1 - 3, которая в

скором времени должна быть заменена.

REF

2.2 Недавно тестированная и являющаяся рабочей. OPE

3.0 В разработке. DEV

Все версии хранятся на файловом сервере в папке центрального проекта.


Контроль версий

1. Разработка и тестирование происходит на станции Station 11. ПК

разработчика может загружать все версии для сравнения и поиска неисправностей по требованию.

2. Когда тестирование версии завершено, ей назначается статус "OPE". Версия 2.2 в данный момент имеет такой статус.


43

3. Эксплуатационные станции (Stations 1 - 3) используют ключ -r в

командной строке, чтобы загрузить версию REF при перезапуске. В

данный момент этот статус имеет версия 2.1, таким образом она будет загружена автоматически при запуске этих станций.

4. Когда будет переключение на версию 2.2, ей будет назначен статус REF.

Версии 2.1 вернут статус OPE и она останется доступной для возвращения к предыдущей версии.

5. При следующей перезагрузке рабочих станций (Station 1 - Station 3),

централизованное управление проектом автоматически загрузит версию 2.2 на них.

6. Если возникнет необходимость временно вернуться к предыдущей

версии, администратор переназначает статус REF версии 2.1. И при

перезагрузке станций на них будет опять загружена версия 2.1. (при

условии, что версии 2.1. и 2.2 технически взаимозаменяемые и

удовлетворяют требованиям пользователей)

7. В этом примере библиотеки остаются неизменными в версиях 2.1 и 2.2

проекта. Версия 1.7 хранится только как исходная.

Результат

После перехода на версию 2.2, версии проекта выглядят таким образом.

Версия Описание Статус

1.7 Финальная версия предыдущего релиза, заархивированная в

целях поиска и устранения неисправностей.

OPE

2.1 Предыдущая версия. OPE

2.2 Текущая версия, использующаяся на станциях Stations 1 - 3. REF

3.0 В разработке. DEV

6. Конфигурация среды

6.1 Интерфейс

6.1.1 Рабочая область

Рабочая область

Рабочая область - так называются то пространство, которое занимает

интерфейс на экране вашего компьютера. Рабочая область содержит все

инструменты, необходимые для разработки интерфейса, а в период

выполнения она является контейнером для всех окон, реализующих

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


44

Панель меню

Панель меню предоставляет доступ посредством клавиатуры или мыши ко всем

инструментам разработки. Панель меню можно перетаскивать при помощи

мыши и пристыковывать к любому краю рабочей области, или же оставлять в

любом месте экрана. Панель меню можно открыть и закрыть при помощи

команд контекстного меню, открываемого щелчком правой кнопки мыши на

любом участке рабочей области. Установленный флажок означает, что панель меню открыта.

Панели инструментов

Панели инструментов предоставляют доступ к наиболее часто используемым

инструментам. Так же как и панель меню, панели инструментов можно

закреплять на рабочей области или оставлять в любом месте. Вы можете

открыть и закрыть любую из панелей инструментов при помощи команд

контекстного меню, открываемого щелчком правой кнопки мыши на любом

участке панели меню. Установленный флажок означает, что панель открыта.

Палитра цветов

Палитра Цвета используется для определения и выбора цвета для графических

элементов и анимаций. Ее можно открыть или закрыть при помощи команды Вид.Палитра цветов .

Список свойств

Список свойств отображает в стиле Visual Basic свойства, методы и события для

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


45

Полосы прокрутки

Полосы прокрутки служат для перемещения окна по мнемосхеме в случае, если ее размеры превосходят размеры рабочей области.

Строка состояния

Строка состояния располагается в нижней части рабочей области. Она

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

Изменение свойств рабочей области

Внешний вид и поведение рабочей области можно изменить из меню Вид.Свойства рабочей области. Для изменения доступны следующие свойства:

размеры рабочей области и ее положение на экране;

цвет рабочей области;

вид и содержимое строки заголовка;

элементы управления, доступные в строке заголовка.

6.1.2 Изменение свойств рабочей области

Изменение свойств рабочей области

Свойства рабочей области изменяются в диалоговом окне, которое открывается

щелчком правой кнопкой мыши в любом месте рабочего пространства (не

занятом мнемосхемой или панелью инструментов), при выборе из всплывающего меню "Свойства рабочей области". Иллюстрация

Изменение размера рабочей области

По умолчанию, если Вы меняете размеры или положение рабочей области, она

после следующего запуска вновь откроется на весь экран. Для того, чтобы

изменить размеры и положение и для последующих запусков тоже, Вам

необходимо сбросить флажок "Весь экран", находящийся в диалоге "Свойства

рабочей области". После этого любые изменения размера и положения области


46

будут сохранены при последующем запуске. Вы можете изменить размеры и

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

Изменение поведения рабочей области

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

Сворачивание - отображать кнопку свертывания окна в панели

заголовка. По щелчку на этой кнопке рабочая область сворачивается в

кнопку на панели задач Windows. Для восстановления окна рабочей

области достаточно щелкнуть на этой кнопке;

Разворачивание - если окно рабочей области занимает не весь экран, то

отображается кнопка раскрытия окна, а если окно рабочей области

занимает весь экран, отображается кнопка восстановления окна.

Щелчки на этих кнопках раскрывают окно на весь экран или

восстанавливают его прежние размеры;

Закрытие - отображается кнопка закрытия окна в панели заголовка. По

щелчку на этой кнопке закрывается окно с пользовательским

интерфейсом (если права пользователя достаточно для этого действия);

Перемещение - рабочую область можно перетаскивать при помощи

мыши, захватив ее панель заголовка;

Изменение размера - размеры рабочей области можно менять,

перетаскивая ее границы при помощи мыши;

Автоматические полосы прокрутки - если отображаемая мнемосхема

больше рабочей области, то в окне рабочей области автоматически

появятся полосы прокрутки.

Изменение размера панели заголовка

На отображение панели заголовка влияют следующие свойства:

Нет (Отсутствует) - панель заголовка не отображается;

Стандартная - отображается стандартная панель заголовка;

Мини - отображается панель заголовка уменьшенной высоты. Если Вы

используете минипанель, то отобразить в ней можно только кнопку

закрытия окна.

Еще один дополнительный эффект использования минипанели состоит в

том, что окно рабочей области не отображается в списке задач Windows.

По этой причине Вы не сможете использовать сочетание клавиш Alt-Tab для переключения между рабочей областью и другими задачами.

Изменение текста в панели заголовка

Если Вы выберете "Настроить" (Заголовок) в диалоге свойств рабочей области,

то сможете ввести собственный текст для отображения в панели заголовка.

Кроме любого фиксированного текста (заголовок или описание окна) Вы

можете использовать подстановочные символы, позволяющие отображать в

панели заголовка различную вспомогательную информацию:

Заменяемые символы Информация для отображения

#h Текущий час (две цифры)

#m Текущая минута (две цифры)

#s Текущая секунда (две цифры)

#D Текущая дата (две цифры)

#M Текущий месяц (две цифры)


47

#Y Текущий год (две цифры)

###Y Текущий год (четыре цифры)

#PRJ Имя проекта

6.1.3 Поддержка мыши IntelliMouse

Поддержка мыши IntelliMouse

Интерфейс предусматривает поддержку мыши типа Microsoft IntelliMouse,

которая помимо двух обычных кнопок снабжена центральным колесиком, при

помощи которого можно прокручивать и панорамировать окна, а также масштабировать их.

Изменение масштаба мнемосхемы - по умолчанию: Ctrl + колесико

мыши

Увеличение и уменьшение масштаба мнемосхемы.

Ручное панорамирование мнемосхемы - по умолчанию: Shift + нажатие

средней кнопки мыши + перетаскивание

Панорамирование мнемосхемы в окне. (Доступно только если мнемосхема больше окна.)

Автоматическое панорамирование мнемосхемы - по умолчанию: Ctrl +

щелчок средней кнопкой мыши + перетаскивание

Панорамирование мнемосхемы в ее окне. (Доступно только если мнемосхема

больше окна.)



48

Прокрутка мнемосхемы и рабочей области - по умолчанию

вертикальная: колесиком мыши; по умолчанию горизонтальная: Shift + колесико мыши

Прокручивание мнемосхемы в ее окне. (Доступно только если мнемосхема

больше окна.) Потом, после прокручивания мнемосхемы до конца, будет

прокручиваться рабочая область. (Доступно только если мнемосхема больше окна и полосы прокрутки разрешены).

Автоматическое панорамирование рабочего пространства - по

умолчанию: Shift + нажатие средней кнопки мыши + перетаскивание(drag)

Панорамирование рабочего пространства в его окне. (Доступно, только если

рабочее пространство больше, чем содержащее его окно и полосы прокрутки

разрешены).


6.1.4 Использование регионов

Использование регионов

Рабочая область может быть поделена на регионы (до 4х эквивалентных

регионов, расположенных горизонтально или вертикально). При открытии окна

Вы можете задать регион, в котором оно будет открыто. Регионы наиболее

часто используются при отображении проекта на нескольких мониторах, и

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


49

Число регионов выбирается во вкладке "Регионы" в окне "Свойства рабочей области". Иллюстрация

Как настроить регионы рабочей области

1. Правой кнопкой мыши кликните на рабочем пространстве и выберите

Свойства рабочей области из всплывающего меню. Появится диалоговое

окно "Свойства рабочей области".

2. Выберите вкладку "Регионы".

3. Используя свойство Система, выберите количество регионов из

выпадающего списка.

4. Используя свойство Ориентация, выберите расположение регионов: по

вертикали или по горизонтали.

5. Выберите свойство Стартовый регион нажатием на соответствующую

иконку. Стартовый регион - это регион, в котором будет открыто окно по

умолчанию, если не будет задан конкретный регион.

Различие между разрешением экрана и рабочего пространства

Разрешение экрана определяет размер и расположение регионов

соответственно разрешению всего рабочего стола Windows.

Разрешение рабочей области определяет размер и расположение

регионов соответственно разрешению рабочей области Супервизора.

6.2 Application Explorer

6.2.1 Что такое Application Explorer

Что такое Application Explorer?

Application Explorer - это окно в стиле Проводника Windows, которое

объединяет в себе все настройки из меню Конфигурация. Он может быть

открыт из меню Конфигурация.Application Explorer или сочетанием клавиш Ctrl


50

+ E. Иллюстрация

При нажатии на рабочей области Супервизора при открытом окне

Аplication Explorer, окно Application Explorer останется открытым на заднем

плане. Теми же командами открытия это окно можно переместить на

передний план поверх всех остальных окон.

Конфигурации, доступные в Application Explorer.

Связь

o Получение данных

OPC

Оборудование

IEC 60870-5-10

DNP3

IEC 61850

LonWorks

BACnet

DDE

o Сетевая работа

Станции

Списки

Группы

o Серверы

WebVue & WebServices Toolkit

OPC сервер Мобильный сервер

Переменные

o Дерево переменных

o Области


51

o Характеры

o Выражения o Синтез тревог

Архивы

o Архивные модули

o Базы данных

Действия

o Сообщения

o События o Циклические

Учетные записи

o Пользователи o Профили

Анализ данных o Экспорт данных

Библиотеки

o Локальные библиотеки o Общие библиотеки

Справочник по этим настройкам находятся в теме Application Explorer

общей справки Супервизора.

6.2.2 Окно Application Explorer

Окно Application Explorer


52

Основные компоненты Application Explorer. Иллюстрация

Главное меню [A]

Файл.Сохранить - Сохранить все настройки проекта.

Файл.Выход - Закрыть Application Explorer.

Вид.Панели.Задачи - Управление панелью задач.

Окна.Новое окно - Открыть новое (дополнительное) окно настроек.

Окна.Горизонтальная мозаика - Разместить окна по горизонтали.

Окна.Вертикальная мозаика - Разместить окна по вертикали.

Окна.Каскад - Упорядочить окна каскадом.

Окна.Закрыть - Закрыть активное окно.

Справка - Вызвать файл Справки.

Главная панель инструментов [B]

На главной панели интсурментов отображаются иконки, имеющие отношение к общей работе Application Explorer.

Иконка Задача

Перейти к предыдущему выбранному элементу в дереве

конфигураций.


53

Перейти к следующему выбранному элементу в дереве конфигураций.

(Только после использования команды Назад).

Переместится на уровень вверх.

Закрыть Application Explorer.

Переключение отображения дерева конфигураций (папки).

Настройка отображения информации в окне (настройка отображения

столбцов).

Панель задач [C]

Отображает задачи, относящиеся к выбранному элементу.

Окно настроек [D]

Основное окно настроек, из которого осуществляется переход по дереву

конфигураций и изменение параметров. Единовременно могут быть открыты

несколько окон конфигурации и на них могут выводиться разные настройки.

Можно изменять размер этого окна, а так же прятать его с помощью кнопок

управления окном.

Дерево конфигураций [E]

Дерево конфигураций отображает все настройки Супервизора, доступные в

Application Explorer. Каждый раздел конфигурации представлен в виде папки.

При выборе папки в окне отображаются соответствующие данному разделу элементы.

Содержание [F]

Эта панель отображает содержание (подпапки конфигурации или элементы) выбранной в дереве конфигурации папки.

Панель инструментов [G]

Отображает задачи, относящиеся к выбранной папке и элементу. Обычно, это

копия Панели задач.

Панель связанных событий [H]

Видна при выборе дерева переменных. Показывает все возможные события, настройки и действия, связанные с переменной. (События, тренды и т.д.)

Панель инструментов связанных событий [I]

Видна при отображаемой панели связанных событий. Содержит иконки с

возможными заданиями для добавления, изменения или изменения поведения

переменной.

Всплывающее меню [не отображено на иллюстрации]

Отображается при нажатии правой кнопкой.

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

При нажатии на пустом месте панели содержания - показываетс список

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


54

При нажатии на любом элементе панели содержания - отображает задачи, соответствующие элементу и показываемые в панели задач.

6.2.3 Использование операций вырезать, копировать и вставить в Application

Explorer

Использование операций вырезать, копировать и вставить в Application Explorer

Задачи вырезать, копировать и вставить могут быть использованы для многих

из объектов настройки в Application Explorer и могут ускорить разработку

вашего приложения. Задачи вырезать, копировать и вставить особенно

полезны при настройке дерева переменных, так как их можно использовать для целых ветвей, включая переменные и их поведение.

Задачи вырезать и копировать контекстно зависимы. Они появляются только в

панели задач, когда объект конфигурации, выбранной в панели содержимого,

поддерживает их. Иллюстрация

Задача Вставить также контекстно зависима. Она появляется только, когда

папка соответствует скопированному объекту, выбранному в дереве

конфигурации. Например, если вы копируете ветвь дерева переменных, то

задача Вставить ветвь будет появляться только, когда выбрана папка дерева переменных, или одна из подчиненных папок.


55


Операции вырезать, копировать и вставить нельзя использовать на

объектах настройки Application Explorer. Смотрите раздел Объекты

Application Explorer, поддерживающие операции вырезать, копировать и

вставить(See 6.2.4) для знакомства со списком основных поддерживаемых объектов.

Дополнительные сведения об операциях Вырезать, копировать и вставить

для определенной конфигурации объектов см. разделы справки для этих

объектов.

Сочетания клавиш клавиатуры и контекстных меню

Когда объект конфигурации поддерживает операцию вырезать, копировать и

вставить, то можно также использовать обычные сочетания клавиш Windows:

Ctrl X, Ctrl C и Ctrl V . Команды Вырезать, копировать и вставить также

появляются при нажатии правой кнопки мыши (контекстное меню) поддерживаемых объектов.

Что происходит при вставке объекта конфигурации?

При вставке объекта конфигурации, создается новый объект с такой же

конфигурацией как объект, который был вырезан или скопирован. Имя для

нового объекта предлагается в окне, которое открывается во время процесса

вставки. Если при вставке объект с таким же именем уже существует, то будет

предложено новое имя, в противном случае будет использоваться исходное


56

имя. Иллюстрация

В тех случаях, когда объект имеет подчиненные объекты, то они будут

включены во вставку. Например если вы копируете OPC-сервер с двумя OPC-

группами, то при вставке новый OPC-сервер также будет содержать две OPC-группы.

В тех случаях, когда объект содержит имена другого объекта в рамках своей

конфигурации, то могут потребоваться изменения вручную для нового объекта

после процесса вставки. К примеру, для регистра, который имеет четыре

зависимых пороговых значения переменных, вам придется вручную изменять

имена порогового значения переменных после вставки. Объяснения смотрите в

разделах справки для соответствующих объектов.

Напоминание о разнице между операцией копирования и вырезания

Копирование создает копию выбранной настройки объекта. Его можно

вставить любое количество раз.

Операция вырезать делает копию выбранной настройки объекта. Эта

копия может быть вставлена только один раз. После вставки будет удален исходный объект, который был вырезан.

Супервизор использует буфер обмена Windows?

Во время выполнения процесса вырезать и вставить или скопировать и

вставить используется буфер обмена Windows для хранения имени и типа

объекта. Он не используется для хранения всех конфигураций объекта. Если

вставить содержимое буфера обмена в стороннее приложение, например, в Блокнот, то вы просто получите имя объекта.

6.2.4 Объекты Application Explorer, поддерживающие операции вырезать,

копировать и вставить

Объекты Application Explorer, поддерживающие операции

вырезать, копировать и вставить

Ниже приведен список конфигурационных объектов и поддержка ими операций

вырезания, копирования и вставки. Ограничения или особенности, связанные с

операциями вырезать, копировать и вставить можно найти в справке для этих

объектов.

Получение данных Поддержка


57

OPC Да

Оборудование Нет

IEC 60870-5-104 Да

DNP3 Да

IEC 61850 Да

LonWorks Да

BACnet Да - Есть ограничения

DDE Да

Сетевая работа Поддержка

Станции Нет

Списки Нет

Группы Нет

Переменные Поддержка

Дерево переменных Да - Есть ограничения

Области Да

Характеры Да

Выражения Да - Есть ограничения

Синтез тревоги Да

Архивы Поддержка

Архивные модули Да*

Базы данных Да

Группы трендов Да

* Не для модуля VCR, так как разрешен только один такой модуль в проекте.

Действия Поддержка

Сообщения Да

События Да - Есть ограничения

Циклические Нет


58

6.3 Smart Generator

6.3.1 Что такое Smart Generator?

Что такое Smart Generator?

Smart Generator – это инструмент для генерации настроек проекта

Супервизора путем импортирования их из файлов, созданных сторонним

программным обеспечением, таким, как системы программирования PLC или

XML-файлы. Smart Generator работает, используя прямую связь с

конфигурацией Супервизора. Иллюстрация

Импорт файлов, подготовленных сторонним программным обеспечением,

производится с помощью мастера, уникального для каждого типа файлов. В данной версии поддерживаются следующие версии:

CAD: импорт объектов в формате программы AutoDesk AutoCAD.

FL: HMI и SCADA программы.

Generic: из файла формата XML (Extensible Markup Language).

ICS Triplex: ISaGRAF.

LNS: программное обеспечение для управления сетями Echelon LonWorks.

Schneider Electric: Unity Pro.

Siemens SIMATIC Step7.

WAGO: CoDeSys.

WAGO: DALI.


59

Yokagowa: Stardom

О мастерах импорта файлов, созданных сторонним ПО

Обычно мастера импорта из стороннего ПО ограничиваются созданием базы

данных переменных и связей. Несмотря на это, мастера – это не простые

инструменты для конвертирования – они позволяют фильтровать,

конвертировать и модифицировать структуру данных таким образом, чтобы

данные могли использоваться Супервизором. С помощью мастеров вы можете:

Сортировать переменные, которые должны быть импортированы

o По имени, используя фильтры

o По типу данных o По типу переменных (цифровая, текстовая, логическая)

Управлять именами переменных

o Автоматически добавлять имя ветви

o Автоматически создавать разделители ветвей

o Вручную редактировать имена переменных, чтобы убрать несовместимость со схемой именования переменных Супервизора

Синхронизировать базу данных Супервизора с проектными файлами

стороннего ПО

o Синхронизировать списки переменных, измененные по сравнению

с предыдущим проектом

o Добавлять или убирать переменные в базе данных Супервизора,

которые были добавлены или убраны в стороннем ПО с момента предыдущего импорта

О мастере импорта XML

Этот мастер – утилита для конвертации данных из XML-файла в проект

Супервизора. Нет возможности фильтровать данные или каким-то способом

модифицировать их. Мастер разработан, чтобы импортировать все настройки Супервизора, но в данной версии вы ограничены следующими пунктами:

Область и характер

Сервера и группы OPC

Переменные и ветви базы данных

6.3.2 Работа Smart Generator

Работа Smart Generator

Запуск Smart Generator производится из меню Супервизора

Конфигурация.Smart Generator. В главном окне Smart Generator находится список задач, список завершенных импортов и главное меню. Иллюстрация


60

Список завершенных импортов

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

Список задач

В списке задач содержится список возможных команд для управления импортом переменных.

Меню

Меню содержит два пункта

Файл.Выход – закрывает Smart Generator

Вид.Панели – показывает или скрывает панель инструментов

6.4 Application Architect

6.4.1 Что такое Application Architect?

Что такое Application Architect

Application Architect является инструментом создания приложения для

Супервизора (проекта) с помощью экземпляров шаблонов (так же известных

как модели), которые представляют реальные объекты наблюдаемого

процесса. Шаблон может представлять что угодно: от простого выключателя до завода со всеми процессами.

Шаблоны и экземпляры могут включать:


61

Переменные с

o трендами

o событиями o тревогами

Мнемосхемы (с заранее заданными шаблонами мнемосхем)

Символы (из библиотек Супервизора)

6.4.2 Окно Application Architect

Окно Application Architect

Рабочая область окна Application Architect содержит следующие компоненты.


Левая панель и панель инструментов - отображают доступные шаблоны

или параметры. Хотя эта панель имеет вид дерева, она является

панелью инструментов. Двойной щелчок по объекту (по шаблону или

параметру) вставляет экземпляр в объект, выбранный в правой панели.

Правая панель - содержит три вкладки - экземпляры, шаблоны и

параметры.

o Экземпляры - см. тему Вкладка экземпляры(See 6.4.5).

o Шаблоны - см. тему Вкладка шаблоны(See 6.4.3).

o Параметры - см. тему Вкладка параметры(See 6.4.4).

Вcплывающее меню - появляется при нажатии правой кнопки мыши. Команды в нем повторяют команды панели инструментов.


62

Главная панель инструментов - инструменты, доступные для выбранного элемента конфигурации.

Меню - список команд, см. список ниже.

Можно изменять размер панелей Application Architect с помощью курсора.

Изменения, сделанные Вами, сохраняются даже после перезапуска Супервизора.

При первом запуске Application Architect все деревья настроек свернуты.

Все элементы будут иметь символ + , обозначающий вложенные элементы

- даже если их там нет. Это происходит из-за того, что Application Architect

загружает конфигурации ветвей только при попытке их развернуть.

Попытка загрузить все ветви при старте Аpplication Architect могла бы

занять много времени.

Команды меню

Файл.Сохранить (Ctrl+S) - сохранить текущую конфигурацию.

Файл.Выход (Alt+F4) - закрыть Application Architect. При закрытии сохранятся все изменения.

Вид.Панели.Параметры - показывать параметры в левой панели.

Вид.Панели.Шаблоны - показывать шаблоны в левой панели.

Задачи. Проверить (F5) - проверка топографии конфигурации.

Задачи.Генерировать (F7) - создать приложение.

Использование библиотек для хранения шаблонов и параметров

Так же как и с символами, возможно выбрать библиотеку, в которой буду

хранится созданные шаблоны и параметры. Шаблоны и параметры

сохраняются в папку Templates библиотеки.

Напоминание про библиотеки

содержание локальной библиотеки доступно только в текущем проекте.

содержание общей библиотеки доступно во всех проектах.

можно создать свою библиотеку, которая будет доступна только проекты или всем проектам.

Дополнительная информация находится в разделе справки, посвященном

разработке интерфейса.

6.4.3 Вкладка Шаблоны

Вкладка Шаблоны


63

Вкладка Шаблоны используется для создания, отображения и настроек

шаблонов. Иллюстрация.

Так же как и вкладки Экземпляры и Параметры, она разделена на две части. В

левой части находится дерево, в котором можно выбирать шаблоны. В правой -

второе дерево, представляющее выбранный в левой части шаблон и его свойства.

Всплывающее меню

При нажатии правой кнопки мыши на папке, категории или объекте

вызывается всплывающее меню. Команды меню зависят от выбранного объекта.

Вырезать - вырезать выделенное.

Копировать - копировать выделенное.

Вставить - вставить вырезанные и копированные элементы.

Добавить категорию -добавить категорию (подпапку) в библиотеку или категорию.

Добавить шаблон - добавить новый шаблон в выбранную папку или

категорию.

Добавить наследуемый шаблон - добавить наследуемый шалон выбарнному шаблону.

Для всех команд добавления есть соответствующая команда удаления.

Удаление объекта удаляет все его экземпляры.

Второе всплывающее меню

Второе всплывающее меню вызывается правой кнопкой мыши по папке или объекту. Команды меню зависят от выбранного объекта.

Отменить выбор - не учитывать отмеченное при создании приложения. Конфигурация остается деревом.


64

Выбрать - снять флаг "Отменить выбор" (см.выше).

Копировать - копировать выбранное.

Вставить - вставить вырезанное или скопированное.

Добавить переменную - добавить переменную в шаблон.

Добавить тренд - добавить тренд (запись исторических данных) для

выбранной переменной.

Добавить событие - добавить событие (которое запускает программу) для выбранной переменной.

Добавить поведение тревоги - добавить события для тревоги.

Добавить встроенный шаблон - добавить встроенный шаблон для выбранного шаблона.

Добавить мнемосхему - добавить мнемосхему в шаблон.

Добавить символ - добавить графический символ в шаблон (экземпляр на мнемосхему).



Что такое категория?

Категория используется для органиации шаблонов. Создание категории не

создает реальную подпапку в структуре библиотеки проекта.

6.4.4 Вкладка Параметры

Вкладка Параметры

Вкладка Параметры используется для отображения, организации и изменения

параметров. Иллюстрация.


65

Так же как и вкладки Экземпляры и Шаблоны, она разделена на две части. В

левой части находится дерево, в котором можно выбирать параметры. В правой

- второе дерево, представляющее выбранные в левой части параметры и их свойства.


При нажатии правой кнопки мыши на папке, категории или объекте

вызывается всплывающее меню. Команды меню зависят от выбранного

объекта.




Добавить категорию - добавить категорию (подпапку) в библиотеку или

категорию.

Удалить категорию - удалить выбранную категорию с ее содержимым.

Добавить параметр - добавить новый параметр в выбранную папку или категорию.

Удалить параметр - удалить выбранный параметр и его экземпляры.

Что такое категория?

Категория используется для органиации шаблонов. Создание категории не создает реальную подпапку в структуре библиотеки проекта.

6.4.5 Вкладка Экземпляры

Вкладка Экземпляры

Вкладка Экземпляры используется для создания, отображения и настроек

экземпляров шаблонов. Иллюстрация.


66

Так же как и вкладки Шаблоны и Параметры, она разделена на две части. В

левой части находится дерево, в котором можно выбирать экземпляры

шаблонов. В правой - свойства выбранных элементов для просмотра и изменения.


При нажатии правой кнопки мыши на папке, шаблоне или объекте вызывается всплывающее меню. Команды меню зависят от выбранного объекта.




Добавить элемент топологии - добавить папку в топологию.

Добавить шаблон - добавить новый экземпляр шаблона.



Второе всплывающее меню

Второе всплывающее меню вызывается правой кнопкой мыши по папке или объекту. Команды меню зависят от выбранного объекта.

Отменить выбор - не учитывать отмеченное при создании приложения.

Конфигурация остается деревом.

Выбрать - снять флаг "Отменить выбор" (см.выше).

Добавить переменную - добавить переменную в экземпляр шаблона.

Добавить тренд - добавить тренд (запись исторических данных) для выбранного экземпляра переменной.

Добавить событие - добавить событие (которое запускает программу) для выбранного экземпляра переменной.

Добавить мнемосхему - добавить мнемосхему в экземпляр шаблона.

Добавить символ - добавить графический символ в экземпляр шаблона.



6.4.6 Свойства

Свойства

Свойства всех объектов Application Architect (шаблоны, параметры и т.д.)

отображаются в виде сетки свойств. Свойства сгруппированы в соответствии с


67

их использованием . Иллюстрация

Основные возможности

Развернуть/свернуть группу свойств нажатием знака +/- около их имени.

Изменение значения параметра нажатием правой кнопкой мыши по

левой колонке. Большинство значений могут быть введены напрямую или выбраны из выпадающего списка.

Свойства только для чтения отображаются серым.

Измененные вручную свойства отображаются жирным шрифтом.

Свойства отображаются в алфавитном порядке.

Всплывающее меню сетки свойств

При нажатии правой кнопкой мыши в левом столбце свойств откроется всплывающее меню

Описание - дополнительная информация о выбранном параметре

появляется под списком свойств.

Расширенные - отображать расширенные свойства. Зависит от

выбранного объекта.

Сбросить - сбросить все параметры в исходные.

Определено - разрешить подставлять выражение или параметр. Доступно не для всех свойств.


68

7. О проектах Супервизора

7.1 О конфигурационных файлах проекта

О конфигурационных файлах проекта

Большинство информации, введенной разработчиком через меню

Конфигурация, хранится в ASCII файлах с разделением данных запятой, или в

XML файлах. Это имеет два преимущества:

файлы могут быть легко проверены автономно с помощью подходящего

текстового или XML редактора.

очень легко копировать файлы в другой проект.

ASCII файлы, которые хранятся в каталоге "С" проекта:


ACTION.DAT Конфигурация ассоциированных действий.

COMM.DAT Конфигурация связанных сетей, узлов и фреймов.

CRON.DAT Конфигурация действий планировщика.

CYCLIC.DAT Конфигурация циклических действий.

DB.DAT

DRAWDEFAULT.DAT Свойства по умолчанию для графических элементов

при их создании.

EVENT.DAT Конфигурация любых событийно управляемых действий.

EXPRM.DAT Модели выражений.

EXPRV.DAT Выражения переменных базы данных.

FORMULA.DAT Конфигурация всех используемых формул.

GPCONF.DAT

HDSCONF.DAT Конфигурационный файл исторического сервера данных (HDS).

HDSTREND.DAT Конфигурационный файл трендов исторического

сервера данных.

HISTO.DAT Конфигурация файлов архива, фильтров журналов и

отчетов, а так же список всех переменных базы

данных, которые записываются.

IMPORTREFERENCES.DAT Информация о файлах, импортированных в Smart generator.

KEY.DAT Конфигурация любых действий клавиатуры.

LPRINTER.DAT Конфигурация принтера.

MRUFILES.DAT Список последних по времени использования мнемосхем.

OPTIONS.DAT Разнообразные конфигурационные опции.

PALCOL.DAT Конфигурационный файл цветовой палитры.

PARAM.DAT Конфигурация запуска проекта, предпочтения, имена пользователей и т.д.


69

PARAMWS.DAT Конфигурационные настройки окна.

PREFCOL.DAT Цветовые предпочтения.

POPU.DAT Совокупные конфигурации.

RECIPE.DAT Список рецептов. Рецепты хранятся отдельно в

каталоге R.

SCRIPT.DAT

STATION.DAT Конфигурации сети.

TABLE.DAT Связанные метки, области и характеры.

TSPREFS.DAT

UIVCONF.DAT

USER.DAT Конфигурационный файл с именами пользователей,

паролями и правами. В зависимости от выбранной

опции, файл может быть зашифрован.

VARCONF.DAT Конфигурационный файл свойств переменных.

VAREXP.DAT Конфигурация базы данных в расширенном формате файла.

VARTREAT.DAT Конфигурационный файл особой обработки

переменных.

XML файлы, хранящиеся в каталоге "С" проекта:


MAILCONFIG.XML Настройка способности Супервизора отправлять почту.

SCHEDULER.XML Настройка планировщика задания для HDS.

7.2 Совместимость с проектами, созданными в предыдущих

версиях Супервизора

Совместимость с проектами и библиотеками более ранних версий Супервизора

Этот раздел содержит сведения о некоторых хорошо известных ограничениях

или мерах предосторожности, которые должны быть приняты в отношении

проекта и библиотек при обновлении с одной версии Супервизора на другую.


70

Технические ресурсы в интернете содержат дополнительные сведения о

стратегиях переноса и наилучших практиках.

Обратная совместимость

Обратная совместимость - это когда проект выполняется и полностью

поддерживается (если не указано иное) в среде более поздней версии

Супервизора, чем та версия Супервизора, в которой проект был создан.

В тех редких случаях, когда новые функциональные возможности меняют

конкретные настройки так, что не выполняется условие обратной

совместимости, то добавляется параметр обратной совместимости для

включения предыдущего поведения.

Если запустить проект и библиотеки из более ранней версии Супервизора, то

отображается окно предупреждения о том, что после того, как проект и

библиотеки запущены в текущей версии, они больше не могут быть

совместимы с любой более ранней версией.

Это ответственность пользователя следить за регулярным резервным

копированием проекта и библиотек. В частности, следует делать

резервные копии проекта и библиотек перед удалением или

запуском обновления Супервизора. Смотрите раздел Сохранение и

восстановление проектов и библиотек(See 4.5).

Прямая совместимость

Прямая совместимость не поддерживается, при которой проект, созданный в

новой версии Супервизора, будет работать в среде более старой версии

Супервизора. Любая попытка сделать это является исключительным риском

пользователя.

Совместимость с проектами, созданными в более ранней версии Супервизора (Версии 6, 7, 8, 9 и 10)

1. Расширение для функционирования HDS означает, что структуры

таблиц, используемых в версии 9.0 и более ранних версиях, не

совместимы со структурами таблиц в более поздних версиях. Для

информации о том, как записанные данные могут быть перенесены, смотрите разделе Миграция из 9.0 в 10.0 в книге Архивы.

2. Общие библиотеки, поставляемые в дистрибутиве Супервизора,

постоянно совершенствуются. В частности, новый набор библиотек

поставляется с версией 11. Пользователям с проектами, использующими

общие библиотеки, необходимо убедиться, что они принимают


71

необходимые меры резервного копирования перед запуском процесса

обновления. Если резервные копии доступны, то библиотеки могут быть

просто восстановлены, как только обновление установлено, используя

процедуру, описанную в разделе Сохранение и восстановление

проектов и библиотек.

Совместимость с 16-разрядными (Windows 3.1) проектами Супервизора

(Версии 2, 3 и 4)

Проекты, созданные 16-разрядной версией Супервизора, как правило,

совместимы. Однако некоторые из более ранних выпусков 32-разрядной

версии имеют незначительные ограничения в функциональных возможностях.

Также некоторые из протоколов, доступных в 16-разрядной версии, не были

реализованы из-за ограничений в инструментальных средствах, доступных от

изготовителей. Если есть сомнения, пожалуйста, свяжитесь с технической поддержкой.

Вы должны установить программное обеспечение в новый каталог и затем

скопировать файлы приложения в каталог USR. Подробности о том, какие

файлы куда копировать, см. в разделе о структуре папок проекта.

Как только Вы запустили приложение в 32-разрядной версии, оно не будет совместимо с 16-разрядной версией.

Совместимость с DOS проектами

Проекты, созданные с DOS-версией, не являются прямо совместимыми. Однако

высокий процент конфигурационной информации может быть восстановлен, и

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

Настройки совместимости

1. Откройте Application Explorer и выберите верхнюю папку (Проект).

2. Выберите Настройки. Откроется окно настроек проекта и там выберите

пункт Совместимость.

7.3 Сохранение и восстановление проекта

Сохранение и восстановление проектов и библиотек

Этот раздел не является полным руководством по резервному копированию и

восстановления. Он включает в себя минимальные меры предосторожности,

которые вы должны принять, чтобы не потерять какие-либо компоненты,

необходимые для запуска проекта.

Создание резервных копий и проверка их корректности являются


72

важной частью разработки.

Резервное копирование

Содержимое резервной копии приложения Супервизора должно содержать как

минимум:

• Сам проект.

• Все общие библиотеки, котрые используются.

Кроме того, вашему приложению могут требоваться сторонние приложения,

инструменты и файлы для настройки, не описанные далее.

Использование Централизованного управления проектами может помочь

вам управлять резервными копиями вашего проекта. Смотрите книгу

Использование централизованного управления проектами.

Смотрите также важное замечание о библиотеках в разделе Удаление

программного обеспечения в книге Установка программного

обеспечения.

Как сделать резервную копию проекта

Каждый проект содержится в папке с тем же именем, что и проект в папке

ROOT\USR, где ROOT — корень проекта.

Корень проекта обычно является тем же самым что и расположение

Супервизора, хотя его можно изменить, используя параметр командной строки

-b. Если вы сомневаетесь, проверьте свойства ярлыка, который используется

для запуска Супервизора.

Для создания резервной копии проекта используйте инструменты

сжатия, чтобы сохранить содержимое проекта в одном файле.


73

Если проект содержит любые дополнительные локальные библиотеки,

то они уже включены в структуру папок проекта.

Как сделать резервную копию общих библиотек

Общие библиотеки из папки LIB размещаются в папке ROOT.

• Для резервного копирование общей библиотеки используйте инструменты

сжатия, чтобы сохранить библиотеки и их содержимое как единый файл.

Как восстановить проект из резервной копии

• Распакуйте файл резервной копии проекта в папке ROOT\USR.

Как восстановить общие библиотеки из резервной копии

1. Распакуйте резервную копию папки LIB во временную папку.

2. Замените (не объединяйте) установленную папку LIB на папку LIB, которую

вы распаковали на шаге 1.

Как использовать общие библиотеки, поставляемые с текущей версией

Супервизора и библиотеки из резервной копии

1. Распакуйте резервную копию папки LIB во временной месте.

2. Скопируйте папки каждой библиотеки, которые вам нужны, в папку LIB

текущей версии.

3. Используйте Менеджер библиотек в Супервизоре для добавления каждой из

библиотек, которую вы импортировали в проект из резервной копии. Смотрите

раздел Как добавить существующую библиотеку в книге Application

Explorer.Библиотеки.

Устаревшие инструменты PKZIP


74

Утилита PKZIP не совместима с 64-битными операционными системами.

Совместно с Супервизором поставляются устаревшие пакетные файлы для

сохранения и восстановления проектов. Эти пакетные файлы используют

инструмент сжатия PKZIP25, предоставляемый PKWARE, лицензированная

версия которого устанавливается с Супервизором. Пакетные файлы могут быть

найдены в корневой папке Супервизора, и должны выполняться из командной

строки DOS. Доступны следующие пакетные файлы:

Пакетный файл Действие

sProject.bat ProjectName

Проект ProjectName и все его подкаталоги

архивируются и сохраняются в ProjectName.Zip, расположенном в корневом каталоге Супервизора.

Это может использоваться только с проектами в заданном по умолчанию проектном корневом каталоге.

sProject_a.bat

ProjectName

Проект и все его подкаталоги сжимаются и

сохраняются в ProjectName.Zip на диске A: (гибкий диск).

s1Lib.bat LibraryName Единая общая библиотека LibraryName сжимается и

сохраняется в LibraryName.Zip, расположенном в корневом каталоге Супервизора.

sAllLib.bat Все общие библиотеки сжимаются и сохраняются в

Lib.Zip, расположенном в корне Супервизора.

sPro&Lib.bat

ProjectName

Проект ProjectName и все его подкаталоги сжимаются и

сохраняются в ProjectName.Zip. Общие библиотеки

сжимаются и сохраняются в Lib.Zip. Оба файла размещаются в корне Супервизора.

sPro-His.bat

ProjectName

Проект ProjectName и все его подкаталоги кроме

исторических файлов данных сжимаются и

сохраняются в ProjectName.Zip, расположенном в корне Супервизора.

LoadAll.bat ProjectName Проект ProjectName и все его подкаталоги извлекаются

из ProjectName.Zip и сохраняются в каталоге

ProjectName, расположенном в каталоге проектов Супервизора.

Общие библиотеки извлекаются из Lib.Zip и

сохраняются в каталоге Lib. ProjectName.zip и Lib.Zip должны быть расположены в корне Супервизора.

7.4 Использование шаблона проекта

Использование шаблона проекта


75

Шаблон проекта - это проект Супервизора, который сконфигурирован обычным

образом и затем скопирован в папку шаблонов. Когда Супервизор стартует он

проверяет папку шаблонов, и, если находит шаблон, то содержимое его папки

копируется в папку текущего проекта. ТОЛЬКО ПАПКИ И ФАЙЛЫ КОТОРЫЕ

ЕЩЕ НЕ СУЩЕСТВУЮТ МОГУТ БЫТЬ СКОПИРОВАНЫ. Таким образом

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

Для обновления проекта Супервизора после изменений любых файлов в

каталоге TPL необходимо остановить Супервизор, удалить аналогичные

файлы в проекте и перезапустить Супервизор.

Как создать шаблон проекта

1. Создайте проект и настройте в нем то, что необходимо.

2. Создайте новую папку с именем TPL для шаблона проекта. По

умолчанию Супервизор рассчитывает найти папку шаблона в корневой

папке проекта. Это папка, которая содержит USR, LIB, ETC, и т.д.

3. Скопируйте подпапку проекта (3D, B, C, etc.) в папку TPL.

Вы можете хранить шаблон проекта в любом другом месте, доступном

Супервизору, но тогда будет необходимо настроить путь способом, описанном ниже.

Настройка работы шаблона проекта

Вы можете настроить работу шаблона проекта добавлением параметров в файл инициализации Супервизора SV32.INI, расположенный в каталоге BIN.

Не изменяйте файл SV32.INI другими способами.

Параметры должны быть добавлены в раздел начиная с заголовка [Template Project]. Они могут содержать следующие настройки.

Опция Значение

Disabled Отключение функциональности (значение 1) или разрешение ее

(значение 0, по умолчанию).

Dir Задание папки шаблона проекта. По умолчанию:

% ProjectsDir%\TPL.

Параметры пути обозначают следующее

Полный путь, можно задать любую папку.

% ProjectsDir%: корневой каталог проекта. Это каталог, в который был

установлен Супервизор, за исключением случаев использования

команды -b для определения альтернативного местоположения папки

проекта.

% ProgramFilesDir%: папка программы. Это папка, которая содержит

программы и средства, которые содержаться в Супервизоре. Обычно это каталог BIN.


76

Пример параметров в SV32.INI

Установка Шаблон проекта ...

[Template Project]

Disabled=1

не используется.

[Template Project]

Dir=C:\SV_TEMPLATE

находится в C:\SV_TEMPLATE.

[Template Project]

Dir=%ProjectsDir%\SV_TEMPLATE

находится в подкаталоге SV_TEMPLATE папки

проекта.

[Template Project]

Dir=%ProgramFilesDir%\TPLPROJ

находится в подкаталоге TPLPROJ папки

программы Супервизора.

8. Application Explorer

9. Application Architect

10. Smart Generator

11. Разработка HMI

12. Языки программирования

12.1 О языках программирования

О языках программирования

Супервизор поддерживает три языка программирования.

SCADA Basic

SCADA Basic имеет блочную структуру и является интерпретируемым языком с

синтаксисом, близким к стандарту Basic. SCADA Basic принадлежит Супервизору.

Cypress Enable

Cypress Enable не поддерживается версией 11.0 или более поздними

версиями Супервизора. Однако можно конвертировать в VBA скрипты

Enable, разработанные в более ранних версиях Супервизора, to VBA. По этому вопросу обращайтесь в службу технической поддержки.


77

VBA

VBA (Visual Basic for Applications) - язык программирования, созданный

Microsoft. Он является подмножеством их Visual Basic (VB) языка, созданного

для автоматизации приложений – изначально Office 97, но сейчас

встраиваемого в больше чем 200 сторонних приложений. Супервизор

предоставляет доступ VBA к среде разработки, мнемосхемам, графическим

элементам, символам, анимациям и значениям реального времени базы данных переменных (все это вместе известно как объекты Супервизора).

Справочная информация по VBA, включая объекты Супервизора, находится в

справке, открывающейся из редактора VBA. Она доступна только на

английском языке.

12.2 SCADA Basic

12.3 VBA and Enable

12.3.1 Differences between Enable and VBA

Differences Between Enable and VBA

Whilst both Cypress Enable and MS VBA are VBA style languages and it is possible

to cut and paste code between them (within limitations) there are some major

differences in both the language and the way in which it has been implemented within the Supervisor.

Cypress Enable is always available, MS VBA is a chargeable option that must

be specified when the Supervisor is purchased.

To script an event with VBA the object must have the VBA Control property

set to true. Show picture.

To script a symbol with VBA the symbol must have the Symbol Project in

VBA property set to true.


78

Database variables are managed and referenced differently in Enable and

VBA

Symbols are managed and scripted differently in Enable and VBA.

The Enable and VBA development environments are very different.

o The VBA development environment is richer (and correspondingly

more complex) with many tools to aid the development process.

o In Enable, the design/run mode of the development environment is

independent of the design/run mode of any mimics. That is, a mimic

can be in run mode whilst it's scripts are in design mode. When

design mode is selected all scripts are in design mode.

In VBA, the design/run mode follows that of the corresponding

mimic. If one mimic is in design mode and another mimic is in run

mode the scripts for the mimic in run mode will run normally.

The VBA project explorer is only able to display objects nested to a

depth of two. The effect of this is that several VBA projects appear in

the VBA project explorer for a single Supervisor project. There will be

a project for the Workspace (Main), for each opened mimic, and each

type of symbol in any open mimic.

12.3.2 Understanding Objects, Properties, Methods and Events

Understanding Objects, Properties, Methods and Events

Objects are the fundamental building block VBA style scripting languages. Almost

everything you do involves modifying objects. Most of the elements of the HMI, the

project, and the database variables can be represented by an object in the scripting language.

What are Objects and Collections?

An object represents an element of The HMI such as a window or drawing element.

A collection is an object that contains several other objects, usually of the same

type. Using properties and methods, you can modify a single object or an entire collection of objects.

What is a Property?

A property is an attribute of an object or an aspect of its behavior. For example,

properties of a window include its name, its size and position. To change the characteristics of an object, you change the values of its properties.

The following example changes the colour of the drawing element 'Shape_Red'.

Shape_Red.BackColorPrimary = RGB(255, 0, 0)

You can also retrieve information about an object by returning the value of one of

its properties. The following example returns the height of a drawing object.

ObjHeight = Object_Truck.Height

In this example, Object_Truck refers to a drawing element. The height of that

drawing element is assigned to the variable ObjHeight.

Not all properties can be set – some are read-only.

What is a Method?

A method is an action that an object can perform. For example, just as a drawing

element can be moved, the drawing element object has a Move method. Methods


79

normally have arguments that qualify how the action is performed. The following example moves the bitmap Bitmap1 to a new location within its window.

Bitmap1.Move NewXPos, NewYPos

In most cases, methods are actions and properties are qualities. Using a method

causes something to happen to an object, whereas using a property returns

information about the object or it causes a quality of the object to change.

What is an Event?

An event is an action recognized by an object, such as clicking the mouse or

pressing a key, for which you can write code to respond. Events can occur for a

number of reasons:

A user action such as clicking a mouse or pressing a key.

A subscribed variable changing value.

Because of other program code.

Something happening in the system.

12.3.3 Using Collections

Using Collections

A collection is an object that contains several other objects, usually of the same

type. Using properties and methods, you can modify a single object or an entire

collection of objects.

Returning an Object from a Collection

Most objects are obtained by returning a single object from the collection. For

example, the Windows collection contains the open windows for The HMI. You use the Windows property of the ActiveProject object to return the Windows collection.

After you have accessed the collection, you can return a single object by using an index value in parentheses (similar to the way you work with arrays).

The index value is usually a number or a name. The following example displays the name property of the first window opened in a message box:

Dim objWindows As Object

Dim sTitle As String

Const IconInformation = 64

sTitle = "Position of Window 1"

Set objWindows = ThisProject.Windows

MsgBox "Left = " & objWindows.Item(1).Left & " Top = " & _

objWindows.Item(1).Top, IconInformation, sTitle

Note the use of the underscore as a line continuation character.

Looping Through a Collection

You can loop through the elements of a collection in different ways. However, the

recommended method for looping on a collection is to use the For Each...Next loop.


80

In this structure, the scripting language repeats a block of statements for each object in a collection.

The following example displays the name of each open mimic in the Mimics collection:

Dim objMimic As Object

Dim sTitle As String

Const IconInformation = 64

sTitle = "Opened mimics"

For Each objMimic In ThisProject.Mimics

MsgBox objMimic.Name & " " & objMimic.Caption, IconInformation, sTitle

Next

12.3.4 The Supervisor's objects

The Supervisor's Objects

The properties, methods and events of Supervisor's objects allow the User to

develop any customized behavior needed for the supervision and control of the

process. Some object instances are always available as part of the core

functionality (for example ThisProject) whereas others are created as part of the application (for example an opened mimic).

Instance in Instance in

Class Represents Cypress VBA

Application The HMI application. ThisApplication Application

AVI An AVI object.

Bitmap A bitmap object. This class

supports BMP and JPG image formats.

fvProject The currently opened project. ThisProject ThisProject

GIF A GIF object. This class

supports GIF image formats.

Graphics A collection representing all

drawing objects within a

mimic. The following object classes are included.

AVI

Bitmap

GIF

Group

Metafile

OLE

Poly

Shape

Symbol

Text

Graphics Graphics

Group A group object. A number of

drawing elements that have

been grouped together. (Not a

symbol inserted from the libraries)


81

Metafile A metafile object. This class

supports WMF and EMF image formats.

Mimic An opened mimic. ThisMimic

Mimics A collection representing all opened Mimic objects.

TheseMimics TheseMimics, Mimics

OLE A third party OLE object. Its

properties, methods, functions

and events are exposed once it

is inserted into a mimic. For

information on the behaviour

of the object see the

documentation provided by the vendor.

Poly A polygon/polyline object. This

class includes the Line,

Polyline,Polygon and Bézier curve drawing elements.

Recipe A list of inqredients and variables.

Shape A shape object. This class

includes the Rectangle,

Rounded Rectangle, Ellipse, Arc and Half-arc drawing elements.

Symbol Symbol Library. (Previously known as an object)

System A set of properties that

describes the system on which

the HMI is running.

ThisSystem, System

ThisSystem, System

TemplateGraphics A collection representing all

drawing objects within a mimic

template. Identical to the

Graphics Collection except that

it points to the graphics of a

mimic template. If the mimic

has no template then

TemplateGraphics is redirected

to Graphics. The

TemplateGraphics collection is not available in Cypress

TemplateGraphics

Text A text object. This class

includes the Text drawing element.

UIAlm An alarm display object.

UILog A log display object.

UITrd A trend display object.

Variable A currently subscribed variable.

It provides properties, methods

and events for variables of all

types.

Variables A collection representing all TheseVariables TheseVariables,


82

currently subscribed variables. Variables

Window A view of an opened mimic. A

mimic can have several views

opened simultaneously. For

example, one in design mode

and the other in run mode.

Windows A collection representing all opened Window objects.

TheseWindows, Windows

Windows

12.3.5 Making drawing elements respond to the mouse pointer

Making Drawing Elements Respond to the Mouse Pointer

This topic describes how to make drawing elements respond visually when the mouse pointer is held over them.

Show picture

Method

1. Select a drawing element and open the Properties List (View.Properties

List).

2. Select the DisplayMouseInput property and set it to True. (Click on the value, click on the button marked '...' and select True.)

Effects

When you hold the mouse pointer over the drawing element, it responds as if it

had a Send animation. When elements overlap, the effects depend on the combination of the DisplayMouseInput property and any animations.

Elements Effect

One element with the property True It responds all over.

Two elements:

- one with the property True - one with an animation

Each element responds separately except

that when the pointer is over the overlap,

both respond.

Two or more overlapping elements, both

with the property True (or both with animations)

Each element responds separately. Only

the one in front responds in the overlapping area.

Three or more overlapping elements. They respond separately except that

when the pointer is over the overlap of a

particular pair - one with the property


83

True, the other with an animation - that pair will respond together.

12.3.6 Using Cypress Enable

Cypress Enable is not supported by version 11.0 or later of the Supervisor.

However, it is possible to convert and/or replace Enable scripts, developed with

earlier versions of the Supervisor, to VBA. Please contact technical support for further information.

12.3.7 Using MS VBA

12.3.7.1 About VBA

About VBA

The information contained in this help manual explains features of VBA that are

specific to its implementation for the Supervisor. The help does not provide general information on VBA or on programming in general.

If you are unfamiliar with VBA, you would benefit from tuition before you attempt any programming in the Supervisor:

By working through one of the many available books on VBA, with examples

of code.

By contacting your distributor for details of training courses.

Reference information for VBA, including the Supervisor's objects, may be

found in a help file opened from the Help entry in the VBA editor menu. This help file is only available in the English language.

12.3.7.2 The VBA development environment

12.3.7.2.1 How the VBA project explorer interacts with the HMI

How the VBA Project Explorer Interacts with the HMI

In the VBA Project Explorer there are Projects, Project Items and Controls. A single HMI application is seen in the VBA Project Explorer as several discrete projects.

Show picture


84

To display the Project Explorer box, use CTRL+R on the keyboard or select the menu View.Project Explorer.

The Main project (Workspace)

The Main project always exists and provides access to two project items:

ThisProject and ThisSystem. The Main project is automatically added as a reference

to all other projects (seen as Reference to WorkSpace in the Project Explorer) so you can access its functions and variables as if they were global.

The MimicProject project

Each opened mimic appears in a separate MimicProject project. In a MimicProject

there is one ThisMimic project item representing the Mimic object. Each

MimicProject has its own design and run modes. When switching modes, the mimic

and associated MimicProject follow one another. In Design mode, events are not

executed.

The SymbolProject project

Each Symbol displayed in an opened mimic will appear in a separate SymbolProject

project. Only one SymbolProject is displayed for each Symbol type even if there

are several instances of it on a mimic. In a SymbolProject there is one ThisSymbol project item representing the Symbol object.

Global Modules

You can insert Modules and Class Modules in any VBA project. Modules in the Main

project will be seen by all other projects. In the case of a name conflict use 'Main.' as a prefix.

12.3.7.3 Developing VBA programs

12.3.7.3.1 Error handling when using VBA

Error Handling When Using VBA

Why is error handling important?

Normally when a VBA application encounters an error, program execution is

stopped and an error box is displayed providing direct access to the VBA editor.


85

Show picture

With the Supervisor, if you have a Runtime license, this error box is disabled as it

would give the user access to the VBA editor. Therefore if there is an error, and no

specific error handling is provided, the program will stop and the user may be

unaware. To avoid this you should add an error handler to all but the simplest of

programs.

How add an error handler to your program

There are two parts to adding an error handler to your program.

You must tell VBA that you have included an error handler.

You must provide the error handling code.

To tell VBA that you have included an error handler you use the On Error

statement. The On Error statement points to a block of code to which the program

will jump when it encounters an error. A simple example is shown below.

Sub OnErrorStatementDemo()

On Error GoTo ErrorHandler ' Enable error-handling routine.

Open "TESTFILE" For Output As #1 ' Open file for output.

Kill "TESTFILE" ' Attempt to delete an open file to

force error.

Exit Sub ' Exit to avoid handler.

ErrorHandler: ' Error-handling routine.

Select Case Err.Number ' Evaluate error number.

Case 55 ' "File already open" error.

Close #1 ' Close open file

Case Else

' Handle other situations here...

End Select

Resume ' Resume execution at same line that

caused the error. End Sub


86

A full explanation of error handling in VBA is beyond the scope of this help. For

more information see Microsoft's help for VBA or one of the many specialist

books available.

12.3.7.3.2 Using HMI drawing elements in a program

Using HMI Drawing Elements in a VBA Program

Before any HMI drawing element (Shape, Text, Bitmap etc.) can be used as a

control in a VBA program you must enable the VBA Control property in the pop-up menu displayed by right-clicking on the object.

Show picture

Once the drawing element has been enabled as a VBA control it becomes visible in

the VBA environment and the EnableEvents property of drawing element is set to

True.

It can be selected using the left-hand combobox in the code window.

Once it is selected in the left-hand combobox, you can select any of its

events in the right-hand combobox and directly code the event.

It is visible in the VBA property box.


87

The object is directly known by its name (for example 'shape1') in the VBA

Project.

Remarks

You can select/de-select the VBA Control property at any time. The associated code

is not lost if you de-select a control, it just becomes a function of the Project.

It is possible for a drawing element to be a VBA control without the EnableEvents

property being True. In this case you will be able to change its properties by program, but not be able to fire any events.

Each drawing element that is enabled as a control requires additional resources

from the host PC. Only enable drawing elements as controls if you need to develop

code for them.

12.3.7.3.3 Coding events dynamically using the Dim WithEvents statement

Coding VBA Events Dynamically Using the Dim WithEvents Statement

This topic describes how to code events dynamically using the Dim WithEvents

statement.

The Dim WithEvents statement allows you to code events on a drawing element without first selecting the VBA Control property.

Example

This is best illustrated with an example. Within a mimic, Shape1 exists but has not

been selected as a VBA control.

'------ The following line must be placed in General Declarations

Dim WithEvents objShape as Graphic

'------ Assign the object when the mimic opens

Private Sub Mimic_Open ()

Set objShape = Graphics("Shape1")

ObjShape.EnableEvents = True

End Sub

Private Sub objShape_Click

MsgBox "Click"

End Sub

You must enable events for the object using the EnableEvents method.

Remarks

The references assigned to objects are temporary. When the mimic is closed, or its

mode changed (from Run to Development), the reference is lost and the event will

no longer work. For the event to work again the object must be reassigned to the variable and the events enabled.

12.3.7.3.4 Developing code for use in symbols

12.3.7.3.4.1 About developing code for use in Symbols

About Developing VBA Code for Use in Symbols


88

Show picture

If you develop VBA code as part of a Symbol it will be generic and executed for each instance of the Symbol.

To allow the development of code on a symbol right-click on the Symbol to display a pop-up menu and Select the property Symbol Project in VBA.

A new SymbolProject will appear in VBA and any code you develop will

automatically be executed for any instance of the symbol. The symbol is automatically saved each time you edit the code.

12.3.7.3.4.2 Using drawing elements within a Symbol as VBA controls

Using Drawing Elements Within a Symbol as VBA Controls

To use a drawing element within a symbol as a VBA control you must select its VBA

Control property before it is grouped and saved within a symbol (unless you use

Dim WithEvents - see the topic Using BeforeEvent and Dim WithEvents to

Dynamically Code Events(See 12.3.7.3.4.4)). It will then be visible as a control

within the symbol and appear in the left combo box of the code window for that symbol.

Any code attached to the drawing element before it becomes part of a

symbol becomes a function of the mimic project, it does not become part of

the symbol.

Example of how to create a Symbol containing a VBA control

1. Draw a rectangle 'Shape1' and select the VBA Control property using the

right-click pop-up.


89

2. Draw a rectangle 'Shape2'.

3. Group 'Shape1' and 'Shape2'.

4. Right-click on the group and select Create Symbol.

5. Give the Symbol a name and save it.

6. Right click on the newly created Symbol and select Symbol Project in VBA.

7. Display the VBA environment (Alt+F11) and the Symbol will appear in its

own SymbolProject project.

If you modify a Symbol by ungrouping it you will lose any code attached to drawing

elements within the symbol.

To avoid this, duplicate the Symbol first to keep at least one instance of the

Symbol in the mimic. The VBA project automatically reattaches the code to the modified Symbol.

12.3.7.3.4.3 What happens to Symbol events?

What Happens to Symbol Events when Using VBA?

By default, the EnableEvents property of the Symbol itself is set to false and the

Symbol is unable to respond to events. However, any drawing elements within the

symbol that are VBA controls are able to respond to events (assuming that their EnableEvents property is true).

Remarks

If you set the EnableEvent property of the Symbol to true then the Symbol itself

will respond to events but any VBA control within it will not. You will still be able to change the properties of any VBA control within the Symbol by program.

12.3.7.3.4.4 Using BeforeEvent and Dim WithEvents to dynamically code events

Using BeforeEvent and Dim WithEvents to Dynamically Code

VBA Events

The Symbol object has two special events, BeforeEvent and AfterEvent. These are fired even if the EnableEvents property of the Symbol is false.

The BeforeEvent event occurs before each event fired from any drawing element in the Symbol with the EnableEvents property set to true.

The AfterEvent event occurs after each event fired from any drawing element in the Symbol with the EnableEvents property set to true.

Using BeforeEvent with the Dim WithEvents statement allows you to code events on a drawing element in a Symbol without first selecting the VBA Control property.

Example

This is best illustrated with an example. Within a Symbol, Shape1 exists and has the EnableEvents property set to true but has not been selected as a control.

'------ The following line must be placed in General Declarations

Dim WithEvents objGraphic as Graphic

'------ Assign the object when using the BeforeEvent Event

Private Function Symbol_BeforeEvent () As Boolean

Set objGraphic = Graphics("Shape1")

End Function

'------ Code to execute when Shape1 is clicked


90

Private Sub objShape_Click

MsgBox "Click"

End Sub

12.3.7.3.5 Using database variables in a program

12.3.7.3.5.1 About using database variables in a program

About Using Database Variables in a VBA Program

Before you can use the properties, methods and events of any Database variables

in your programs, the variables must first be subscribed. Variables are subscribed in the following ways.

Automatically when used in an animation of any open mimic.

Automatically whenever a variables value is referenced in a VBA program.

Manually by using the Add method of the Variables collection.

12.3.7.3.5.2 Subscribing and unsubscribing a variable

Subscribing and Unsubscribing a Variable Using VBA

Database variables are not automatically available to VBA. To make them available

they must be subscribed.

Each variable that you subscribe uses some slight system resources. To

reduce that loading you can 'unsubscribe' (remove) variables that are no longer required, as described below.

Some variables may need to be subscribed 'permanently' while the project

running. For instance, variables that have a script running when the variable changes in value.

How using a variable in a mimic makes it accessible to VBA scripts

Any variables used in any animation in an opened mimic are automatically made

available to VBA. It is unnecessary to programmatically subscribe to the variable as

described below. However, when the last mimic using a particular variable in an

animation is closed, that variable is no longer available to VBA unless it is programmatically subscribed.

Accessing variables in VBA

You can use VBA to access all database variables:

All variables that are available in the HMI (because at least one mimic that

uses them in animations is open) are automatically available in VBA.

You can access other variables by programmatically subscribing to them.

To subscribe a variable you use the Variables.Add method. For example:

Variables.Add "Branch1.B1", fvVariableTypeBit

Variables.Add "CommentDisplay%", fvVariableTypeText

The optional second parameter describes the variable type. For more information

see the Variables Collection topic in the VBA help.


91

If the variable is already subscribed by an animation in the HMI, it may still be

subscribed through VBA. When the mimic containing the animation is closed the

variable will then remain subscribed until the project is closed or it is unsubscribed in VBA.

You must use the full variable name when you subscribe a variable.

How to unsubscribe a variable

To unsubscribe a variable you use the Variables.Remove method. For example:

Variables.Remove "Branch1.B1"

If you subscribe a variable more than once in VBA, you have to unsubscribe it that

many times before the variable can become unsubscribed. Even then, it remains

subscribed in the HMI so long as any mimic that uses it in animations remains open.

12.3.7.3.5.3 Shortcuts for access to variables

Shortcuts for Access to Variables in VBA

The Item method

The Item method is the default for the Variables collection, and the Value property

is the default for the Variable object. So:

Variables("CommentDisplay") = "Hello World"

is the equivalent of:

Variables.Item("CommentDisplay").Value = "Hello World"

The [. . .] syntax

The [. . .] syntax provides an additional shortcut to directly access a variable's

value.

[Main.Branch1.B1]

is the equivalent of

Variables("Main.Branch1.B1")

It is recommended that you use this shortcut to make your code more readable.

When you use the [...] syntax the variable is automatically subscribed and

unsubscribed - there is no requirement to do it programmatically.

Example

Private Sub Shape1_Click()

If [Main.Branch1.B1] = True Then

[Main.Branch1.B1] = False

Else

[Main.Branch1.B1] = True

End If

End Sub


92

12.3.7.3.5.4 Running code when a variable's value changes

Running VBA Code When a Variable's Value Changes

You can execute code when a variable's value changes, using the Dim WithEvents statement and the ValueChange event.

This is best illustrated with a simple example.

Example

'------ This code must be placed in General Declarations

Dim WithEvents objVar As Variable

'------ Execute to set up events

Private Sub fvProject_StartupComplete()

'------ Subscribe to variables

Variables.Add "Branch1.B1", fvVariableTypeBit

' ------ Assigns an object reference to the variable and enable the

events

Set objVar = [Branch1.B1]

objVar.EnableEvents = True

End Sub

'------ Execute when value of Main:Branch1.B1 changes

Private Sub objVar_ValueChange()

MsgBox objVar.Name & " = " & objVar.Value

End Sub

You must enable events for the object using the EnableEvent method.

Remarks

If the code is contained within a mimic, any references to objects are temporary.

When the mimic is closed, or its mode changed (from Run to Development), the

reference is lost and the event will no longer work. For the event to work again the

object must be reassigned to the variable and the events enabled.

12.3.7.3.6 Managing scroll bar controls from VBA

Managing Scroll Bar Controls from VBA

A window displays a scroll bar when part of a mimic is hidden by the window

frame. (The workspace can also display scroll bars, but this topic does not apply to them.)

You can manage window scroll bar controls from VBA by using these features:

The Mimic object event WindowScroll. (It applies to the mimic associated

with the window).

The Window object functions GetScrollPosition, SetScrollPosition and

GetScrollHighPosition.

Mimic and Window objects

The HMI exposes a Mimic/Window object model. In it, a Window object is the visual

representation of a Mimic object. For one Mimic object several Window objects can be present at the same time with different scroll bar control positions.

Scroll bar controls


93

Whether scroll bar controls are visible or not depends on the mimic size, window

size and zoom level. When the window scroll bar controls are visible, you can scroll the Window contents horizontally or vertically in these four ways:

By 'line' (by increments in each direction).

By 'page' (to jump to a position above/below or left/right of the visible part

of the mimic).

By moving the scroll box in the scroll bar.

By turning the mouse wheel.

Show picture

Limits of positioning

Each scroll bar control has a low limit position of 0 to represent the top or left end

of the window frame, and a high limit position for the bottom or right end. These parameters are stated in logical units (by default, pixels).

12.3.7.3.7 How to extend the functionality of the VBE

Extending the Functionality of the VBE

The VBE (Visual Basic Environment) is the object model for Microsoft VBA Extensibility 5.3. It contains functionality such as:

Adding and enumerating a project's references.

Setting or getting the project's description, help file, and help context.

Using these references and properties, you can alter and add to the functionality

that is provided in VBA.

The VBE object is the root object that contains all other objects and collections represented in VBA.

The VBE object

The VBE object lists the collections of objects in the VBE. All objects have a VBE

property that points to the VBE object. The VBE object's VBProjects property

returns the collection of all projects currently open in the VB Integrated Data

Environment (IDE). For example, this code displays the name of the first of the VB projects:

MsgBox VBE.VBProjects(1).Name

For more information on the VBE object, see the topic VBE Object in Microsoft VBA Help.


94

The VBProject object

The term 'project' in the VB/VBA context is distinct from 'project' in the HMI. (A VBA project can be associated with a mimic, a symbol or a project in the HMI.)

The VBProject object represents a project in VB/VBA. It enables you to access the

project's properties, VB components and references. For example, this code displays the name of the current VBA project:

MsgBox ThisProject.VBProject.Name

For more information on the VBProject object, see the topic VBProject Object in

Microsoft VBA Help.

The VBProject property is used to gain access to the functionality of the VBE object.

12.3.7.3.8 Hints and tips

VBA Hints and Tips

The following hints and tips (not presented in any particular order) have been

accumulated during the development of this Help. They do not concern

programming techniques but more the way in which you use the VBA environment in the HMI.

Stopping a VBA Program

To stop a VBA program that cannot be stopped in any other way (for example, if it is in an infinite loop) you can press the keys CTRL+BREAK.

Enabling events

You must have the Dim WithEvents statement in a code module to enable an

object's events to be intercepted by VBA procedures. For more details see the topic

Using BeforeEvent and Dim WithEvents to Code Events Dynamically(See 12.3.7.3.4.4).

Events are fired only if the EnableEvents property of the underlying object has

been set to true. This happens automatically once the first event script has been

associated with the object. For instance, you must set the EnableEvents property of

a Symbol to True to allow it to respond to events. For more details see the topic What happens to Symbol events(See 12.3.7.3.4.3).

In Design mode, events are not executed.

The 'Me' keyword

'Me' refers to the current object - the specific instance of the class where the code

is executing. For an example see the Symbol Loaded Example and for more

information see the Microsoft VBA topics 'Me <keyword>' and 'Invalid use of Me keyword'.

Access to Variables

You must subscribe an OPC variable before you can use it in VBA (unless it is used

in an animation in a mimic that is currently open).

The [. . .] syntax provides an additional shortcut to access a variable directly. [Main.Branch1.B1] is the equivalent of: Variables("Main.Branch1.B1").


95

Diagnostic tools

The HMI is always open when you are developing a VBA program. You can use

animations in a mimic to monitor the values and properties of HMI variables

dynamically. You can also keep open the Configuration Explorer (for all HMI

variables) and the Properties List (for a selected element in the HMI) for reference

as you develop the code. The contents of the Properties List change dynamically as you select HMI objects and alter their settings.

For diagnostic tools in the standard Microsoft VBA environment, see the Microsoft

Help topic 'Ambiguous Selection' (Code/Module Window, Immediate Window/Pane, Locals Window/Pane, Object Browser and Watch Window/Pane).

13. Web-сервисы

14. Специализированные темы

15. ПО стороннего производителя

15.1 Dream Report

Dream Report

Смотрите справочник, поставляемый с Dream Report.

Documents

Справочник V11 - Энергосистемы...Справочник V11.0 5 В данном Справочнике есть больше, чем кажется на первый