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/Update 8
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:Модулі/HTTP}}<languages/> {| class="wikitable" |- ! Модуль !! Ім'я !! Версія !! Ліцензія !! Джерело !! Мови !! Платформи !! Тип !! Автор !! Опис |- <section begin=info /> | [[Special:MyLanguage/Modules/HTTP|HTTP]] || HTTP-реалізація | 3.9 || GPL2 || prot_HTTP.so || en,uk,ru,de || x86,x86_64,ARM <section end=info /> | Протокол || Роман Савоченко || Надає підтримку HTTP для WWW базованих користувацьких інтерфейсів. * '''[[Special:MyLanguage/Works/To_do|Завдання (To Do)]]:''' <section begin=ToDo /> <section end=ToDo /> |} Модуль транспортного протоколу HTTP призначено для реалізації підтримки мережевого протоколу HTTP(Hypertext Transfer Protocol) у OpenSCADA. Протокол HTTP використовується для передачі вмісту WWW. До прикладу, через HTTP передаються наступні типи документів: html, xhtml, png, javascript і багато інших. Підтримка HTTP у OpenSCADA разом із транспортом [[Special:MyLanguage/Modules/Sockets|Sockets]] і [[Special:MyLanguage/Modules/SSL|SSL]], дозволяє реалізовувати різні користувацькі функції на WWW інтерфейсі. Модуль первинно реалізує два основних методи HTTP протоколу GET, POST, і наразі будь який метод HTTP. Модуль забезпечує контроль цілісності HTTP-запитів та, спільно з транспортом Сокети і SSL, дозволяє "збирати" цілісні запити з їх фрагментів, а також забезпечувати утримання з'єднання "живим" (Keep-Alive). Для гнучкого підключення користувацьких інтерфейсів до даного модуля, використовується модульний механізм у межах самого цього модуля. У ролі модулів використовуються модулі підсистеми "Користувацькі інтерфейси" з додатковим інформаційним полем "SubType", зі значенням "WWW". У запитах до Web ресурсів прийнято використовувати URL(Universal Resource Locator). Відтак, URL передається як основний параметр через HTTP. Перший елемент URL запиту використовується для ідентифікації модуля UI. Наприклад, URL "<nowiki>http://localhost:10002/WebCfg</nowiki>" означає звернення до модуля "WebCfg" на хості "<nowiki>http://localhost:10002</nowiki>". У випадку помилкового визначення ідентифікатору модуля, або при звернені взагалі без ідентифікатору, модуль генерує інформаційний діалог про вхід та вибір одного з доступних користувацьких інтерфейсів. Приклад діалогу наведено на рисунку 1. [[File:HTTP_select_uk.png|center|frame|Рис.1. Діалог вибору модуля WWW-інтерфейсу.]] Модулем підтримується багатомовність, яка вмикається [[Documents/Program_manual/uk#ConfigTr|динамічним перекладом повідомлень OpenSCADA]]. Мова кінцевого користувацького інтерфейсу визначається шляхом та у послідовності: * URL параметр "lang". * Мова користувача, що увійшов. * Мова Web-браузеру з HTTP властивості "Accept-Language". * Загальна мова процесу OpenSCADA. Отримана таким чином мова використовується для побудови інтерфейсів цього модуля і передається WWW під-модулям у HTTP властивості "oscd_lang", через аргумент "vars" [[#ModsHTTP|функції узагальнення, "GET" і "POST"]]. Для конфігурації і керування цим модулем надається конфігураційна сторінка інтерфейсу керування OpenSCADA (Рис.3), де можете здійснювати: * Контроль за активними сеансами автентифікації. * Конфігурацію: ** Правила доступу для заборони і дозволу. Кожний рядок є окремим правилом і ви можете використовувати шаблони на кшталт "*/WebVision/*" або регулярні вирази на кшталт "/[^/]+/WebVision/.+/". Корисні записи для: *** Заборонено: **** "*/WebCfgD/*" — [[Special:MyLanguage/Modules/WebCfgD|модуль WebCfgD]] цілком; **** "*/WebVision/*tmplSO/*" — проєкт СВУ "tmplSO" [[Special:MyLanguage/Modules/WebVision|модуля WebVision]]. *** Дозволено: **** "*" — все, виключаючи заборонене; **** "/^[^/]+/[^/]*$/" — сторінки модуля з усіма їх ресурсами; **** "*/login/*" — сторінка авторизації-входу; **** "/^[^/]+/WebVision/[^/]*($|\?)/" — основна сторінка [[Special:MyLanguage/Modules/WebVision|модуля WebVision]] без доступу до проєктів СВУ; **** "/^[^/]+/WebVision/.+_aviariesOril\d*/.*/" — проєкт СВУ "aviariesOril" [[Special:MyLanguage/Modules/WebVision|модуля WebVision]]. ** HTML-шаблон користувацького інтерфейсу і користувацької головної сторінки. У полях HTML-шаблону має вказуватися адреса до файлу HTML/XHTML, який буде використано у формуванні внутрішніх-сервісних інтерфейсів та головної сторінки. Внутрішні-сервісні інтерфейси, це наприклад: обрання модулів, сторінка авторизації і подібне у WEB-модулів. Від шаблону вимагається коректність XHTML, яка дозволяє розібрати файл XML-парсером, а також наявність мітки "#####CONTEXT#####" у місці розташування динамічного вмісту, що обов'язково для внутрішніх-сервісних інтерфейсів. Ресурсні файли шаблонів представлено зображеннями, CSS і JavaScript файлами, та які шукаються від теки у якій вказано розташування файлу шаблону і від поточної теки. Для іншого файлу шаблону до мови, Ви можете додати суфікс мови у кінець цього файлу "{Мій Шаблон}_{мова}.html", але обирати у конфігураційних полях основний-базовий файл шаблону "{Мій Шаблон}.html". У випадку виявлення помилок у шаблоні буде використано стандартний вбудований інтерфейс. У якості прикладу шаблонів можете подивитися такі найбільш вживані: *** [[:File:HTTP_webopenscada.html.gz|Шаблон внутрішнього-сервісного інтерфейсу та головної сторінки включаючи індекс модулів]]. *** [[:File:HTTP_webopenscada_main.html.gz|Шаблон головної сторінки]] із прямим посиланням на головний інтерфейс [[Special:MyLanguage/Using/Model_AGLKS|АГЛКС]] за допомогою модуля [[Special:MyLanguage/Modules/WebVision|UI.WebVision]] і без індексу WEB-модулів. *** [[:File:HTTP_webopenscada_goto.html.gz|Шаблон головної сторінки]] із прямим переспрямуванням на головний інтерфейс [[Special:MyLanguage/Using/Model_AGLKS|АГЛКС]] за допомогою модуля [[Special:MyLanguage/Modules/WebVision|UI.WebVision]]. ** БД активних сеансів аутентифікації передбачає зовнішню таблицю активних сеансів аутентифікації — "HTTP_AuthSessions", яка вмикається для непорожнього значення і надає можливість спільного використання аутентифікації між різними станціями OpenSCADA і її короткого збереження на час вимкнення станції. ** Простір генерації UID автентифікації, доступне зі спільною таблицею сеансів автентифікації для гарантування відмінності "печеньок" (cookie) для різних процесів OpenSCADA. ** Час життя, перелік користувачів дозволених до аутентифікації і встановлення автоматичного входу. [[File:HTTP_mod_uk.png|center|frame|Рис.3. Сторінка налаштування модуля.]] == Аутентифікація == Модулем підтримується аутентифікація у OpenSCADA при надані доступу до модулів WEB-інтерфейсів (рис.2). [[File:HTTP_auth_uk.png|center|frame|Рис.2. Діалог аутентифікації у OpenSCADA.]] Аутентифікація цим модулем здійснюється "печеньками" (cookies) із динамічною назвою і простором ІД користувача, де назва "печеньки" (cookie) "oscd_UID" і використовується простір ІД користувача у роботі із спільною таблицею сеансів автентифікації, та назва "oscd_UID_{PrjNm}" у роботі без неї. Для полегшення роботи з Web-інтерфейсами, модуль передбачає можливість автоматичного входу від ім'я вказаного користувача. Конфігурація автоматичного входу здійснюється на сторінці налаштування модуля (рис.3). Автоматичний вхід здійснюється за збігом адреси, вказаної у стовпчику "Адреса", і від ім'я користувача, вказаного у стовпчику "Користувач". Для більшої безпеки, можете визначити тільки Web-користувачів у переліку користувачів дозволених до аутентифікації. == {{Anch|ModsHTTP|Модулі WEB-інтерфейсу}} == Модулі користувацького інтерфейсу (UI), які призначені для спільної роботи із модулем HTTP, мають встановлювати інформаційне поле "SubType" значенням "WWW" та поле "Auth" значенням "1", якщо модуль потребує автентифікації при вході. Для зв'язування модуля HTTP і модулів UI використовується розширений механізм комунікації. Цей механізм передбачає експорт інтерфейсних функцій. У даному випадку, UI модулі мають експортувати лише одну загальну функцію для усіх методів: * '''void HTTP(const string &meth, const string &uri, string &page, vector<string> &vars, const string &user, TProtocolIn *iprt);''': ::''meth'' — метод запиту; ::''uri'' — локальна адреса запиту; ::''page'' — сторінка з відповіддю; ::''sender'' — адреса відправника; ::''vars'' — змінні запиту; ::''user'' — користувач, може містити попереднього користувача у другому рядку; ::''iprt'' — посилання на об'єкт вхідної частини протоколу. Або наступні різні функції окремо для GET і POST методів: * '''void HTTP_GET(const string &uri, string &page, vector<string> &vars, const string &user, TProtocolIn *iprt);''' АБО :'''void HttpGet( const string &uri, string &page, const string &sender, vector<string> &vars, const string &user );''' — Метод GET з параметрами: ::''uri'' — локальна адреса запиту; ::''page'' — сторінка з відповіддю; ::''sender'' — адреса відправника; ::''vars'' — змінні запиту; ::''user'' — користувач, може містити попереднього користувача у другому рядку; ::''iprt'' — посилання на об'єкт вхідної частини протоколу. * '''void HTTP_POST(const string &uri, string &page, vector<string> &vars, const string &user, TProtocolIn *iprt);''' АБО :'''void HttpPost( const string &uri, string &page, const string &sender, vector<string> &vars, const string &user );''' — метод POST з параметрами: ::''uri'' — локальна адреса запиту; ::''page'' — сторінка з відповіддю та вмістом тіла запиту POST; ::''sender'' — адреса відправника; ::''vars'' — змінні запиту; ::''user'' — користувач, може містити попереднього користувача у другому рядку; ::''iprt'' — посилання на об'єкт вхідної частини протоколу. Надалі, у випадку надходження HTTP запиту "GET" буде викликатися функція "HTTP_GET" або "HttpGet", а у випадку запиту "POST" буде викликатися функція "HTTP_POST" або "HttpPost", у відповідному модулі UI, або функція "HTTP" для будь якого методу. == Функція вихідних запитів користувацького API == Функція вихідних запитів [[Special:MyLanguage/Documents/User_API#SYSTransport|messIO()]] оперує обміном вмістом HTTP-запитів, загорнутими у XML-пакети. Структура запиту має вигляд: <syntaxhighlight lang="XML"> <req Host="host" URI="uri"> <prm id="pId">pVal</prm> <cnt name="cName" filename="cFileName"> <prm id="cpId">cpVal</prm> cVal </cnt> reqVal </req> </syntaxhighlight> :Де: :* ''req'' — метод запиту, підтримується методи "GET" та "POST". :* ''host'' — адреса вузла http-серверу у форматі ''{HostAddr}:{HostIp}''. Якщо дане поле опущено то використовується адреса вузла, вказана у полі адреси транспорту. :* ''uri'' — адреса ресурсу на http-сервері, зазвичай файл або тека. :* ''pId'', ''pVal'' — ідентифікатор та значення додаткового http-параметру. Http-параметрів може бути вказано багато, окремими ''prm'' тегами. :* ''cName'', ''cFileName'', ''cVal'' — ім'я, ім'я-файлу та значення елементу вмісту POST-запиту. Елементів вмісту може бути вказано багато, окремими ''cnt'' тегами. :* ''cpId'', ''cpVal'' — ідентифікатор та значення додаткового параметру вмісту. Параметрів вмісту може бути вказано багато, окремими ''prm'' тегами; :* ''reqVal'' — одинокий вміст POST запиту. Результатом запиту є відповідь зі структурою: <syntaxhighlight lang="XML"> <req Host="host" URI="uri" err="err" Protocol="prt" RezCod="rCod" RezStr="rStr"> <prm id="pId">pVal</prm> respVal </req> </syntaxhighlight> :Де: :* ''req'' — метод запиту. :* ''host'' — адреса вузла http-серверу. :* ''uri'' — адреса ресурсу. :* ''err'' — помилка, яка виникла під час запиту. У випадку вдалого запиту це поле порожнє. :* ''RezCod'', ''RezStr'' — результат запиту у вигляді коду та тексту. :* ''pId'', ''pVal'' — ідентифікатор та значення додаткового http-параметру відповіді. Http-параметрів може бути багато, визначені окремими ''prm'' тегами. :* ''respVal'' — вміст відповіді. Наведемо формування GET та POST запитів на мові JavaLikeCalc.JavaScript, у якості прикладу використання даної функції у користувацьких процедурах: <syntaxhighlight lang="JavaScript"> //GET запит HTML сторінки req = SYS.XMLNode("GET"); req.setAttr("URI","/"); SYS.Transport.Sockets.out_testHTTP.messIO(req,"HTTP"); test = req.text(); //GET запит та збереження файлу req = SYS.XMLNode("GET"); req.setAttr("URI","/oscadaArch/Work/openscada-0.9-r2188.tar.lzma"); SYS.Transport.Sockets.out_testHTTP.messIO(req,"HTTP"); if(!req.attr("err").length) SYS.fileWrite("/var/tmp/recvFile.tmp", req.text()); //POST запит req = SYS.XMLNode("POST"); req.setAttr("URI","/WebUser/FlowTec.txt"); cntNode = req.childAdd("cnt").setAttr("name","pole0").setAttr("filename","Object2-k001-100309-17.txt"); cntNode.childAdd("prm").setAttr("id","Content-Type").setText("text/plain"); cntText = "Object2-k001\r\n"; cntText += "\r\n"; cntText += "v002\r\n"; cntText += " n1\r\n"; cntText += " 09.03.10 16 Polnyj 7155.25 216.0 32.000 17.5\r\n"; cntText += "v005\r\n"; cntText += " n1\r\n"; cntText += " 09.03.10 16 Polnyj 188.81 350.0 4.000 40.0\r\n"; cntText += "\r\n"; cntNode.setText(cntText); SYS.Transport.Sockets.out_testHTTP.messIO(req,"HTTP"); //POST запит із одиничним вмістом req = SYS.XMLNode("POST"); req.setAttr("URI","/WebUser/FlowTec.txt"); req.childAdd("prm").setAttr("id","Content-Type").setText("text/plain"); cntText = "Object2-k001\r\n"; cntText += "\r\n"; cntText += "v002\r\n"; cntText += " n1\r\n"; cntText += " 09.03.10 16 Polnyj 7155.25 216.0 32.000 17.5\r\n"; cntText += "v005\r\n"; cntText += " n1\r\n"; cntText += " 09.03.10 16 Polnyj 188.81 350.0 4.000 40.0\r\n"; cntText += "\r\n"; req.setText(cntText); SYS.Transport.Sockets.out_testHTTP.messIO(req,"HTTP"); </syntaxhighlight> == API користувацького програмування == <section begin=API /> '''Вхідна частина об'єкту модуля (SYS.Protocol.HTTP.{In})''' * ''bool setUser( string user )'' — змінює користувача пов'язаного із ідентифікатором сеансу автентифікації. ** ''user'' — користувач для зміни. * ''bool pgAccess(string URL)'' — перевіряє доступність сторінки, визначеної у ''URL''. ** ''URL'' — URL сторінки, що перевіряється. * ''string pgCreator(string cnt, string rcode = "", string httpattrs = "Content-Type: text/html;charset={SYS}", string htmlHeadEls = "", string forceTmplFile = "")'' — формує сторінку або ресурс із вмістом ''cnt'', загорнутим у HTTP з результатом ''rcode'', із додатковими атрибутами HTTP ''httpattrs'', додатковим елементом заголовку HTML ''htmlHeadEls'' та використанням файлу шаблону ''forceTmplFile'' та для мови ''lang''. ** ''cnt'' — вміст сторінки або ресурсу (зображення, XML, CSS, JavaScript, ...); ** ''rcode'' — результуючий код HTTP, на кшталт "200 OK"; порожнє значення вимикає додання HTTP заголовку; ** ''httpattrs'' — додаткові атрибути HTTP, переважно це "Content-Type" із значенням по замовченню "text/html;charset={SYS}"; тільки для "Content-Type: text/html" буде здійснюватися загортання у внутрішній/сервісний, або визначений ''forceTmplFile'', HTML-шаблон; ** ''htmlHeadEls'' — додатковий тег заголовку HTML, переважно це META з "Refresh" для вказаного URL; ** ''forceTmplFile'' — файл прямо визначеного шаблону для перекриття внутрішнього/сервісного або головної сторінки. <section end=API />
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
216.73.216.144
Talk for this IP address
Log in