OpenSCADAWiki: Doc/API/part18 ...

Home | Index | Changes | Comments | Users | Registration | Login:   Password:  
 
This is an old revision of Doc/API/part18 from 2009-11-17 09:36:49..

18. Ñåðâèñíûå ôóíêöèè èíòåðôåéñà óïðàâëåíèÿ OpenSCADA

Ñåðâèñíûå ôóíêöèè - ýòî èíòåðôåéñ äîñòóïà ê ñèñòåìå OpenSCADA ïîñðåäñòâîì èíòåðôåéñà óïðàâëåíèÿ OpenSCADA èç âíåøíèõ ñèñòåì. Äàííûé ìåõàíèçì ïîëîæåí â îñíîâó âñåõ ìåõàíèçìîâ îáìåíà âíóòðè OpenSCADA, ðåàëèçîâàííûõ ïîñðåäñòâîì ñëàáûõ ñâÿçåé è ñòàíäàðòíîãî ïðîòîêîëà îáìåíà OpenSCADA. Îñíîâíûì åãî ïðåèìóùåñòâîì ÿâëÿåòñÿ ïðèîðèòåòíàÿ îáðàáîòêà è âîçìîæíîñòü èñïîëüçîâàíèÿ íåñòàíäàðòíîé óïàêîâêè äàííûõ. Äëÿ äîñòóïà ê îáû÷íûì äàííûì ìîæíî èñïîëüçîâàòü ñòàíäàðòíûå êîìàíäû èíòåðôåéñà óïðàâëåíèÿ.

18.1. Ãðóïïîâîé äîñòóï ê çíà÷åíèÿì àòðèáóòîâ ïàðàìåòðîâ ïîäñèñòåìû "Ñáîð äàííûõ", à òàêæå ê äåòàëüíîé èíôîðìàöèè

Äàííûå çàïðîñû ïîçâîëÿþò ïîëó÷èòü äåòàëüíóþ èíôîðìàöèþ î ïàðàìåòðàõ ïîäñèñòåìû "Ñáîð äàííûõ", çàïðîñèòü çíà÷åíèÿ âñåõ àòðèáóòîâ ïàðàìåòðîâ, à òàêæå âûïîëíèòü ãðóïïîâóþ óñòàíîâêó. Äåòàëüíàÿ èíôîðìàöèÿ î çàïðîñàõ ïðèâåäåíà â òàáëèöå 23.


Òàáëèöà 23. Àòðèáóòû êîìàíä çàïðîñà àòðèáóòîâ ïàðàìåòðîâ ïîäñèñòåìû "Ñáîð äàííûõ"

IdÈìÿÇíà÷åíèå
Êîìàíäà çàïðîñà èíôîðìàöèè îá àòðèáóòàõ ïàðàìåòðà: <list path="/sub_DAQ/mod_{SRC}/cntr_{CNTR}/prm_{PRM}/%2fserv%2fattr"/>
<el id="iatr"/> Èíôîðìàöèÿ àòðèáóòîâ Â îòäåëüíûõ òåãàõ âîçâðàùàåòñÿ èíôîðìàöèÿ îá àòðèáóòå.
id
Èäåíòèôèêàòîð àòðèáóòà Ñèìâîëüíûé èäåíòèôèêàòîð îòäåëüíî âçÿòîãî àòðèáóòà.
nm
Èìÿ àòðèáóòà Èìÿ îòäåëüíî âçÿòîãî àòðèáóòà.
flg
Ôëàãè àòðèáóòà Ôëàãè îòäåëüíî âçÿòîãî àòðèáóòà.
tp
Òèï àòðèáóòà Òèï îòäåëüíî âçÿòîãî àòðèáóòà.
vals
Îáëàñòü çíà÷åíèé àòðèáóòà. Îáëàñòü çíà÷åíèé îòäåëüíî âçÿòîãî àòðèáóòà.
names
Èìåíà çíà÷åíèé àòðèáóòà äëÿ âûáîðî÷íîãî òèïà. Èìåíà çíà÷åíèé îòäåëüíî âçÿòîãî àòðèáóòà äëÿ âûáîðî÷íîãî òèïà.
Êîìàíäà çàïðîñà çíà÷åíèé âñåõ àòðèáóòîâ ïàðàìåòðà: <get path="/sub_DAQ/mod_{SRC}/cntr_{CNTR}/prm_{PRM}/%2fserv%2fattr"/>
<el id="iatr">val</el> Çíà÷åíèÿ àòðèáóòîâ  îòäåëüíûõ òåãàõ âîçâðàùàåòñÿ çíà÷åíèå àòðèáóòîâ.
Êîìàíäà óñòàíîâêè çíà÷åíèé óêàçàííûõ àòðèáóòîâ ïàðàìåòðà: <set path="/sub_DAQ/mod_{SRC}/cntr_{CNTR}/prm_{PRM}/%2fserv%2fattr"/>
<el id="iatr">val</el> Óêàçûâàþòñÿ çíà÷åíèÿ àòðèáóòîâ  îòäåëüíûõ òåãàõ óêàçûâàþòñÿ çíà÷åíèå àòðèáóòîâ.

