Electro для построения систем учета и контроля - БД ElectroCNF, Electro - состав таблиц

Наименование поля

Тип данных

Содержание

ObjId

Integer

Ключевое поле, уникальный идентификатор измерительной величины. При наполнении БД (создании новых изм.величин) использовать автоинкремент. Присваивать значения начиная с 1. Значение ObjId=0 можно использовать для указания несуществующей величины.

Type

Integer

Тип:

1. - ветвь логического дерева объекта автоматизации
2. – вещественная величина
3. – логическая величина (ВКЛЮЧЕНО\ВЫКЛЮЧЕНО; ДА/НЕТ)
4. – вещественная управляющая величина (управляющее воздействие)
5. – логическая управляющая величина (ВКЛЮЧИТЬ\ВЫКЛЮЧИТЬ)

Значение Type=0 является отличительным признаком ветви логического дерева (структуры) объекта автоматизации. Для построения логического дерева используются поля ObjId, Type, Parent, Name [, ShortName]. Значения остальных полей таблицы TB_Objects игнорируются.

Parent

Integer

[используется совместно с Type=0] Ссылка на хозяина (указывается его ObjId) в логическом дереве объекта.
Значение Parent=0 используется для корневой вершины логического дерева. Допускается несколько корневых вершин.

DevId

Integer

Ссылка на устройство (идентификатор DevId в таблице TB_Devices), в котором размещена данная изм.величина. Для логических ветвей и вычисляемых величин DevId=0

MemInd

Integer

Адрес изм.величины в устройстве (карте памяти устройства). Значение MemInd имеет смысл при DevId!=0
Значение MemInd зависит от типа устройства, режима программирования устройства и используемой реализации протокола передачи данных (драйвера). Конкретное устройство представляется драйвером в виде карты памяти – списком имеющихся (доступных) изм.величин (параметров). Т.о. MemInd указывает на порядковый номер изм.величины в карте памяти.
Совокупность DevId+MemInd должна однозначно адресовать физический параметр в имеющихся устройствах. DevId+MemInd используется драйвером для получения единицы данных, которая в дальнейшем будет идентифицироваться уже значением ObjId.

Name

Varchar(255)

Имя измерительной величины либо логической ветви. Произвольный текст, однако рекомендуется, чтобы имя содержало достаточно полную информацию. Например, можно предложить режим автогенерации имени на основе цепочки имен логических хозяев и содержания полей TarifId, Accu, Period, DimId. Например:
“Прием Л-352 Тариф-1 за день, кВт*ч” или
“Прием Л-352 Тариф-1 на начало дня, кВт*ч”
Т.о. “Прием” и “Л-352” указывает на логических хозяев (Parent), “Тариф-1” – на тарифную зону (TarifId), “день” – период тарификации (Period), “за”, ”на начало” – тип накопления (Accu), “кВт*ч” – размерность (DimId).

ShortName

Varchar(64)

Сокращенное имя изм.величины. М.б. использовано некоторыми приложениями взамен Name.

TarifId

Integer

Ссылка на таблицу тарифов (TB_Tarif). TarifId=0 для нетарифицируемых величин. (суточный график, график уровня напряжения и т.п.)
В настоящее время не используется.

Period

Integer

Период параметра:
0 - непериодический параметр (сьем показаний в случайные моменты времени)

1. – СУТКИ
2. – МЕСЯЦ
3. – КВАРТАЛ
4. – ГОД
5. – НЕДЕЛЯ (начало в Понедельник 00:00:00)
6. – РАСЧЕТНЫЕ СУТКИ (начало суток в HH:00:00)
7. – РАСЧЕТНЫЙ МЕСЯЦ (начало в DD HH:00:00)

8,9 - зарезервировано
>9 - период в секундах
Значения <0 резервируется для будущего применения.
Значения HH (часы начала расчетных суток) и DD (день начала расчетных суток) статически прописываются в файле-лицензии electro.ini

Calc

Integer

Определяет, существует ли данная величина физически (т.е. имеет адрес DevId+MemInd) либо является результатом вычисления:

