Бібліотека приготування та отримання даних для звітної документації

Ім'я:	TechApp
Засновано:	січень 2008р
Версія:	1.0.0
Статус:	Відкритий (GPL)
Автор:	Роман Савоченко
Опис:	Бібліотека функцій для полегшення виконання типових обчислень примітиву формування звітної документації СВК "Документ".
Адреса:	БД у файлі: SQLite.LibDB.doc (oscadalibs.db.gz)

Contents

Про бібліотеку

1 Склад бібліотеки

Середнє значення архіву (averVal)

Запит значення архіву (getVal)

Сума значень архіву (sumVal)

Про бібліотеку

Бібліотека створюється для надання типових операцій отримання даних під час побудови звітних документів з використанням даних джерел даних (DAQ) та їх архівів. Бібліотека не є статичною, а будується на основі модуля JavaLikeCalc, який дозволяє створювати обчислення на подібній до Java мові.

Для адресації до функцій цієї бібліотеки можна використати статичну адресу виклику "DAQ.JavaLikeCalc.lib_doc.{Func}()" або динамічний "SYS.DAQ.JavaLikeCalc["lib_doc"]["{Func}"].call()", "SYS.DAQ.JavaLikeCalc["lib_doc"].{Func}()". Де {Func} — ідентифікатор функції у бібліотеці.

Підключити бібліотеку до проекту станції OpenSCADA можна шляхом завантаження вкладеного файлу БД, розташування його у теці БД проекту станції та створення об́'єкту БД для модуля БД "SQLite", вказавши файл БД у конфігурації.

1 Склад бібліотеки

У своєму складі бібліотека містить декілька функцій часто потрібних під час формування документів на основі даних джерел даних OpenSCADA. Назви функцій та їх параметрів доступні на трьох мовах: Англійська, Російська та Українська.

Середнє значення архіву (averVal)

Опис: Обчислення середнього значення за проміжок часу визначеного архіву та видача результату з вказаною кількістю знаків після точки.
Параметри:

ID	Параметр	Тип	Режим	Прихований	По замовченню
rez	Результат	Строка	Повернення	false
addr	Адреса	Строка	Вхід	false
bTime	Час початку (сек.)	Цілий	Вхід	false
eTime	Час кінця (сек.)	Цілий	Вхід	false
prec	Знаків після точки	Цілий	Вхід	false	3
archtor	Архіватор	Строка	Вхід	false

Програма:
using Special.FLibSYS; a_src = vArh(strPath2Sep(addr)); tvar=EVAL_REAL; buf_beg=max(a_src.begin(0,archtor),bTime); buf_end=min(a_src.end(0,archtor),eTime); while( true ) { buf_beg1=buf_beg; r_val = a_src.get(buf_beg,0,true,archtor); if(tvar == EVAL_REAL) tvar = r_val; else if(r_val != EVAL_REAL) tvar=(tvar*(buf_beg-bTime)+r_val*(buf_beg-buf_beg1))/(buf_beg-bTime+buf_beg-buf_beg1); if( buf_beg == 0 || buf_beg>=buf_end ) break; buf_beg++; } return (tvar==EVAL_REAL) ? "Порожньо" : real2str(tvar,prec);

Запит значення архіву (getVal)

Опис: Запит значення на визначений час з вказаного архіву та видача результату з вказаною кількістю знаків після точки.
Параметри:

ID	Параметр	Тип	Режим	Прихований	По замовченню
rez	Результат	Строка	Повернення	false
addr	Адреса	Строка	Вхід	false
time	Час (сек.)	Цілий	Вхід	false
uTime	Час (мксек.)	Цілий	Вхід	false
prec	Знаків після точки	Цілий	Вхід	false	3
archtor	Архіватор	Строка	Вхід	false
strong	Точно	Логічний	Вхід	false	0

Програма:
using Special.FLibSYS; srcTime = time; val = vArh(strPath2Sep(addr)).get(time,uTime,0,archtor); return (val.isEVal() || (strong && srcTime != time)) ? "Порожньо" : real2str(val,prec);

Сума значень архіву (sumVal)

Опис: Обчислення суми значень за проміжок часу визначеного архіву та видача результату з вказаною кількістю знаків після точки.
Параметри:

ID	Параметр	Тип	Режим	Прихований	По замовченню
rez	Результат	Строка	Повернення	false
addr	Адреса	Строка	Вхід	false
bTime	Час початку (сек.)	Цілий	Вхід	false
eTime	Час кінця (сек.)	Цілий	Вхід	false
prec	Знаків після точки	Цілий	Вхід	false	3
archtor	Архіватор	Строка	Вхід	false

Програма:
using Special.FLibSYS; a_src = vArh(strPath2Sep(addr)); tvar=0.0; buf_beg_u=buf_end_u=0; buf_beg=max(a_src.begin(0,archtor),bTime); buf_end=min(a_src.end(0,archtor),eTime); while( true ) { r_val = a_src.get(buf_beg,buf_beg_u,true,archtor); if(r_val != EVAL_REAL) tvar+=r_val; if( !buf_beg || buf_beg>=buf_end ) break; buf_beg_u++; } return (tvar==EVAL_REAL) ? "Порожньо" : real2str(tvar,prec);