18.2. Äîñòóï ê àðõèâíûì äàííûì àðõèâîâ ñîîáùåíèé

Äëÿ çàïðîñà äàííûõ àðõèâà â ïîäñèñòåìå àðõèâèðîâàíèÿ îáúåêòà àðõèâà ñîîáùåíèé ïðåäóñìîòðåíà êîìàíäà <info path="/sub_Archive/%2fserv%2fmess"/> è <get path="/sub_Archive/%2fserv%2fmess"/> äëÿ çàïðîñà èíôîðìàöèè îá àðõèâå è çíà÷åíèé àðõèâà ñîîòâåòñòâåííî. Äåòàëüíîå îïèñàíèå äàííûõ êîìàíä ïðåäñòàâëåíî â òàáëèöå 24.


Òàáëèöà 24. Àòðèáóòû êîìàíä çàïðîñà èíôîðìàöèè îá àðõèâå çíà÷åíèé è àðõèâíûõ äàííûõ

IdÈìÿÇíà÷åíèå
Êîìàíäà çàïðîñà èíôîðìàöèè îá àðõèâå: <info path="/sub_Archive/%2fserv%2fmess"/>
arch Óñòàíîâêà èìåíè àðõèâàòîðà àðõèâà Àðõèâàòîð àðõèâà, äëÿ êîòîðîãî îïðåäåëÿòü ïàðàìåòðû.
end Êîíòðîëü âåðøèíû àðõèâà â äàííîì àðõèâàòîðå Â ðåçóëüòàòå çàïðîñà óêàçûâàåò íà ðåàëüíóþ âåðøèíó àðõèâà ñîîáùåíèé â äàííîì àðõèâàòîðå <arch>.
beg Êîíòðîëü ãëóáèíû àðõèâà â äàííîì àðõèâàòîðå Â ðåçóëüòàòå çàïðîñà óêàçûâàåò íà ðåàëüíóþ ãëóáèíó àðõèâà ñîîáùåíèé â äàííîì àðõèâàòîðå <arch>.
Êîìàíäà çàïðîñà àðõèâíûõ è/èëè òåêóùèõ äàííûõ: <get path="/sub_Archive/%2fserv%2fmess"/>
tm Óñòàíîâêà âðåìåíè Âðåìÿ âåðøèíû áëîêà àðõèâà ñîîáùåíèé.
tm_grnd Óñòàíîâêà âðåìåíè îñíîâàíèÿ/íà÷àëà àðõèâà Óêàçûâàåò îñíîâàíèå/íà÷àëî àðõèâà.
arch Óñòàíîâêà àðõèâàòîðà àðõèâà Óêàçûâàåò, ó êàêîãî àðõèâàòîðà çàïðàøèâàòü çíà÷åíèÿ. Åñëè àðõèâàòîð íå óêàçàí, òî çàïðîñ áóäåò ïðîèçâîäèòüñÿ ïîñëåäîâàòåëüíî ó âñåõ àðõèâàòîðîâ ñ èñêëþ÷åíèåì äóáëèêàòîâ.
cat Óñòàíîâêà êàòåãîðèè ñîîáùåíèé Óêàçûâàåò êàòåãîðþ/øàáëîíû çàïðàøèâàåìûõ ñîîáùåíèé.
lev Óñòàíîâêà óðîâíÿ âàæíîñòè Óêàçûâàåò óðîâåíü âàæíîñòè ñîîáùåíèé, äëÿ êîòîðîãî è âûøå ïîëó÷àòü ñîîáùåíèÿ.
<el>mess</el> Ñîîáùåíèÿ Â îòäåëüíûõ òåãàõ âîçâðàùàþòñÿ ñîîáùåíèÿ.
time
Âðåìÿ ñîîáùåíèÿ Âðåìÿ îòäåëüíî âçÿòîãî ñîîáùåíèÿ.
cat
Êàòåãîðèÿ ñîîáùåíèÿ Êàòåãîðèÿ îòäåëüíî âçÿòîãî ñîîáùåíèÿ.
lev
Óðîâåíü ñîîáùåíèÿ Óðîâåíü îòäåëüíî âçÿòîãî ñîîáùåíèÿ.