0 – Физическая (первичная) величина

1 – Препроцессор. Вычисляемая величина, рассчитываема по некоторому, достаточно сложному, алгоритму. Необходимая для расчетов информация хранится в Formula и таблице TB_Depend.
Например Formula=’LPREST2(@;@)’ указывает что используется алгоритм LPREST2, в расчетах используется две базовые переменные (перечисляются в таблице TB_Depend)

2 – Агрегатирование (вычисляемая величина). В этом случае поле CalcId содержит ObjId базовой величины. Соответствующая компонента системы (препроцессор обработки данных) должна обеспечить вычисление и сохранение в БД Energo данной вычисляемой величины (с использованием значений полей TarifId, Period, Accu, Koeff, Formula).
Пример: В кач-ве базовой величины указан 15-минутный (Period=900) график мощности (W, без учета коэффициентов трансформации). Агрегатированная величина должна быть почасовым (Period=3600) графиком нагрузки (kW*h, реальная феличина).

3 – Группирование (вычисляемая величина). Аналогично Calc=1, однако суть вычислений заключается в алгебраических операциях над несколькими базовыми величинами. Например, вычисляемая величина может быть алгебраической суммой, необходимой для рассчета баланса. Необходимая информация содержится в Formula.

4 – Селектор (вычисляемая величина) образуется путем смешивания базовых величин. На некотором интервале времени селектор принимает значение одной базовой величины, далее – другой и т.д. Моменты времени «переключения» и идентификаторы базовых величин задаются в таблице TB_Depend.

1. - Ручной ввод

CalcId

Integer

Идентификатор базовой величины для вычисляемой величины (Calc=2). В общем случае базовая величина м.б. вычисляемой.

Koeff

Double precision

Дополнительный коэффициент (множитель). Используется для вычисляемых переменных Calc=1,2,3,4

DimId

Integer

Ссылка на таблицу размерностей TB_Dimension

Formula

Varchar(255)

Формула для Calc=1,2,3.
Общий синтаксис формулы для Calc=1 и Calc=2:
[Процессор.]Функция[(@,@,..)]
например:
AVG - вычислить среднее значение;
VERIFY(@,@) - верификация по основному и дополнительному параметрам;
APPL1.Func1(@,@,@) - вычислить функцию Func1 по трем параметрам приложением APPL1.
Список формальных параметров содержится в таблице TB_Depend.
При отсутствии списка формальных параметров предполагается единственный параметр CalcId.
Общий синтаксис формулы для Calc=3:
+34-45+100
Т.е. перечисляются базовые параметры с указанием знака вхождения в группу.

Accu

Integer

Тип накопления:
0 - “за период”;
1 - “на начало периода”
2 - “на конец периода”
Например:
Accu=0: “Прием Л-352 Тариф-1 за день”
Accu=1: “Прием Л-352 Тариф-1 нараст.итогом на начало дня”
Accu=2: “Прием Л-352 Тариф-1 нараст.итогом на конец месяца”

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

Time1

Integer

Время хранения в основной БД, сутки

Time2

Integer

Время хранения в БД 2-го уровня, сутки

EnableReact

Integer

!=0 – «Активизировать контроль текущего значения параметра»
Контролируется положение текущего значения параметра в диапазонах
Min2, Min1, Max1, Max2
[Min1; Max1] – нормальное значение. При входе значения в этот диапазон отрабатывается реакция ReactNorm
[Min2; Min1[ или ]Max1; Max2] – предупреждение. При входе значения в этот диапазон отрабатывается реакция ReactWarn
<Min2 или >Max2 – аварийное значение. При входе значения в этот диапазон отрабатывается реакция ReactAlrm

Min2, Min1, Max1, Max2

Double precision

Значения задающие диапазоны контроля текущего значения переменной. См. EnableReact

ReactNorm, ReactWarn, ReactAlrm

Integer

Идентификаторы реакций (ссылки на TB_React) для контроля текущего значения переменной. См. EnableReact

