Export translations
Views
Special page
From OpenSCADAWiki
Jump to:
navigation
,
search
Settings
Group
About
Documents
Documents/API
Documents/DAQ
Documents/FAQ
Documents/How to
Documents/How to/Build from source
Documents/How to/Crash report
Documents/How to/Create module
Documents/How to/Create multi language project
Documents/How to/Cyclic programming
Documents/How to/Debug
Documents/How to/Install
Documents/How to/Live disk
Documents/How to/Release
Documents/How to/Transferring project configuration
Documents/How to/Violations, alarms and notifications
Documents/Program manual
Documents/Quick start
Documents/Release 0.8.0
Documents/Release 0.8.0/Update10
Documents/Release 0.8.0/Update11
Documents/Release 0.8.0/Update12
Documents/Release 0.8.0/Update13
Documents/Release 0.8.0/Update14
Documents/Release 0.8.0/Update15
Documents/Release 0.8.0/Update16
Documents/Release 0.8.0/Update17
Documents/Release 0.8.0/Update18
Documents/Release 0.8.0/Update19
Documents/Release 0.8.0/Update20
Documents/Release 0.8.0/Update3
Documents/Release 0.8.0/Update4
Documents/Release 0.8.0/Update5
Documents/Release 0.8.0/Update6
Documents/Release 0.8.0/Update7
Documents/Release 0.8.0/Update8
Documents/Release 0.8.0/Update9
Documents/Release 0.9
Documents/Release 0.9/Update 7
Documents/Release 0.9/Update1
Documents/Release 0.9/Update2
Documents/Release 0.9/Update3
Documents/Release 0.9/Update4
Documents/Release 0.9/Update5
Documents/Release 0.9/Update6
Documents/Release 0.9/Updating 0.8.0 LTS
Documents/Terms
Documents/User API
Functions and demands
Home
Libs
Libs/Devices
Libs/Documents
Libs/Electrical elements
Libs/Generic list
Libs/LowLevelDevices
Libs/Main
Libs/Main graphical elements
Libs/Mnemo elements
Libs/Prescriptions
Libs/Regulation elements
Libs/Service procedures
Libs/Technological apparatuses
Modules
Modules/BFN
Modules/BlockCalc
Modules/Comedi
Modules/DAQGate
Modules/DBArch
Modules/DBF
Modules/DBGate
Modules/DCON
Modules/DiamondBoards
Modules/FireBird
Modules/FLibComplex1
Modules/FLibMath
Modules/FLibSYS
Modules/FSArch
Modules/GPIO
Modules/HTTP
Modules/ICP DAS
Modules/JavaLikeCalc
Modules/LDAP
Modules/LogicLev
Modules/ModBus
Modules/MySQL
Modules/OPC UA
Modules/PostgreSQL
Modules/QTCfg
Modules/QTStarter
Modules/SelfSystem
Modules/Serial
Modules/Siemens
Modules/SMH2Gi
Modules/SNMP
Modules/Sockets
Modules/SoundCard
Modules/SQLite
Modules/SSL
Modules/System
Modules/SystemTests
Modules/UserProtocol
Modules/VCAEngine
Modules/Vision
Modules/WebCfg
Modules/WebCfgD
Modules/WebUser
Modules/WebVision
Sub-projects
Sub-projects/Automatic Builder of OpenSCADA
Sub-projects/Automation Linux distributive
Sub-projects/Embedding and PLC
Sub-projects/Server
Sub-projects/VCA
User:RomanSavochenko
Using
Using/HouseSpirit
Using/Kramatorsk Ball Mills
Using/Kramatorsk Water
Using/Model AGLKS
Using/Model Boiler
Using/OpenWrt TELEOFIS RTU968
Using/Yaroslavskij broiler
Works
Works/Road map
Works/Technical Support
Works/Technical Support/Agreement
Works/To do
Language
aa - Afar
ab - Abkhazian
ace - Achinese
ady - Adyghe
ady-cyrl - адыгабзэ
aeb - Tunisian Arabic
aeb-arab - تونسي
aeb-latn - Tûnsî
af - Afrikaans
ak - Akan
aln - Gheg Albanian
am - Amharic
an - Aragonese
ang - Old English
anp - Angika
ar - Arabic
arc - Aramaic
arn - Mapuche
arq - Algerian Arabic
ary - Moroccan Arabic
arz - Egyptian Arabic
as - Assamese
ase - American Sign Language
ast - Asturian
av - Avaric
avk - Kotava
awa - Awadhi
ay - Aymara
az - Azerbaijani
azb - تۆرکجه
ba - Bashkir
bar - Bavarian
bbc - Batak Toba
bbc-latn - Batak Toba
bcc - Southern Balochi
bcl - Bikol Central
be - Belarusian
be-tarask - Belarusian (Taraškievica orthography)
bg - Bulgarian
bgn - Western Balochi
bho - Bhojpuri
bi - Bislama
bjn - Banjar
bm - Bambara
bn - Bengali
bo - Tibetan
bpy - Bishnupriya
bqi - Bakhtiari
br - Breton
brh - Brahui
bs - Bosnian
bto - Iriga Bicolano
bug - Buginese
bxr - буряад
ca - Catalan
cbk-zam - Chavacano de Zamboanga
cdo - Min Dong Chinese
ce - Chechen
ceb - Cebuano
ch - Chamorro
cho - Choctaw
chr - Cherokee
chy - Cheyenne
ckb - Central Kurdish
co - Corsican
cps - Capiznon
cr - Cree
crh - Crimean Turkish
crh-cyrl - Crimean Turkish (Cyrillic script)
crh-latn - Crimean Turkish (Latin script)
cs - Czech
csb - Kashubian
cu - Church Slavic
cv - Chuvash
cy - Welsh
da - Danish
de - German
de-at - Austrian German
de-ch - Swiss High German
de-formal - German (formal address)
diq - Zazaki
dsb - Lower Sorbian
dtp - Central Dusun
dty - डोटेली
dv - Divehi
dz - Dzongkha
ee - Ewe
egl - Emilian
el - Greek
eml - Emiliano-Romagnolo
en - English
en-ca - Canadian English
en-gb - British English
eo - Esperanto
es - Spanish
et - Estonian
eu - Basque
ext - Extremaduran
fa - Persian
ff - Fulah
fi - Finnish
fit - Tornedalen Finnish
fj - Fijian
fo - Faroese
fr - French
frc - Cajun French
frp - Arpitan
frr - Northern Frisian
fur - Friulian
fy - Western Frisian
ga - Irish
gag - Gagauz
gan - Gan Chinese
gan-hans - Simplified Gan script
gan-hant - Traditional Gan script
gd - Scottish Gaelic
gl - Galician
glk - Gilaki
gn - Guarani
gom - Goan Konkani
gom-deva - Goan Konkani (Devanagari script)
gom-latn - Goan Konkani (Latin script)
got - Gothic
grc - Ancient Greek
gsw - Swiss German
gu - Gujarati
gv - Manx
ha - Hausa
hak - Hakka Chinese
haw - Hawaiian
he - Hebrew
hi - Hindi
hif - Fiji Hindi
hif-latn - Fiji Hindi (Latin script)
hil - Hiligaynon
ho - Hiri Motu
hr - Croatian
hrx - Hunsrik
hsb - Upper Sorbian
ht - Haitian Creole
hu - Hungarian
hy - Armenian
hz - Herero
ia - Interlingua
id - Indonesian
ie - Interlingue
ig - Igbo
ii - Sichuan Yi
ik - Inupiaq
ike-cans - Eastern Canadian (Aboriginal syllabics)
ike-latn - Eastern Canadian (Latin script)
ilo - Iloko
inh - Ingush
io - Ido
is - Icelandic
it - Italian
iu - Inuktitut
ja - Japanese
jam - Jamaican Creole English
jbo - Lojban
jut - Jutish
jv - Javanese
ka - Georgian
kaa - Kara-Kalpak
kab - Kabyle
kbd - Kabardian
kbd-cyrl - Адыгэбзэ
kg - Kongo
khw - Khowar
ki - Kikuyu
kiu - Kirmanjki
kj - Kuanyama
kk - Kazakh
kk-arab - Kazakh (Arabic script)
kk-cn - Kazakh (China)
kk-cyrl - Kazakh (Cyrillic script)
kk-kz - Kazakh (Kazakhstan)
kk-latn - Kazakh (Latin script)
kk-tr - Kazakh (Turkey)
kl - Kalaallisut
km - Khmer
kn - Kannada
ko - Korean
ko-kp - 한국어 (조선)
koi - Komi-Permyak
kr - Kanuri
krc - Karachay-Balkar
kri - Krio
krj - Kinaray-a
ks - Kashmiri
ks-arab - Kashmiri (Arabic script)
ks-deva - Kashmiri (Devanagari script)
ksh - Colognian
ku - Kurdish
ku-arab - كوردي (عەرەبی)
ku-latn - Kurdish (Latin script)
kv - Komi
kw - Cornish
ky - Kyrgyz
la - Latin
lad - Ladino
lb - Luxembourgish
lbe - лакку
lez - Lezghian
lfn - Lingua Franca Nova
lg - Ganda
li - Limburgish
lij - Ligurian
liv - Livonian
lmo - Lombard
ln - Lingala
lo - Lao
loz - Lozi
lrc - Northern Luri
lt - Lithuanian
ltg - Latgalian
lus - Mizo
luz - Southern Luri
lv - Latvian
lzh - Literary Chinese
lzz - Laz
mai - Maithili
map-bms - Basa Banyumasan
mdf - Moksha
mg - Malagasy
mh - Marshallese
mhr - Eastern Mari
mi - Maori
min - Minangkabau
mk - Macedonian
ml - Malayalam
mn - Mongolian
mo - молдовеняскэ
mr - Marathi
mrj - Western Mari
ms - Malay
mt - Maltese
mus - Creek
mwl - Mirandese
my - Burmese
myv - Erzya
mzn - Mazanderani
na - Nauru
nah - Nāhuatl
nan - Min Nan Chinese
nap - Neapolitan
nb - Norwegian Bokmål
nds - Low German
nds-nl - Low Saxon
ne - Nepali
new - Newari
ng - Ndonga
niu - Niuean
nl - Dutch
nl-informal - Nederlands (informeel)
nn - Norwegian Nynorsk
nov - Novial
nrm - Nouormand
nso - Northern Sotho
nv - Navajo
ny - Nyanja
oc - Occitan
olo - Livvi-Karelian
om - Oromo
or - Oriya
os - Ossetic
pa - Punjabi
pag - Pangasinan
pam - Pampanga
pap - Papiamento
pcd - Picard
pdc - Pennsylvania German
pdt - Plautdietsch
pfl - Palatine German
pi - Pali
pih - Norfuk / Pitkern
pl - Polish
pms - Piedmontese
pnb - Western Punjabi
pnt - Pontic
prg - Prussian
ps - Pashto
pt - Portuguese
pt-br - Brazilian Portuguese
qu - Quechua
qug - Chimborazo Highland Quichua
rgn - Romagnol
rif - Riffian
rm - Romansh
rmy - Romani
rn - Rundi
ro - Romanian
roa-tara - tarandíne
ru - Russian
rue - Rusyn
rup - Aromanian
ruq - Megleno-Romanian
ruq-cyrl - Megleno-Romanian (Cyrillic script)
ruq-latn - Megleno-Romanian (Latin script)
rw - Kinyarwanda
sa - Sanskrit
sah - Sakha
sat - Santali
sc - Sardinian
scn - Sicilian
sco - Scots
sd - Sindhi
sdc - Sassarese Sardinian
sdh - Southern Kurdish
se - Northern Sami
sei - Seri
ses - Koyraboro Senni
sg - Sango
sgs - Samogitian
sh - Serbo-Croatian
shi - Tachelhit
shi-latn - Tašlḥiyt
shi-tfng - ⵜⴰⵛⵍⵃⵉⵜ
si - Sinhala
sk - Slovak
sl - Slovenian
sli - Lower Silesian
sm - Samoan
sma - Southern Sami
sn - Shona
so - Somali
sq - Albanian
sr - Serbian
sr-ec - Serbian (Cyrillic script)
sr-el - Serbian (Latin script)
srn - Sranan Tongo
ss - Swati
st - Southern Sotho
stq - Saterland Frisian
su - Sundanese
sv - Swedish
sw - Swahili
szl - Silesian
ta - Tamil
tcy - Tulu
te - Telugu
tet - Tetum
tg - Tajik
tg-cyrl - Tajik (Cyrillic script)
tg-latn - Tajik (Latin script)
th - Thai
ti - Tigrinya
tk - Turkmen
tl - Tagalog
tly - Talysh
tn - Tswana
to - Tongan
tokipona - Toki Pona
tpi - Tok Pisin
tr - Turkish
tru - Turoyo
ts - Tsonga
tt - Tatar
tt-cyrl - Tatar (Cyrillic script)
tt-latn - Tatar (Latin script)
tum - Tumbuka
tw - Twi
ty - Tahitian
tyv - Tuvinian
tzm - Central Atlas Tamazight
udm - Udmurt
ug - Uyghur
ug-arab - Uyghur (Arabic script)
ug-latn - Uyghur (Latin script)
uk - Ukrainian
ur - Urdu
uz - Uzbek
uz-cyrl - ўзбекча
uz-latn - oʻzbekcha
ve - Venda
vec - Venetian
vep - Veps
vi - Vietnamese
vls - West Flemish
vmf - Main-Franconian
vo - Volapük
vot - Votic
vro - Võro
wa - Walloon
war - Waray
wo - Wolof
wuu - Wu Chinese
xal - Kalmyk
xh - Xhosa
xmf - Mingrelian
yi - Yiddish
yo - Yoruba
yue - Cantonese
za - Zhuang
zea - Zeelandic
zh - Chinese
zh-cn - Chinese (China)
zh-hans - Simplified Chinese
zh-hant - Traditional Chinese
zh-hk - Chinese (Hong Kong)
zh-mo - 中文(澳門)
zh-my - 中文(马来西亚)
zh-sg - Chinese (Singapore)
zh-tw - Chinese (Taiwan)
zu - Zulu
qqq - Message documentation
Format
Export for off-line translation
Export in native format
{{DISPLAYTITLE:Бібліотеки/Документи}}<languages/> {| class="wikitable" |- ! Назва !! Версія !! Ліцензія !! Джерело !! Мови !! Автор !! Іконка !! Опис |- <section begin=info /> | [[Special:MyLanguage/Libs/Documents|Бібліотека звітів та документів]] | 2.0, 2.1 || GPLv2 || OscadaLibs.db ([http://oscada.org/svn/trunk/OpenSCADA/data/LibsDB/OscadaLibs.sql SQL], [[:File:OscadaLibs.db.gz|GZip]]) > DAQ.JavaLikeCalc.doc<br/> vcaBase.db ([http://oscada.org/svn/trunk/OpenSCADA/data/LibsDB/vcaBase.sql SQL], [[:File:vcaBase.db.gz|GZip]]) > VCA.wlb_doc | en, uk, ru <section end=info /> | [[User:RomanSavochenko|Роман Савоченко]] || [[file:LibDocuments.png]] | Надає комбіновану бібліотеку звітів, документів та пов'язаних функцій загальної та промислової автоматизації. * '''Засновано:''' Січень 2008 * '''Початково створено, для функцій:''' у [http://wiki.oscada.org/HomePageUk/Using/APIFunctionLibs/LibDoc старій Wiki] * '''Використано:''' [[Special:MyLanguage/Using|більшість проектів на OpenSCADA]] * '''[[Special:MyLanguage/Works/To_do|Завдання (To Do)]]:''' <section begin=ToDo /> :- розширити документ "[[Special:MyLanguage/Libs/Documents#docRepYear|Річний звіт місячних значень]]" опрацюванням переповнень лічильників введених вручну; :- розширити функцію документів "[[Special:MyLanguage/Libs/Documents#diagram|Діаграма]]" підтримкою смужкового графіку (гістограм). <section end=ToDo /> |} Бібліотека створюється для надання елементів-кадрів звітів та документів користувацького інтерфейсу та містить графічні елементи, які часто затребувано при формуванні користувацького інтерфейсу автоматизації технологічних та загальних процесів. Будується бібліотека на основі [[Special:MyLanguage/Modules/VCAEngine#WidgetPrimitives|примітивів віджетів]] та мови внутрішнього програмування [[Special:MyLanguage/Modules/JavaLikeCalc|JavaLikeCalc]], також для пов'язаних функцій. Назви елементів та їх параметрів доступні на мовах: Англійська, Українська та mRussian. Їх вихідний код написано у мово(людська)-незалежному режимі з викликом функції перекладу ''tr()'' та переклад цих повідомлень також доступний Англійською, Українською та mRussian. == Документи == Містить елементи-кадри документів шаблонного та кінцевого типів, що призначені для розташування у розділі "Документи" (вид відображення) дерева сторінок проекту, побудованого за [[Special:MyLanguage/Libs/Main_graphical_elements#RootPgSo|концепцією об'єктів сигналізації кореневої сторінки "RootPgSo"]]. Однак, вони можуть бути розташовані як окремі сутності або у складі власної концепції керування сторінками, але тут треба враховувати, що кадри часто посилаються та викликають [[Special:MyLanguage/Libs/Main_graphical_elements#doc_panel|панель документів]]! Для підключення частини бібліотеки до проекту станції OpenSCADA ви можете отримати файл БД як: * такий що постачається з готовим та відповідним пакетом дистрибутиву Linux на кшталт "openscada-libdb-vca", "openscada-LibDB.VCA"; * найбільш актуальний та безпосередньо отриманий з [http://oscada.org/svn/trunk/OpenSCADA/data/LibsDB/vcaBase.sql репозиторію subversion], перетворений у файл БД SQLite шляхом: <syntaxhighlight lang="BASH" style="margin-left: 15px"> wget http://oscada.org/svn/trunk/OpenSCADA/data/LibsDB/vcaBase.sql sqlite3 -init vcaBase.sql vcaBase.db .exit </syntaxhighlight> * завантаження [[:File:vcaBase.db.gz|прикріпленого тут]]. Цей отриманий файл Ви надалі можете розмістити у теці проекту станції та створити об'єкт бази даних модуля БД "SQLite", зареєструвавши файл бази даних у конфігурації. {| class="wikitable" <section begin=doc /> | {{Anch|doc|<h3>Документ - архівний ([[Special:MyLanguage/Libs/Documents#doc|doc]])</h3>}} || 1.2 || GPLv2 || * || en, uk, ru <section end=doc /> | [[User:RomanSavochenko|Роман Савоченко]] |} Кадр, представлений на рисунку 1.1, є шаблоном документу архівного типу, він надається як приклад та для побудови власних архівних документів на його основі. Основною специфікою документу цього типу є періодична генерація на рівні СВУ-сеансу (у фоні) та розміщення фінальних та готових документів у архіві, таблиця БД сеансу СВУ-проекту "prj_{ProjID}_ses". Основною перевагою цього типу документу є найменше навантаження на процесор протягом генерації, яка може бути багатокроковою протягом основного періоду генерації, та швидкий перегляд, який передбачає просте відкриття готових документів із архіву. Але цей тип документу має суттєвий недолік, який полягає у постійному виконані єдиного сеансу проекту у фоні та відсутність якого призводить до пропуску генерації документів у архів. [[file:at.png]] Відтак, документи такого типу доцільні до використання на стаціонарних АРМ оператору, навіть якщо це відтворення із серверу візуалізації, та малокорисні у WEB-інтерфейсі! [[file:LibDocuments_doc.png|center|frame|Рис.1.1. Кадр "Документ - архівний" у режимі розробки.]] {{CntHdr|Використання — розробка}} Кадр може бути використано виключно як основу для створення власних документів архівного типу, для чого ви маєте його скопіювати або успадкувати, обравши відповідну опцію у діалозі копіювання. Далі ви маєте відредагувати шаблон документу, у відповідному атрибуті, згідно до потреб вашого документу та написати власну процедуру періодичного та покрокового формування документів із записом їх до архіву, зразок якої можна отримати у кінцевих документів, що засновані на цьому. {| class="wikitable" <section begin=docRepDay /> | {{Anch|docRepDay|<h4>Добовий звіт середніх за годину значень ([[Special:MyLanguage/Libs/Documents#docRepDay|docRepDay]])</h4>}} | 3.2 || GPLv2 || * || en, uk, ru <section end=docRepDay /> | [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок) |} Документ, представлений на рисунку 1.1.1, слугує для генерації добового звіту середніх за годину значень у вигляді діаграми трендів та таблиці даних. Документ початково архівного типу, та з часом він зроблений і динамічним, відтак, залежно від режиму виконання, ви можете або обирати готові документи із архіву або визначити час та глибину даних. Документ загалом використовує та представляє представницьку структуру DAQ-шаблону "[[Special:MyLanguage/Libs/Main#anUnif|Аналоговий сигнал]]". У якості джерела даних документу виступають [[Special:MyLanguage/Documents/Program_manual#ArchVals|архіви значень]] DAQ-параметрів. Робота у первинному архівному режимі відбувається із періодом 5 хвилин, коли протягом години формується один запис-рядок. Останній запис-рядок закривається на п'ятій хвилині нової години (наприклад, 14:05) та розпочинається новий запис-рядок. Весь та завершений документ архівується на третій хвилині "Звітного часу (''repHour'')" наступного дня (наприклад, 09:03). * '''Спонсоровано щодо динамізації''': ТОВ BLUE STAR GROUP і Вінницька Птахофабрика [[file:LibDocuments_docRepDay_uk.png|center|frame|Рис.1.1.1. Документ "Добовий звіт середніх за годину значень" у режимі виконання.]] {{CntHdr|Використання — розробка}} Документ призначено для виконання ролі сторінки-шаблону, а, відповідно, він має безпосередньо розташовуватися у дерево проекту. До кожного документу може підключатися до десяти параметрів, шляхом встановлення зв'язків. Елементи, для яких не буде встановлено зв'язку, будуть приховані при виконанні. [[file:at.png]] Для кожного документу можна встановити: * атрибут "Розмір архіву ('''n''')" у потрібне значення розміру архіву документу або у 0 для динамічного режиму; * атрибут "Архіватор ('''arch''')" у потрібний архіватор, що обслуговує визначені параметри; ви не маєте використовувати архіватори із якістю гірше за одну хвилину; * атрибут "Звітний час ('''repHour''')" у годину звітності документу — годину початку доби; * атрибут "Ввімкнути графік ('''enGraph''')" для ввімкнення/вимкнення графіку; * атрибут "Заголовок ('''title''')" у специфічний заголовок документу. {{CntHdr|Використання — виконання}} У режимі виконання відображаються елементи, для яких встановлено зв'язки. Додатково ви можете керувати властивостями відображення документу, для чого використовується [[Special:MyLanguage/Libs/Main_graphical_elements#doc_panel|панель управління документом]], викликати яку можна натиснувши ліву клавішу миші у області документу. {{CntHdr|Властивості зв'язування та конфігурації}} {| class="wikitable" |- ! Ідентифікатор !! Ім'я !! Тип !! Конфігурація !! Конфігураційний шаблон !! Опис |- | n || Розмір архіву, 0 для динамічного режиму || Цілий || Стала || || Встановленням розміру архіву у 0 ви перемкнете документ у динамічний режим, по замовченню 100. |- | repHour || Звітний час || Цілий || Стала || || Година що вважається стартом звіту — початок дня, по замовченню 9. |- | colspan="6" | ''Віджет документу (doc)'' |- | arch || Архіватор || Рядок || Стала || || Архіватор значень, по замовченню та найліпше використовувати одно-хвилинний архіватор "FSArch.1m". |- | title || Заголовок || Рядок || Стала || || Заголовок звіту |- | enGraph || Ввімкнути графік || Логічний || Стала || || Ввімкнено по замовченню. |- | colspan="6" | ''Параметр {n} від 1 до 10.'' |- | p{n}name || Параметр {n}: назва || Рядок || Вхідний зв'язок || Parameter{n}|NAME || Назва параметру у заголовку таблиці. |- | p{n}var || Параметр {n}: змінна || Адреса || Вхідний зв'язок || Parameter{n}|var || Адреса до атрибуту параметру із архівом значень. |- | p{n}ed || Параметр {n}: одиниця виміру || Рядок || Вхідний зв'язок || Parameter{n}|ed || |- | p{n}prec || Параметр {n}: точність || Цілий || Вхідний зв'язок || Parameter{n}|prec || |- | p{n}cntr || Параметр {n}: це лічильник || Логічний || Стала || Parameter{n}|isCntr || Встановлюється для лічильників з метою отримання значень як різницю. |- | p{n}max || Параметр {n}: максимум || Адреса || Вхідний зв'язок || Parameter{n}|max || Використано для визначення шкали параметру на графіку. |- | p{n}min || Параметр {n}: мінімум || Адреса || Вхідний зв'язок || Parameter{n}|min || Використано для визначення шкали параметру на графіку. |} {| class="wikitable" <section begin=docRepMonth /> | {{Anch|docRepMonth|<h4>Місячний звіт середніх за добу значень ([[Special:MyLanguage/Libs/Documents#docRepMonth|docRepMonth]])</h4>}} | 3.2 || GPLv2 || * || en, uk, ru <section end=docRepMonth /> | [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок) |} Документ, представлений на рисунку 1.1.2, слугує для генерації місячного звіту середніх за добу значень у вигляді діаграми трендів та таблиці даних. Документ початково архівного типу, та з часом він зроблений і динамічним, відтак, залежно від режиму виконання, ви можете або обирати готові документи із архіву або визначити час та глибину даних. Документ загалом використовує та представляє представницьку структуру DAQ-шаблону "[[Special:MyLanguage/Libs/Main#anUnif|Аналоговий сигнал]]". У якості джерела даних документу виступають [[Special:MyLanguage/Documents/Program_manual#ArchVals|архіви значень]] DAQ-параметрів. Робота у первинному архівному режимі відбувається із періодом 5 хвилин, коли протягом доби формується один запис-рядок. Останній запис-рядок закривається на п'ятій хвилині нової доби (наприклад, 05 09:05) та розпочинається новий запис-рядок. Весь та завершений документ архівується на третій хвилині "Звітного часу (''repHour'')" наступного місяця (наприклад, 05 09:03). * '''Спонсоровано щодо динамізації''': ТОВ BLUE STAR GROUP [[file:LibDocuments_docRepMonth_uk.png|center|frame|Рис.1.1.2. Документ "Місячний звіт середніх за добу значень" у режимі виконання.]] {{CntHdr|Використання — розробка}} Документ призначено для виконання ролі сторінки-шаблону, а, відповідно, він має безпосередньо розташовуватися у дерево проекту. До кожного документу може підключатися до десяти параметрів, шляхом встановлення зв'язків. Елементи, для яких не буде встановлено зв'язку, будуть приховані при виконанні. [[file:at.png]] Для кожного документу можна встановити: * атрибут "Розмір архіву ('''n''')" у потрібне значення розміру архіву документу або у 0 для динамічного режиму; * атрибут "Архіватор ('''arch''')" у потрібний архіватор, що обслуговує визначені параметри; ви не маєте використовувати архіватори із якістю гірше за одну добу; * атрибут "Звітний час ('''repHour''')" у годину звітності документу — годину початку доби; * атрибут "Ввімкнути графік ('''enGraph''')" для ввімкнення/вимкнення графіку; * атрибут "Заголовок ('''title''')" у специфічний заголовок документу. {{CntHdr|Використання — виконання}} У режимі виконання відображаються елементи, для яких встановлено зв'язки. Додатково ви можете керувати властивостями відображення документу, для чого використовується [[Special:MyLanguage/Libs/Main_graphical_elements#doc_panel|панель управління документом]], викликати яку можна натиснувши ліву клавішу миші у області документу. {{CntHdr|Властивості зв'язування та конфігурації}} {| class="wikitable" |- ! Ідентифікатор !! Ім'я !! Тип !! Конфігурація !! Конфігураційний шаблон !! Опис |- | n || Розмір архіву, 0 для динамічного режиму || Цілий || Стала || || Встановленням розміру архіву у 0 ви перемкнете документ у динамічний режим, по замовченню 100. |- | repHour || Звітний час || Цілий || Стала || || Година що вважається стартом звіту — початок дня, по замовченню 9. |- | colspan="6" | ''Віджет документу (doc)'' |- | arch || Архіватор || Рядок || Стала || || Архіватор значень, по замовченню та найліпше використовувати одно-хвилинний архіватор "FSArch.1m". |- | title || Заголовок || Рядок || Стала || || Заголовок звіту |- | enGraph || Ввімкнути графік || Логічний || Стала || || Ввімкнено по замовченню. |- | colspan="6" | ''Параметр {n} від 1 до 10.'' |- | p{n}name || Параметр {n}: назва || Рядок || Вхідний зв'язок || Parameter{n}|NAME || Назва параметру у заголовку таблиці. |- | p{n}var || Параметр {n}: змінна || Адреса || Вхідний зв'язок || Parameter{n}|var || Адреса до атрибуту параметру із архівом значень. |- | p{n}ed || Параметр {n}: одиниця виміру || Рядок || Вхідний зв'язок || Parameter{n}|ed || |- | p{n}prec || Параметр {n}: точність || Цілий || Вхідний зв'язок || Parameter{n}|prec || |- | p{n}cntr || Параметр {n}: це лічильник || Логічний || Стала || Parameter{n}|isCntr || Встановлюється для лічильників з метою отримання значень як різницю. |- | p{n}max || Параметр {n}: максимум || Адреса || Вхідний зв'язок || Parameter{n}|max || Використано для визначення шкали параметру на графіку. |- | p{n}min || Параметр {n}: мінімум || Адреса || Вхідний зв'язок || Parameter{n}|min || Використано для визначення шкали параметру на графіку. |} {| class="wikitable" <section begin=docDin /> | {{Anch|docDin|<h3>Документ - динамічний ([[Special:MyLanguage/Libs/Documents#docDin|docDin]])</h3>}} | 1.3 || GPLv2 || * || en, uk, ru <section end=docDin /> | [[User:RomanSavochenko|Роман Савоченко]] || -2 мс (вимкнено) |} Кадр, представлений на рисунку 1.2, є шаблоном документу динамічного типу, він надається як приклад та для побудови власних динамічних документів на його основі. Основною специфікою документу цього типу є синхронна генерація за запитом-відкриттям. Основною перевагою цього типу документу є максимальна актуальність даних та мови документу, для багатомовних інтерфейсів, тобто можливість генерації на визначену дату та час. Але цей тип документу має суттєвий недолік, який полягає у високому навантажені процесору та тривалому часі синхронної генерації для великих архівних даних. [[file:at.png]] Відтак, документи такого типу дозволено до використання на всіх типах інтерфейсів, включно з WEB-інтерфейсами, але деякі документи, засновані на великих архівних даних, потребують не повільних обчислювальних систем! [[file:LibDocuments_docDin.png|center|frame|Рис.1.2. Кадр "Документ - динамічний" у режимі розробки.]] {{CntHdr|Використання — розробка}} Кадр може бути використано виключно як основу для створення власних документів динамічного типу, для чого ви маєте його скопіювати або успадкувати, обравши відповідну опцію у діалозі копіювання. Далі ви маєте відредагувати шаблон документу, у відповідному атрибуті, згідно до потреб вашого документу та написати власну загальну процедуру генерації документу, якщо її не вбудовано до шаблону документу. {| class="wikitable" <section begin=docRepInstVals /> | {{Anch|docRepInstVals|<h4>Звіт миттєвих значень ([[Special:MyLanguage/Libs/Documents#docRepInstVals|docRepInstVals]])</h4>}} | 2.1 || GPLv2 || * || en, uk, ru <section end=docRepInstVals /> | [[User:RomanSavochenko|Роман Савоченко]] |} Документ, представлений на рисунку 1.2.1, слугує для генерації звіту миттєвих значень у вигляді діаграми трендів та таблиці даних. Документ динамічного типу, відтак ви можете визначити час та глибину даних. Документ загалом використовує та представляє представницьку структуру DAQ-шаблону "[[Special:MyLanguage/Libs/Main#anUnif|Аналоговий сигнал]]". У якості джерела даних документу виступають [[Special:MyLanguage/Documents/Program_manual#ArchVals|архіви значень]] DAQ-параметрів. [[file:LibDocuments_docRepInstVals_uk.png|center|frame|Рис.1.2.1. Документ "Звіт миттєвих значень" у режимі виконання.]] {{CntHdr|Використання — розробка}} Документ призначено для виконання ролі сторінки-шаблону, а, відповідно, він має безпосередньо розташовуватися у дерево проекту. До кожного документу може підключатися до десяти параметрів, шляхом встановлення зв'язків. Елементи, для яких не буде встановлено зв'язку, будуть приховані при виконанні. Типова глибина документу у минуле встановлена у 10 хвилин. [[file:at.png]] Для кожного документу можна встановити: * атрибут "Ввімкнути графік ('''enGraph''')" для ввімкнення/вимкнення графіку; * атрибут "Заголовок ('''title''')" у специфічний заголовок документу. {{CntHdr|Використання — виконання}} У режимі виконання відображаються елементи, для яких встановлено зв'язки. Додатково ви можете керувати властивостями відображення документу, для чого використовується [[Special:MyLanguage/Libs/Main_graphical_elements#doc_panel|панель управління документом]], викликати яку можна натиснувши ліву клавішу миші у області документу. {{CntHdr|Властивості зв'язування та конфігурації}} {| class="wikitable" |- ! Ідентифікатор !! Ім'я !! Тип !! Конфігурація !! Конфігураційний шаблон !! Опис |- | colspan="6" | ''Віджет документу (doc)'' |- | title || Заголовок || Рядок || Стала || || Заголовок звіту |- | enGraph || Ввімкнути графік || Логічний || Стала || || Ввімкнено по замовченню. |- | colspan="6" | ''Параметр {n} від 1 до 10.'' |- | p{n}name || Параметр {n}: назва || Рядок || Вхідний зв'язок || Parameter{n}|NAME || Назва параметру у заголовку таблиці. |- | p{n}var || Параметр {n}: змінна || Адреса || Вхідний зв'язок || Parameter{n}|var || Адреса до атрибуту параметру із архівом значень. |- | p{n}ed || Параметр {n}: одиниця виміру || Рядок || Вхідний зв'язок || Parameter{n}|ed || |- | p{n}prec || Параметр {n}: точність || Цілий || Вхідний зв'язок || Parameter{n}|prec || |- | p{n}max || Параметр {n}: максимум || Адреса || Вхідний зв'язок || Parameter{n}|max || Використано для визначення шкали параметру на графіку. |- | p{n}min || Параметр {n}: мінімум || Адреса || Вхідний зв'язок || Parameter{n}|min || Використано для визначення шкали параметру на графіку. |} {| class="wikitable" <section begin=docAlarmsRep /> | {{Anch|docAlarmsRep|<h4>Протокол порушень ([[Special:MyLanguage/Libs/Documents#docAlarmsRep|docAlarmsRep]])</h4>}} | 1.7 || GPLv2 || * || en, uk, ru <section end=docAlarmsRep /> | [[User:RomanSavochenko|Роман Савоченко]] || -2 мс (вимкнено) |} Документ, представлений на рисунку 1.2.2, слугує для генерації звіту з порушень. Документ динамічного типу, відтак ви можете визначити час та глибину даних. Документ загалом використовує та представляє структуру повідомлень "[[Special:MyLanguage/Documents/Program_manual#ArchMess|Порушення]]". У якості джерела даних документу виступає [[Special:MyLanguage/Documents/Program_manual#ArchMess|архів повідомлень]]. [[file:LibDocuments_docAlarmsRep_uk.png|center|frame|Рис.1.2.2. Документ "Протокол порушень" у режимі виконання.]] {{CntHdr|Використання — розробка}} Документ призначено для виконання ролі сторінки-шаблону, а, відповідно, він має безпосередньо розташовуватися у дерево проекту. До кожного документу може бути встановлено власний рівень повідомлень та категорію опрацьовуваних порушень у атрибуті "Категорія повідомлень ('''messCat''')", який по замовченню є загальним "1:al*:*" та може бути спеціалізованим до джерел даних. Типова глибина документу у минуле встановлена у 1 день. {{CntHdr|Використання — виконання}} У режимі виконання відображаються визначені повідомлення про порушення. Додатково ви можете керувати властивостями відображення документу, для чого використовується [[Special:MyLanguage/Libs/Main_graphical_elements#doc_panel|панель управління документом]], викликати яку можна натиснувши ліву клавішу миші у області документу. {{CntHdr|Властивості зв'язування та конфігурації}} {| class="wikitable" |- ! Ідентифікатор !! Ім'я !! Тип !! Опис |- | messCat || Категорія повідомлень || Рядок || Запитаний рівень та категорія повідомлень про порушення, типово "1:al*:*". |} {| class="wikitable" <section begin=docUsersSet /> | {{Anch|docUsersSet|<h4>Протокол втручань ([[Special:MyLanguage/Libs/Documents#docUsersSet|docUsersSet]])</h4>}} | 1.8 || GPLv2 || * || en, uk, ru <section end=docUsersSet /> | [[User:RomanSavochenko|Роман Савоченко]] |} Документ, представлений на рисунку 1.2.3, слугує для генерації звіту з втручань користувача. Документ динамічного типу, відтак ви можете визначити час та глибину даних. Документ загалом використовує та представляє структуру повідомлень "[[Special:MyLanguage/Documents/Program_manual#ArchMess|Дії користувача-оператора]]". У якості джерела даних документу виступає [[Special:MyLanguage/Documents/Program_manual#ArchMess|архів повідомлень]]. [[file:LibDocuments_docUsersSet_uk.png|center|frame|Рис.1.2.3. Документ "Протокол втручань" у режимі виконання.]] {{CntHdr|Використання — розробка}} Документ призначено для виконання ролі сторінки, а, відповідно, він має безпосередньо розташовуватися у дерево проекту. Документ не передбачає жодної конфігурації оскільки повідомлення про втручання є загальними. Типова глибина документу у минуле встановлена у 1 день. {{CntHdr|Використання — виконання}} У режимі виконання відображаються повідомлення про втручання користувачів. Додатково ви можете керувати властивостями відображення документу, для чого використовується [[Special:MyLanguage/Libs/Main_graphical_elements#doc_panel|панель управління документом]], викликати яку можна натиснувши ліву клавішу миші у області документу. {{CntHdr|Властивості зв'язування та конфігурації}} {| class="wikitable" |- ! Ідентифікатор !! Ім'я !! Тип !! Опис |- | messCat || Категорія повідомлень || Рядок || Запитаний рівень та категорія повідомлень, типово "<nowiki>2:/(^|.*:)OP*/</nowiki>". |} {| class="wikitable" <section begin=docMessRep /> | {{Anch|docMessRep|<h4>Протокол повідомлень ([[Special:MyLanguage/Libs/Documents#docMessRep|docMessRep]])</h4>}} || 1.5 || GPLv2 || * || en, uk, ru <section end=docMessRep /> | [[User:RomanSavochenko|Роман Савоченко]] |} Документ, представлений на рисунку 1.2.4, слугує для генерації звіту [[Special:MyLanguage/Documents/Program_manual#ArchMess|різного сорту повідомлень]] разом, включаючи: "Порушення", "Дії користувача-оператора" та "Системні". Документ динамічного типу, відтак ви можете визначити час та глибину даних. Документ загалом використовує та представляє [[Special:MyLanguage/Documents/Program_manual#ArchMess|структури повідомлень]]: "Порушення", "Дії користувача-оператора" та "Системні". У якості джерела даних документу виступає [[Special:MyLanguage/Documents/Program_manual#ArchMess|архів повідомлень]]. Документ також надає просту фільтрацію за обраним критерієм: "Вимкнено", "Дата та час (dttm)", "Рівень (lev)", "Параметр (prm)", "Опис (dscr)", "Значення (alrm)". * '''Спонсорування:''' Устьянцев Михайло [[file:LibDocuments_docMessRep_uk.png|center|frame|Рис.1.2.4. Документ "Протокол повідомлень" у режимі виконання.]] {{CntHdr|Використання — розробка}} Документ призначено для виконання ролі сторінки-шаблону, а, відповідно, він має безпосередньо розташовуватися у дерево проекту. [[file:at.png]] До кожного документу може бути встановлено власний рівень та категорію опрацьовуваних повідомлень у атрибуті "Категорія повідомлень ('''messCat''')", який, по замовченню, є загальним "1:/^(al|OP|/sub_UI/mod_VCAEngine)/" та може бути спеціалізованим під себе. Також ви можете визначити архіватори виключного використання, встановленням атрибуту "Перелік архіваторів ('''archLs''')". Типова глибина документу у минуле встановлена у 1 день. {{CntHdr|Використання — виконання}} У режимі виконання відображаються визначені повідомлення. Додатково ви можете керувати властивостями відображення документу, для чого використовується [[Special:MyLanguage/Libs/Main_graphical_elements#doc_panel|панель управління документом]], викликати яку можна натиснувши ліву клавішу миші у області документу. Обранням критерію фільтрації та веденням тексту повідомлень потрібних для представлення, користувач може побачити лише потрібні повідомлення. {{CntHdr|Властивості зв'язування та конфігурації}} {| class="wikitable" |- ! Ідентифікатор !! Ім'я !! Тип !! Опис |- | messCat || Категорія повідомлень || Рядок || Запитаний рівень та категорія повідомлень, типово "1:/^(al|OP|/sub_UI/mod_VCAEngine)/". |- | archLs || Перелік архіваторів, "{ArhMod}.{Arh}[;{ArhModN}.{ArhN}]" || Рядок || Перелік архіваторів повідомлень, лише з яких повідомлення будуть запитуватися, встановіть порожнім для загального доступу. |} {| class="wikitable" <section begin=docRep2WorkSh /> | {{Anch|docRep2WorkSh|<h4>Звіт двох робочих змін ([[Special:MyLanguage/Libs/Documents#docRep2WorkSh|docRep2WorkSh]])</h4>}} || 2.0 || GPLv2 || * || en, uk, ru <section end=docRep2WorkSh /> | [[User:RomanSavochenko|Роман Савоченко]] |} Документ, представлений на рисунку 1.2.5, слугує для генерації звіту годинних значень до 10 параметрів двох робочих змін доби із результатною сумою для потоків та схожих параметрів. Документ динамічного типу, відтак ви можете визначити час та глибину (фіксована) даних. Документ загалом використовує та представляє представницьку структуру DAQ-шаблону "[[Special:MyLanguage/Libs/Main#anUnif|Аналоговий сигнал]]". У якості джерела даних документу виступають [[Special:MyLanguage/Documents/Program_manual#ArchVals|архіви значень]] DAQ-параметрів. * '''Спонсоровано:''' [http://diyaorg.dp.ua ТОВ "ДІЯ"] [[file:LibDocuments_docRep2WorkSh_uk.png|center|frame|Рис.1.2.5. Документ "Звіт двох робочих змін" у режимі виконання.]] {{CntHdr|Використання — розробка}} Документ призначено для виконання ролі сторінки-шаблону, а, відповідно, він має безпосередньо розташовуватися у дерево проекту. До кожного документу може підключатися до десяти параметрів, шляхом встановлення зв'язків. Елементи, для яких не буде встановлено зв'язку, будуть приховані при виконанні. [[file:at.png]] Також ви маєте визначити архіватор одно-годинних значень у атрибуті "Архіватор ('''arch''')", яким обслуговуються вказані параметри, оскільки цей документ потребує таких даних. Якщо початок першої робочої зміни відрізняється від 8 (восьмої) години, то ви маєте потрібну годину вказати у атрибуті "Початкова година ('''stH''')". {{CntHdr|Використання — виконання}} У режимі виконання відображаються елементи, для яких встановлено зв'язки. Додатково ви можете керувати властивостями відображення документу, для чого використовується [[Special:MyLanguage/Libs/Main_graphical_elements#doc_panel|панель управління документом]], викликати яку можна натиснувши ліву клавішу миші у області документу. Оскільки глибину документу у історію зафіксовано на значенні 12 годин (одна робоча зміна), користувач може лише змінити час документу! {{CntHdr|Властивості зв'язування та конфігурації}} {| class="wikitable" |- ! Ідентифікатор !! Ім'я !! Тип !! Конфігурація !! Конфігураційний шаблон !! Опис |- | colspan="6" | ''Віджет документу (doc)'' |- | stH || Початкова година || Цілий || Стала || || Початковий час робочої зміни, від 0 до 11 годин, по замовченню 8. |- | arch || Архіватор || Рядок || Стала || || Одно-годинний архіватор, по замовченню "FSArch.1h". |- | colspan="6" | ''Параметр {n} від 1 до 10.'' |- | p{n}_sh || Параметр {n}: шифр || Рядок || Вхідний зв'язок || Parameter{n}|NAME || Шифр параметру у таблиці. |- | p{n}_nm || Параметр {n}: опис || Рядок || Вхідний зв'язок || Parameter{n}|DESCR || Опис параметру у таблиці. |- | p{n}_val || Параметр {n}: значення || Адреса || Вхідний зв'язок || Parameter{n}|var || Адреса до атрибуту параметру із архівом значень. |- | p{n}_ed || Параметр {n}: од.виміру || Рядок || Вхідний зв'язок || Parameter{n}|ed || |- | p{n}_prec || Параметр {n}: точність || Цілий || Вхідний зв'язок || Parameter{n}|prec || |- | p{n}_flSum || Параметр {n}: показник підсумку || Логічний || Стала || Parameter{n}|flSum || Ознака обчислення суми значень параметру для робочої зміни. |} {| class="wikitable" <section begin=docRepYear /> | {{Anch|docRepYear|<h4>Річний звіт місячних значень ([[Special:MyLanguage/Libs/Documents#docRepYear|docRepYear]])</h4>}} | 1.3 || GPLv2 || * || en, uk, ru <section end=docRepYear /> | [[User:RomanSavochenko|Роман Савоченко]] || -2 мс (вимкнено) |} Документ, представлений на рисунку 1.2.6, слугує для генерації добового звіту місячних значень у вигляді діаграми трендів та таблиці даних. Документ динамічного типу. Документ загалом використовує та представляє представницьку структуру DAQ-шаблону "[[Special:MyLanguage/Libs/Main#anUnif|Аналоговий сигнал]]". У якості джерела даних документу виступають переважно [[Special:MyLanguage/Documents/Program_manual#ArchVals|архіви значень]] DAQ-параметрів. Документом вперше запроваджено ручне введення архівних значень великого інтервалу часу вимірювання, яким у цьому випадку є місяць, як недетермінований інтервал. Найбільшу актуальність ця функція становить для лічильників, які з тієї або іншої причини неможливо підключити до системи прямо, із безперервним вимірюванням або періодичним вивантаженням ділянок архіву. Визначення параметру до ручного вводу здійснюється встановленням постійної '''isMan''' відповідного параметру, що вмикає елементи форми нагорі документу, за відповідних прав ("root" або у групі "ITW"), та доступ до даних для таблиці та тренду суворо за інтервалом документу — місяць, як і їх введення. Зберігання введених вручну даних здійснюється або традиційно у архів значень, із записом лише одного значення на представницький інтервал, тобто із недостовірними значеннями між ними; або окремим записом зі значенням у архіві повідомлень, що також запроваджено цим документом вперше: : КАТЕГОРІЯ: визначає ID джерела ''SrcID'' у форматі "'''val{SrcID}'''", де: :* "val*" — типовий шаблон-ознака значення, який може бути безпосередньо використано у фільтрі категорії для визначення суто значень у повідомленнях; :* ''SrcID'' — ідентифікатор джерела, що безпосередньо вводиться постійною у адресі параметру '''var'''. : ТЕКСТ: назва ''Name'' та значення ''Value'' параметру у форматі "'''{Name}: {Value}'''". Архіватор повідомлень [[Special:MyLanguage/Modules/FSArch|модуля FSArch]] має бути встановлено у наступних атрибутах для здійснення коректної роботи разом із цим документом: встановити "Запобігати дублікатам", "Вважати дублікатами та запобігати, для рівного часу, категорії, рівня" та встановити "Розмір файлів за часом" у 3660 діб. [[Special:MyLanguage/Modules/DBArch|Модуль DBArch]] має працювати без такого роду специфіки. [[file:LibDocuments_docRepYear_uk.png|center|frame|Рис.1.2.6. Документ "Річний звіт місячних значень" у режимі виконання.]] {{CntHdr|Використання — розробка}} Документ призначено для виконання ролі сторінки-шаблону, а, відповідно, він має безпосередньо розташовуватися у дерево проекту. До кожного документу може підключатися до десяти параметрів, шляхом встановлення зв'язків. Елементи, для яких не буде встановлено зв'язку, будуть приховані при виконанні. [[file:at.png]] Для кожного документу можна встановити: * атрибут "Архіватор ('''arch''')" у потрібний архіватор значень та повідомлень зі значенням у формі '''{ValArch};{MessArch}''', які обслуговують визначені параметри; ви не маєте використовувати архіватори із якістю гірше за одну добу для значень; * атрибут "Ввімкнути графік ('''enGraph''')" для ввімкнення/вимкнення графіку; * атрибут "Заголовок ('''title''')" у специфічний заголовок документу. {{CntHdr|Використання — виконання}} У режимі виконання відображаються елементи, для яких встановлено зв'язки. Рік формування документу доступно до обрання на горі цього документу, від поточного та на десять років у глиб. За наявності прав ("root" або у групі "ITW") користувач має можливість введення значень параметрів із позначкою ручного введення ('''isMan''') за допомогою елементів форми нагорі, де можна обрати місяць, параметр та значення, яке буде записано одразу після підтвердження та відображено у документі. {{CntHdr|Властивості зв'язування та конфігурації}} {| class="wikitable" |- ! Ідентифікатор !! Ім'я !! Тип !! Конфігурація !! Конфігураційний шаблон !! Опис |- | colspan="6" | ''Віджет документу (doc)'' |- | arch || Архіватор, {ValArch};{MessArch} || Рядок || Стала || || Архіватор значень та повідомлень зі значенням у формі '''{ValArch};{MessArch}''', по замовченню та найліпше використовувати одно-годинний архіватор "FSArch.1h". |- | title || Заголовок || Рядок || Стала || || Заголовок звіту |- | enGraph || Ввімкнути графік || Логічний || Стала || || Ввімкнено по замовченню. |- | depth || Глибина для обрання, років || Цілий || Стала || || Глибина років для обрання. |- | showOrigCntr || Показати оригінальний лічильник || Логічний || Стала || || Показати значення оригінального лічильника поряд із інтервальним значенням. |- | colspan="6" | ''Параметр {n} від 1 до 10.'' |- | p{n}name || Параметр {n}: назва || Рядок || Вхідний зв'язок || Parameter{n}|NAME || Назва параметру у заголовку таблиці. |- | p{n}var || Параметр {n}: змінна || Адреса || Вхідний зв'язок || Parameter{n}|var || Адреса до атрибуту параметру із архівом значень або ідентифікатор параметру ('''val:{PrmId}''') для ручного запису значень із збереженням у архіві повідомлень. |- | p{n}ed || Параметр {n}: одиниця виміру || Рядок || Вхідний зв'язок || Parameter{n}|ed || |- | p{n}prec || Параметр {n}: точність || Цілий || Вхідний зв'язок || Parameter{n}|prec || |- | p{n}cntr || Параметр {n}: це лічильник || Логічний || Стала || Parameter{n}|isCntr || Встановлюється для лічильників з метою отримання значень як різницю. |- | p{n}max || Параметр {n}: максимум || Адреса || Вхідний зв'язок || Parameter{n}|max || Використано для визначення шкали параметру на графіку. |- | p{n}min || Параметр {n}: мінімум || Адреса || Вхідний зв'язок || Parameter{n}|min || Використано для визначення шкали параметру на графіку. |- | p{n}isMan || Параметр {n}: ручний || Логічний || Стала || Parameter{n}|isMan || Позначає параметр як до ручного введення. |} == {{Anch|ServFunc|Сервісні пов'язані функції}} == Сервісні функції кадрів звітів та документів призначено для виконання характерних задач отримання звітних даних, для чого треба здійснювати якусь перевірку або підрахунок, наприклад, перевіряти достовірність та підсумовувати. Сервісною функцією може бути й формування складних даних, як то вбудованих у документ діаграм. Для адресації до функцій цієї бібліотеки можна використати статичну адресу виклику '''DAQ.JavaLikeCalc.lib_doc.{Func}()''' або динамічну '''SYS.DAQ.JavaLikeCalc["lib_doc"]["{Func}"].call()''', '''SYS.DAQ.JavaLikeCalc["lib_doc"].{Func}()'''. Де ''{Func}'' — ідентифікатор функції у бібліотеці. Для підключення частини бібліотеки до проекту станції OpenSCADA ви можете отримати файл БД як: * такий що постачається з готовим та відповідним пакетом дистрибутиву Linux на кшталт "openscada-libdb-main", "openscada-LibDB.Main"; * найбільш актуальний та безпосередньо отриманий з [http://oscada.org/svn/trunk/OpenSCADA/data/LibsDB/OscadaLibs.sql репозиторію subversion], перетворений у файл БД SQLite шляхом: <syntaxhighlight lang="BASH" style="margin-left: 15px"> wget http://oscada.org/svn/trunk/OpenSCADA/data/LibsDB/OscadaLibs.sql sqlite3 -init OscadaLibs.sql OscadaLibs.db .exit </syntaxhighlight> * завантаження [[:File:OscadaLibs.db.gz|прикріпленого тут]]. Цей завантажений файл Ви надалі можете розмістити у теці проекту станції та створити об'єкт бази даних модуля БД "SQLite", зареєструвавши файл бази даних у конфігурації. {| class="wikitable" <section begin=getVal /> | {{Anch|getVal|<h3>Отримання значення з архіву значень ([[Special:MyLanguage/Libs/Documents#getVal|getVal]])</h3>}} || 1.1 || GPLv2 || * || en, uk, ru <section end=getVal /> | [[User:RomanSavochenko|Роман Савоченко]] |} Запит значення за визначений час (''time'':''uTime'') із пов'язаного архіватору ''archtor'' (FSArch.1m) та формування результату із визначеною кількістю знаків ''prec'' після коми. Функція працює із об'єктами атрибутів DAQ-параметрів до яких підключено архів, та адреса ''addr'' до нього записується повним шляхом на кшталт "/DAQ/LogicLev/gen/prm_F3/a_var". Для порожнього ''archtor'' запит буде здійснюватися загально до усіх із періодичністю буферу архіву. У процесі отримання значення, час цього значення може відрізнятися від запитаного, якщо архів на цей час відсутній та повертається найближче, запобігти чому можна встановивши ''strong''. Коли-ж таки потрібно контрольовано отримати найближче достовірне значення, наприклад для лічильників, то передбачено аргумент часу ''tryTo'' до якого шукати найближче достовірне значення. Час у ''tryTo'' може бути як більше, так і менше за час запиту. Первинно, результат надається у вигляді рядка реального значення із визначеною кількістю знаків ''prec'' після коми, та із значенням "Порожньо" для недостовірних значень, що дозволяє вставляти його до документу без додаткової обробки. Однак, за потреби додаткової обробки та специфічного форматування, результат можна отримати неформатованим реальним значенням, для ''prec'' менше 0. {{CntHdr|Параметри}} {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! Прихований !! По замовченню |- | rez || Результат || Рядок || Повернення || false || |- | addr || Адреса || Рядок || Вхід || false || |- | time || Час, секунд || Цілий || Вхід || false || |- | uTime || Час, мікросекунди || Цілий || Вхід || false || |- | prec || Знаків після коми || Цілий || Вхід || false || 3 |- | archtor || Архіватор || Рядок || Вхід || false || |- | strong || Точно || Логічний || Вхід || false || 0 |- | tryTo || Пробувати значення до, мікросекунди || Цілий || Вхід || false || 0 |} {| class="wikitable" <section begin=averVal /> | {{Anch|averVal|<h3>Середнє значення архіву значень ([[Special:MyLanguage/Libs/Documents#averVal|averVal]])</h3>}} || 1.1 || GPLv2 || * || en, uk, ru <section end=averVal /> | [[User:RomanSavochenko|Роман Савоченко]] |} Обчислення середнього значення за вказаний період часу [''bTime''...''eTime''], для даних архіватору ''archtor'' (FSArch.1m) та формування результату із визначеною кількістю знаків ''prec'' після коми. Функція працює із об'єктами атрибутів DAQ-параметрів до яких підключено архів, та адреса ''addr'' до нього записується повним шляхом на кшталт "/DAQ/LogicLev/gen/prm_F3/a_var". Для порожнього ''archtor'' запит буде здійснюватися загально до усіх із періодичністю буферу архіву. У процесі підрахунку здійснюється перевірка даних у архіві на предмет достовірності та формується значення відсотку достовірних даних ''actPerc'', що прийняли участь у отримані результату. Загалом, варто використовувати проміжні архіватори — архіватори середньої якості, щоб даних у ньому, за визначений інтервал, не було забагато для зниження продуктивності, та щоб це не було взагалі одне значення. Первинно, результат надається у вигляді рядка реального значення із визначеною кількістю знаків ''prec'' після коми, та із значенням "Порожньо" для недостовірних значень, що дозволяє вставляти його до документу без додаткової обробки. Однак, за потреби додаткової обробки та специфічного форматування, результат можна отримати неформатованим реальним значенням, для ''prec'' менше 0. {{CntHdr|Параметри}} {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! Прихований !! По замовченню |- | rez || Результат || Рядок || Повернення || false || |- | addr || Адреса || Рядок || Вхід || false || |- | bTime || Час початку, секунд || Цілий || Вхід || false || |- | eTime || Час кінця, секунд || Цілий || Вхід || false || |- | prec || Знаків після коми || Цілий || Вхід || false || 3 |- | archtor || Архіватор || Рядок || Вхід || false || |- | actPerc || Відсоток актуальних значень || Реальний || Вихід || false || |} {| class="wikitable" <section begin=sumVal /> | {{Anch|sumVal|<h3>Підсумок значень архіву значень ([[Special:MyLanguage/Libs/Documents#sumVal|sumVal]])</h3>}} || 1.1 || GPLv2 || * || en, uk, ru <section end=sumVal /> | [[User:RomanSavochenko|Роман Савоченко]] |} Обчислення суми значень за вказаний період часу [''bTime''...''eTime''], для даних архіватору ''archtor'' (FSArch.1m) та формування результату із визначеною кількістю знаків ''prec'' після коми. Функція працює із об'єктами атрибутів DAQ-параметрів до яких підключено архів, та адреса ''addr'' до нього записується повним шляхом на кшталт "/DAQ/LogicLev/gen/prm_F3/a_var". Для порожнього ''archtor'' запит буде здійснюватися загально до усіх із періодичністю буферу архіву. У процесі підрахунку здійснюється перевірка даних у архіві на предмет достовірності. Первинно, результат надається у вигляді рядка реального значення із визначеною кількістю знаків ''prec'' після коми, та із значенням "Порожньо" для недостовірних значень, що дозволяє вставляти його до документу без додаткової обробки. Однак, за потреби додаткової обробки та специфічного форматування, результат можна отримати неформатованим реальним значенням, для ''prec'' менше 0. {{CntHdr|Параметри}} {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! Прихований !! По замовченню |- | rez || Результат || Рядок || Повернення || false || |- | addr || Адреса || Рядок || Вхід || false || |- | bTime || Час початку, секунд || Цілий || Вхід || false || |- | eTime || Час кінця, секунд || Цілий || Вхід || false || |- | prec || Знаків після коми || Цілий || Вхід || false || 3 |- | archtor || Архіватор || Рядок || Вхід || false || |} {| class="wikitable" <section begin=diagram /> | {{Anch|diagram|<h3>Діаграма ([[Special:MyLanguage/Libs/Documents#diagram|diagram]])</h3>}} | 1.4 || GPLv2 || * || en, uk, ru <section end=diagram /> | [[User:RomanSavochenko|Роман Савоченко]] |} Побудова діаграми трендів у SVG, яка може надалі вбудовуватися у XHTML-документу, для даних за вказаний період часу [(''end''-''size'')...''end''] та із джерел ''srcs''. * '''Загальна працемісткість:''' 1.3 {{CtxDetails|ЛД|людино-днів, 1ЛД — 10 годин}} * '''Спонсоровано, початкової імплементації на 1.0 {{CtxDetails|ЛД|людино-днів, 1ЛД — 10 годин}}:''' Магомед, [https://www.savtech.ru SAVTECH] Код формування діаграми засновано на коді примітиву "[[Special:MyLanguage/Sub-projects/VCA#Diagram|Діаграма]]" візуалізаторів, та який було доволі просто перенесено із мови C++ на [[Special:MyLanguage/Modules/JavaLikeCalc|вбудовану мову JavaLikeCalc]]. Наразі перенесено-реалізовано лише тренди! Вигляд діаграми визначається її розмірами ''hsz''*''vsz'' та початковим SVG-шаблоном ''tmpl'', низка атрибутів кореневого тегу якого мають особливе значення та які відповідають примітиву "[[Special:MyLanguage/Sub-projects/VCA#Diagram|Діаграма]]": * Шкала: Маркери: шрифт (sclMarkFont), по замовченню "Arial 10". * Шкала: горизонтальна (sclHor), по замовченню "Маркери (2)" та загалом передбачено: "Не зображувати (0)", "Ґратка (1)", "Маркери (2)", "Ґратка та маркери (3)". * Шкала: вертикальна (sclVer), по замовченню "Ґратка та маркери (3)" та загалом передбачено: "Не зображувати (0)", "Ґратка (1)", "Маркери (2)", "Ґратка та маркери (3)", "Ґратка (лог) (5)", "Маркери (лог) (6)", "Ґратка та маркери (лог) (7)". * Шкала: колір (sclColor), по замовченню "gray". * Шкала: Маркери: колір (sclMarkColor), по замовченню "gray". У якості джерела даних наразі можуть використовуватися лише архіви значень, прямою адресою до них або через атрибут DAQ-параметру з архівом. Кількість джерел даних прямо не обмежене та вони записуються окремими рядками аргументу ''srcs'' із форматом "'''{addr}:{min}:{max}:{color}[:{scale}[:{width}]]'''", де: * '''addr''' — адреса до: ** архіву значень ("/Archive/va_CPULoad_load") або атрибуту DAQ-параметру ("/DAQ/LogicLev/gen/F3/var"); ** прямі дані у формі "'''<d s='1' aprox='1' per='1'>{p0}={pV0},{p1}={pV1},...,{pN}={pVN}</d>'''", встановленням атрибуту "s" можна вказати на період у секундах; "aprox" — апроксимувати перехід від однієї точки до іншої замість підставки попереднього значення у всі точки періодичності від упаковки. * '''min''', '''max''' — мінімум та максимум шкали, за відсутності шкали ('''min''' >= '''max''') вона буде вираховуватися із реальних даних; * '''color''' — колір кривої тренду; * '''scale''' — окреме визначення шкали тренду, по замовченню "Глобально (0)" та загалом передбачено: "Глобально (0)", "Маркери (2)", "Ґратка та маркери (3)", "Маркери (лог) (6)", "Ґратка та маркери (лог) (7)". * '''width''' — ширина кривої тренду, по замовченню 2. [[file:LibDocuments_docRepInstVals_uk.png|center|frame|Рис.2.4. Типовий результат функції "Діаграма" у XHTML-документі.]] {{CntHdr|Параметри}} {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! Прихований !! По замовченню |- | res || Результат || Текст || Повернення || false || |- | end || Час кінця, секунд || Реальний || Вхід || false || 0 |- | size || Розмір, секунд || Реальний || Вхід || false || 3600 |- | srcs || Джерела || Текст || Вхід || false || <pre style="white-space: pre-wrap;"> /DAQ/LogicLev/gen/F3/var:0:100:#ae77c3:2 /Archive/va_CPULoad_load:0:0:darkcyan:2 </pre> |- | hsz || Горизонтальний розмір, пікселів || Цілий || Вхід || false || 600 |- | vsz || Вертикальний розмір, пікселів || Цілий || Вхід || false || 400 |- | arch || Архіватор || Рядок || Вхід || false || |- | tmpl || Шаблон || Текст || Вхід || false || <syntaxhighlight lang="XML"> <svg xmlns="http://www.w3.org/2000/svg" version="1.1" sclMarkFont="Arial 10" sclHor="2" sclVer="3" sclColor="gray" sclMarkColor="gray"> <style type="text/css"> #scVer rect { stroke: none; } #scVer text { stroke: none; } #scHor rect { stroke: none; } #scHor text { stroke: none; } #drawArea path { fill: none; } </style> <!--Draw grid and markers--> <g id="scVer" /> <g id="scHor" /> <!--Curves area --> <g id="drawArea" /> </svg> </syntaxhighlight> |}
Navigation menu
OpenSCADA
Site
Download
Old Wiki
OpenSCADA Wiki
Home
About OpenSCADA
Functions and demands
Tasks
Using
Fund
Recent changes
Random page
Search
Tools
Special pages
Printable version
MediaWiki
Help
Personal tools
English
Log in