18.3. Äîñòóï ê àðõèâíûì äàííûì àðõèâîâ çíà÷åíèé

Äëÿ çàïðîñà äàííûõ àðõèâà â ïîäñèñòåìå àðõèâèðîâàíèÿ îáúåêòà àðõèâà çíà÷åíèÿ è îáúåêòå àòðèáóòà ïàðàìåòðà ïîäñèñòåìû ñáîðà äàííûõ ïðåäóñìîòðåíà êîìàíäà <info path="{a_p_addr}/%2fserv%2fval"/> è <get path="{a_p_addr}/%2fserv%2fval"/> äëÿ çàïðîñà èíôîðìàöèè îá àðõèâå è çíà÷åíèé àðõèâà ñîîòâåòñòâåííî. Àòðèáóòû äàííûõ êîìàíä, ïðåäóñìàòðèâàþùèå ðàçëè÷íûå ìåõàíèçìû çàïðîñà, ïðåäñòàâëåíû â òàáëèöå 25.


Òàáëèöà 25. Àòðèáóòû êîìàíä çàïðîñà èíôîðìàöèè îá àðõèâå çíà÷åíèé è àðõèâíûõ äàííûõ

IdÈìÿÇíà÷åíèå
Êîìàíäà çàïðîñà èíôîðìàöèè îá àðõèâå: <info path="{a_p_addr}/%2fserv%2fval"/>
arch Óñòàíîâêà èìåíè àðõèâàòîðà àðõèâà Àðõèâàòîð àðõèâà, äëÿ êîòîðîãî îïðåäåëÿòü ïàðàìåòðû.
end Êîíòðîëü âåðøèíû àðõèâà â äàííîì àðõèâàòîðå  ðåçóëüòàòå çàïðîñà óêàçûâàåò íà ðåàëüíóþ âåðøèíó àðõèâà çíà÷åíèé â äàííîì àðõèâàòîðå <arch>.  ñëó÷àå îòñóòñòâèÿ àðõèâà àòðèáóò óñòàíàâëèâàåòñÿ â "0".
beg Êîíòðîëü ãëóáèíû àðõèâà â äàííîì àðõèâàòîðå  ðåçóëüòàòå çàïðîñà óêàçûâàåò íà ðåàëüíóþ ãëóáèíó àðõèâà çíà÷åíèé â äàííîì àðõèâàòîðå <arch>.  ñëó÷àå îòñóòñòâèÿ àðõèâà àòðèáóò óñòàíàâëèâàåòñÿ â "0".
per Êîíòðîëü ïåðèîäè÷íîñòè àðõèâà â äàííîì àðõèâàòîðå  ðåçóëüòàòå çàïðîñà óêàçûâàåò íà ðåàëüíóþ ïåðèîäè÷íîñòü çíà÷åíèé â äàííîì àðõèâàòîðå <arch>.  ñëó÷àå îòñóòñòâèÿ àðõèâà àòðèáóò óñòàíàâëèâàåòñÿ â "0".
vtp Êîíòðîëü òèïà çíà÷åíèé àðõèâà/ïàðàìåòðà Âîçâðàùàåò êîä òèïà çíà÷åíèé àðõèâíûõ äàííûõ: 0 - Boolean, 1 - Integer, 4 - Real, 5 - String. Òîëüêî äàííîå ñâîéñòâî äîñòóïíî â ñëó÷àå çàïðîñà ó ïàðàìåòðà áåç àðõèâà!
Êîìàíäà çàïðîñà àðõèâíûõ è/èëè òåêóùèõ äàííûõ: <get path="{a_p_addr}/%2fserv%2fval"/>
tm Óñòàíîâêà è êîíòðîëü âðåìåíè Âðåìÿ çàïðàøèâàåìîãî çíà÷åíèÿ èëè âåðøèíû áëîêà àðõèâà çíà÷åíèé. Åñëè àòðèáóò íå óêàçàí èëè ðàâåí "0", òî âîçâðàùàåòñÿ ïîñëåäíåå çíà÷åíèå. Çíà÷åíèå äàííîãî àòðèáóòà óñòàíàâëèâàåòñÿ â çíà÷åíèå âðåìåíè ïîëó÷åííîãî çíà÷åíèÿ èëè âåðøèíû áëîêà àðõèâíûõ äàííûõ.
tm_grnd Óñòàíîâêà è êîíòðîëü âðåìåíè îñíîâàíèÿ/íà÷àëà àðõèâà Óêàçûâàåò îñíîâàíèå/íà÷àëî àðõèâà. Åñëè àòðèáóò íå óêàçàí èëè ðàâåí "0", òî ïðîèçâîäèòñÿ çàïðîñ îäíîãî çíà÷åíèÿ. Çíà÷åíèå äàííîãî àòðèáóòà óñòàíàâëèâàåòñÿ â çíà÷åíèå âðåìåíè îñíîâàíèÿ áëîêà àðõèâíûõ äàííûõ.
per Óñòàíîâêà è êîíòðîëü ïåðèîäè÷íîñòè ïîëó÷àåìûõ çíà÷åíèé Ïåðèîäè÷íîñòü çàïðàøèâàåìûõ çíà÷åíèé. Åñëè àòðèáóò íå óêàçàí, ðàâåí "0" èëè ìåíüøå ÷åì ðåàëüíàÿ ïåðèîäè÷íîñòü àðõèâà, òî çíà÷åíèÿ áóäóò âîçâðàùàòüñÿ ñ ðåàëüíîé ïåðèîäè÷íîñòüþ àðõèâà è çíà÷åíèå äàííîãî àòðèáóòà óñòàíîâèòñÿ â çíà÷åíèå ðåàëüíîé ïåðèîäè÷íîñòè. Åñëè çíà÷åíèå àòðèáóòà áîëüøå ðåàëüíîé ïåðèîäè÷íîñòè, òî çíà÷åíèÿ àðõèâà áóäóò óñðåäíÿòüñÿ ê óêàçàííîé ïåðèîäè÷íîñòè.
arch Óñòàíîâêà è êîíòðîëü àðõèâàòîðà àðõèâà Óêàçûâàåò, ó êàêîãî àðõèâàòîðà çàïðàøèâàòü çíà÷åíèÿ. Åñëè àðõèâàòîð íå óêàçàí, òî çàïðîñ áóäåò ïðîèçâîäèòüñÿ ïîñëåäîâàòåëüíî ñ ïðèîðèòåòíîñòüþ îò ëó÷øåãî ê õóäøåìó. Èìÿ àðõèâàòîðà, ó êîòîðîãî ïîëó÷åíû çíà÷åíèÿ, áóäåò óêàçàííî â äàííîì àòðèáóòå ïðè âîçâðàòå ðåçóëüòàòà. Åñëè àðõèâàòîð äëÿ äàííîãî ïàðàìåòðà íå óñòàíîâëåí èëè òàêîãî àðõèâàòîðà íåò, òî çíà÷åíèå äàííîãî àòðèáóòà áóäåò îáíóëåíî.  ñëó÷àå âûïîëíåíèå çàïðîñà, ïåðåñåêàþùåãî íåñêîëüêî àðõèâàòîðîâ, âûïîëíÿåòñÿ îáðàáîòêà òîëüêî ïåðâîãî àðõèâàòîðà ñ óêàçàíèåì åãî èìåíè è ðàçìåðíîñòè â ñîîòâåòñòâóþùèõ àòðèáóòàõ. Äëÿ çàïðîñà äàííûõ ïîñëåäóþùèõ àðõèâàòîðîâ çàïðîñ ïîâòîðÿåòñÿ îòòàëêèâàÿñü îò ðàçìåðíîñòè ïðåäûäóùåãî çàïðîñà.
mode Óñòàíîâêà è êîíòðîëü ðåæèìà ïåðåäà÷è äàííûõ àðõèâà