DisableTrend

Integer

!=0 – Запрет записи в таблицы Trend, Trend2
Установка запрета записи используется если нет необходимости хранить тренд (историю значений) данного параметра.

Наименование поля

Тип данных

Содержание

DevId

Integer

Ключевое поле, уникальный идентификатор устройства. При наполнении БД (создании новых устройств) использовать автоинкремент. Присваивать значения начиная с 1. Значение DevId=0 можно использовать для указания несуществующего устройства.

DevNum

Integer

Номер устройства.
Задумывалось как некий целочисленный идентификатор устройства, альтернатива символьному полю SerialNumb.
Впоследствии было осознано, что из-за отсутствия механизма (алгоритма) назначения номеров идея не работает…
Так что при автоматическом создании устройств Электро просто присваивает DevNum := DevId
В любом случае, необходимо следить за уникальностью DevNum.

Type

Integer

Тип устройства. Условное число, определяющее класс устройства. Type=0 – “неизвестное устройство”. Резервируются значения:
1 – “Счетчик ABB Alpha”
2 – “Счетчик ABB EuroAlpha”
3 – “Счетчик Shlumberger Indigo+”
4– “Счетчик L&G”
5– “ЦТ5000”
6-“Источник макетов //..”
Полный список типов устройств содержится в таблице TB_Strings (Part=2)

SubType

Integer

Доопределение типа счетчика в классе Type. SubType=0 – “неизвестное устройство класса Type”.
Совокупность Type+SubType используется компонентами системы (например, драйвером протокола передачи данных) для настройки режима работы с данным устройством.

SerialNumb

Varchar(64)

Серийный (заводской) номер устройства либо его другая характеристика, позволяющая провести идентификацию устройства.

Name

Varchar(128)

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

ConnId

Integer

Ссылка на таблицу подключений (TB_Connections)

ConnStr

Varchar(255)

Строка, используемая драйвером для настройки режима работы с устройством. Любая такая строка имеет унифицорованный формат
“КЛЮЧ1=значение КЛЮЧ2=значение …”
(например “DEVNUMB=4 CHAN=1”)
ConnStr анализируется драйвером для получения дополнительной информации об устройстве. Другими словами, ConnStr – это специальная строка настройки драйвера на данное устройство.

IsActive

Integer

IsActive =0 – работа с устройством приостановлена.
IsActive =1 – действующее устройство.
Пояснение. Иногда необходимо указать, что устройство не является активным (выведено из эксплуатации, еще не установлено и т.п.) В этом случае ставим IsActive =0
Функция Ядра ElectroXML(“ACTION=5”)

FirstDay

integer

День месяца – начало отчетного периода.
Например, FirstDay=21 указывает на то, что начало месячного отчетного периода начинается в 00:00 21-го числа (предыдущего месяца) и заканчивается в 24:00 20-го числа.
Значение FirstDay=0 отменяет режим (использование календарного месяца)

Наименование поля

Тип данных

Содержание

ConnId

Integer

Ключевое поле, уникальный идентификатор настройки.

DLL

Varchar(32)

Имя DLL-драйвера протокола передачи данных. В настоящее время имеются:
ZMB.DLL
EMF.DLL
SLB.DLL

IniStr

Varchar(128)

«Статическая» строка настройки (синтаксис аналогичен TB_Devices.ConnStr) используемого средства связи (DLL-модуля). Данная строка настройки создает некоторую степень свободы (см. комментарий к таблице TB_Devices). В ней не рекомендуется помещать настройки, относящиеся к конкретному последовательному порту либо к конкретному устройству.
Как правило, это поле может оставаться пустым, посколько главные настройки DLL-модуля содержатся в TB_Devices.ConnStr. С другой стороны, некоторые стандартные ключи из TB_Devices.ConnStr можно перенести в TB_Connections.IniStr.

Name

Varchar(128)

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

ModId

Integer

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

Наименование поля

Тип данных

Содержание

TarifId

Integer

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

Name

Varchar(128)

Наименование тарифа

Selector

char(48)

Селектор получасов, входящих в данный тариф. Строка фиксированной длины (48 получасов) из 0 и 1. Например, зона от часа до трех ночи описывается селектором
“001111000000000000000000000000000000000000000000”

Наименование поля

Тип данных

Содержание

DimId

Integer

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

Name

Varchar(32)

Наименование размерности (“кВт*ч”, “Гц” и т.п)

Наименование поля

Тип данных

Содержание

UserId

Integer

Ключевое поле, уникальный идентификатор пользователя (1,2 …).

Name

Varchar(32)

Имя пользователя. Например “Administrator”

ShName

Varchar(16)

Сокращенное имя пользователя. Например для “Administrator” – “AD”

Passw

Varchar(32)

Пароль пользователя. Хранится в зашифрованном виде

Rights

Integer

Права пользователя, битовый вектор:
0x0001 – разрешено редактирование конфигурации обьекта (всех таблиц БД ElectroCNF, кроме TB_User)
0x0002 – разрешено администрирование пользователей (редактирование таблицы ElectroCNF.TB_User
0x0004 – разрешено редактирование шаблонов отчетов
0x0008 –разрешен запуск шаблона (генерация отчета)
0x0010 – разрешено редактирование данных (ручной ввод)
0x0020 – разрешена запись параметров в устройство
0x0040 – разрешен опрос устройства

RightsCS

Integer

Секретное контрольное число поля Rights. Используется для обнаружения несанкционированного редактирования поля.

Exist

Integer

Exist =0 – учетная запись пользователя приостановлена.
Exist =1 – действующая учетная запись.
Пояснение. Запрещается удалять записи из таблицы TB_User. Учетная запись пользователя “удаляется” путем установки Exist =0

Groups

Varchar(255)

Перечень индексов в TB_Groups
Например «1,2,10», т.е. данный пользователь является членом групп 1,2 и 10.

GroupsCS

Integer

Контрольная сумма Groups

Наименование поля

Тип данных

Содержание

UserId

Integer

Идентификатор пользователя, во время активности которого возникло данное событие. Значение UserId=0 говорит о том, что во время возникновения события не боло активного пользователя.

Category

Integer

Категория события:
0 – Изменение структуры БД Electro.CNF
1 – Вход\Выход\Изменение пользователя
2 – Изменение конфигурации объекта (TB_Objects)
3 – Редактирование шаблонов (TB_Reports)
4 - Генерация отчетов
5 – Опрос устройств (программа DevGet.exe)
6 –Импорт/Экспорт данных
7 – внутрисистемное событие
8 – ручное редактирование данных

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

Tm

Integer

Метка (дата-время) события. Метка представляется в виде целого числа, номер секунды с 00:00:00 01/01/1970, по Гринвичскому времени

Event

Varchar(128)

Описание события

Prior

Integer

Приоритет события:
0 – обычное сообщение
1 – предупреждение
2 – ошибка

Наименование поля

Тип данных

Содержание

RepId

Integer

Ключевое поле, уникальный идентификатор шаблона. При наполнении БД (создании новых изм.величин) использовать автоинкремент. Присваивать значения начиная с 1. Значение RepId=0 можно использовать для указания несуществующего шаблона.

Name

Varchar(128)

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

FileName

Varchar(64)

Имя файла шаблона

Type

Integer

Тип:

1. – ветвь логического дерева (группа шаблонов)
2. – шаблон
3. – документ (реализация шаблона)

Значение Type=0 является отличительным признаком ветви логического дерева (структуры отчетов). Для построения логического дерева используются поля RepId, Type, Parent, Name. Значения остальных полей таблицы TB_Reports игнорируются.
Значение Type=2 используется для хранения документа. Поле Parent ссылается на исходный шаблон. Таким образом, некоторый шаблон (Type=1) может иметь несколько потомков (Type=2) – результатов запуска данного шаблона на исполнение.

Parent

Integer

Ссылка на хозяина (указывается его RepId) в логическом дереве объекта.
Значение Parent=0 используется для корневой вершины логического дерева. Допускается несколько корневых вершин.

Media

Varchar(16)

Носитель шаблона (“XLS” и т.п.)
Поле определяет, с помощью какой программы создан шаблон.
‘EXCEL’ - файл программы MS Excel
‘DOC’ - файл программы MS Word
‘HTM’ – web-страница
‘XLS’ - OLE-обьект
Первая версия RepCnf.exe сохраняла шаблон как OLE-обьект, однако указывала Media=’XLS’ (правильнее было бы выбрать имя ‘OLE’). В последующей версии шаблон записывается уже как обычный excel-файл и ради сохранения приемственности было принято решение указывать Media=’EXCEL’.

EditCmd

Varchar(255)

Командная строка для запуска редактора шаблона.

RunCmd

Varchar(255)

Командная строка для запуска генератора отчета.
В строке могут содержаться конструкции (разделитель – пробел):
DTn=”@v:text”
Где n – номер метки времени
v – период метки времени (см. TB_Objects.Period)
text – текст приглашения.
Например “DT1=@1:Укажите день начала DT2=@1:Укажите день конца”

TmCreate

Integer

Дата-время создания шаблона

TmEdit

Integer

Дата-время последней редакции шаблона

UserId

Integer

Идентификатор пользователя – разработчика шаблона

Source

BLOB

Собственно текст (файл) шаблона.
Рекомендуется хранить шаблон в таблице TB_Reports.
Допускается хранение шаблона в виде файла (директория PattPath, см. п.1.2; Имя файла – FileName). В этом случае поле Source оставлять пустым.

Наименование поля

Тип данных

Содержание

Part

Integer

Номер раздела словаря:
1- Категории событий (TB_Log) TextId = TB_Log.Category

• Типы устройств (TB_Devices) TextId = TB_Devices.Type
• Права пользователя (TB_User) – см. TB_User.Rights
• Список функций агрегатирования (см. TB_Objects.Calc)
• Список функций препроцессора (см. TB_Objects.Calc)
• Возможные значения поля TB_Objects.Calc
• Коды ошибок драйвера устройства времени сессии опроса
• Система безопасности
•  

TextId

Integer

Идентификатор элемента словаря.
В отличие от поля Part, значения которого назначает разработчик Ядра, значения поля TextId определяются приложением-владельцем раздела словаря.

Name

Varchar(128)

Собственно текст

BinData

BLOB

Необязательное поле, двоичные данные произвольной длины

Comment

Varchar(255)

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

Наименование поля

Тип данных

Содержание

ObjId

Integer

Идентификатор вычисляемого параметра

VarNumb

Integer

Номер переменной в TB_Objects.Formula вычисляемого параметра

BaseId

Integer

Идентификатор базового параметра

DT

Integer

Метка времени – начало действия данной записи таблицы
(номер секунды с 01/01/1970 00:00:00 по Гринвичу)

ObjId

VarNumb

BaseId

DT

C начала работы системы идентификатор основного параметра - 125, дополнительного – 130:

100

1

125

0

100

2

130

0

В момент времени 1030000200 произошла замена дополнительного параметра на 131:

100

2

131

1030000200

В момент времени 1040000000 дополнительный параметр вернули на 130:

100

2

130

1040000000

В момент времени 1050000200 произошла замена основноного параметра на 140:

100

1

140

1050000200

И т.д.

Наименование поля

Тип данных

Содержание

ReactId

Integer

Идентификатор реакции, ключевое поле

Name

Varchar(128)

Наименование реакции

EvType

Integer

Тип события:
0 – рабочее событие (нормальное функционирование);
1 – предупреждающее событие (warning);
2 – аварийное событие (alarm).
3 – системное событие (изменение в конфигурации, регистрация пользователя и тп);

TxtColor

Integer

Цвет текста сообщения

Acust

Integer

Тип акустического сигнала:
0 – нет сигнала
1 – короткий сигнал (beep)
2 – мелодия1
3 – мелодия2

RFlags

integer

Битовый вектор:
0x0001 – «Событие необходимо распечатать на системном принтере»
0x0002 – «Событие необходимо записать в системный журнал»
0x0004 – «Необходимо потребовать квитирование события пользователем»
0x0008 – «Выводить сообщение о событии на экран»

AlrId

Integer

Ссылка на таблицу TB_Alarms

Наименование поля

Тип данных

Содержание

AlrId

Integer

Идентификатор, НЕключевое поле; т.е. в таблице могут присутствовать строки с одинаковым AlrId

TmFrom

Integer

Дата начала действия

TmTo

Integer

Дата конца действия. Строка таблицы TB_Alarms активна при условии попадания текущей даты в диапазон [TmFrom; TmTo[

WeekDays

Varchar(16)

Строка из символов 0 и 1, индикатор рабочих дней недели, начиная с воскресенья. Так, строка «0111110» отмечает дни кроме Сб и Вс.
Строка таблицы TB_Alarms активна при условии если дата указывает на активный день недели.

PostId1

Integer

PostId1, PostId2, PostId3 – последовательность ссылок на таблицу TB_Post.
Отсутствие ссылки – пусто либо 0.

PostId2

Integer

PostId3

Integer

Наименование поля

Тип данных

Содержание

PostId

Integer

Идентификатор, ключевое поле

Media

Varchar(16)

FAX, PAGER, VOICE, MAIL, NETSEND, SPEAK

ModId

Integer

Ссылка на таблицу TB_Modems. Для передачи оповещения используется указываемый модем.

WorkZone

Varchar(16)

«07:00-22:00» etc

Link

Varchar(255)

Содержимое ключа LINK зависит от MEDIA:
FAX,VOICE – номер телефона;
SPEAK - voice name (MS TTS (Text-To-Speech) engine).
Например "Adult Female #1 Russian (L&H)"
PAGER - "provider:UCP:user" or "provider:TAP:user"
MAIL – info for mailserver connection
NETSEND - имя компьютера

TryRetry

Integer

При неудаче повторить еще раз (но не более чем Retry раз) через After минут.

TryAfter

Integer

Наименование поля

Тип данных

Содержание

DispId

Integer

Идентификатор, ключевое поле

ShName

Varchar(32)

Сокращенное имя задания

Name

Varchar(128)

Полное имя задания

IsActive

Integer

1 – «Задание активно»

StartTime

Integer

Время запуска задания; секунды с начала суток

StartMode

Integer

0 – Ежедневно
1 –

TryRetry

Integer

При неудаче повторить еще раз (но не более чем Retry раз) через After минут.

TryAfter

Integer

TryEvery

Integer

Повторять запуск задания через каждые TryEvery минут от StartTime, но позже StopTime.
StopTime - секунды с начала суток.
Например, StartTime=10:00 TryEvery=30 StopTime=19:30
Задание будет запускаться начиная с 10:00 каждые 30 минут. Последний раз будет запущено в 19:30

StopTime

Integer

ReactId0

Integer

Ссылка на реакцию (TB_Reactions) при ошибке выполнения задания

ReactId1

Integer

Ссылка на реакцию (TB_Reactions) при успешном выполнении задания

DocInput

Varchar(255)

DocOutput

BLOB

XmlAction

Integer

XmlOption

Varchar(255)

Наименование поля

Тип данных

Содержание

ObjId

Integer

Идентификатор (см. ElectroCNF.TB_Objects.ObjId)

DT

Integer

Метка времени – номер секунды с 01/01/1970 00:00:00 по Гринвичу.
Использование гринвичского времени позволяет устранить проблемы, связанные с летним\зимним временем и построением распределенных систем, охватывающих несколько часовых поясов.
Представление метки времени в виде целого числа уменьшает объем базы и ускоряет выборку данных. Преобразование DT ß à SYSTEMTIME (local) можно выполнить с помощью функций SystemTime2Second() и Second2SystemTime(), входящих в состав Electro.DLL

Val

Double precision

Значение

Flag

Varchar(8)

Дополнительные признаки