Óêàçûâàåòñÿ ôîðìà, â êîòîðîé æåëàòåëüíî ïîëó÷àòü äàííûå àðõèâà. Ïðåäóñìàòðèâàþòñÿ ñëåäóþùèå ðåæèìû/ôîðìû ïåðåäà÷è äàííûõ àðõèâîâ:

0 -- Ïðîñòàÿ çàïèñü: îäíî çíà÷åíèå - îäíà ñòðîêà áåç óïàêîâêè ñìåæíûõ çíà÷åíèé.  ñëó÷àå àðõèâà ñòðîê çíà÷åíèÿ êîäèðóþòñÿ íà ïðåäìåò èñêëþ÷åíèÿ ñèìâîëîâ ïåðåâîäà ñòðîêè. Ïðèìåð ôîðìû çàïèñè:
34.5678
23.6543
65.8754
34.6523

1 -- Óïàêîâàííàÿ çàïèñü ïî ïðèíöèïó ñâîðà÷èâàíèÿ ñìåæíûõ çíà÷åíèé: îäíî çíà÷åíèå - îäíà çàïèñü. Ïåðåä êàæäûì çíà÷åíèåì óêàçûâàåòñÿ åãî ïîçèöèîííûé íîìåð, îòäåë¸ííûé ïðîáåëîì:

0 34.5678
1 23.6543
4 65.8754
6 34.6523

2 -- Ìàññèâ áèíàðíûõ íåóïàêîâàííûõ çíà÷åíèé, êîäèðîâàííûé Mime Base64. Íå ìîæåò áûòü èñïîëüçîâàí äëÿ ñòðîêîâûõ àðõèâîâ.
real_prec Óñòàíîâêà òî÷íîñòè âåùåñòâåííûõ ÷èñåë Óêàçûâàåò, ñ êàêîé òî÷íîñòüþ ïåðåäàâàòü äàííûå çíà÷åíèé âåùåñòâåííîãî òèïà â ðåæèìå "0" è "1". Ïî óìîë÷àíèþ ýòà òî÷íîñòü ñîñòàâëÿåò 6 çíà÷àùèõ öèôð.
round_perc Óñòàíîâêà ïðîöåíòà îêðóãëåíèÿ Óêàçûâàåò ïðîöåíò îêðóãëåíèÿ ñìåæíûõ ÷èñëîâûõ çíà÷åíèé, äëÿ ðåæèìà "1".

 
There are no files on this page.[Display files/form]
There is no comment on this page. [Display comments/form]
2009-11-17 09:36:49 | Owner: Roman Savochenko | Print version | Search: