- Vytvoril D2000 Dev Team na okt 12, 2017
Funkcia %HI_SetLogDBByMask
Funkcia
Funkcia %HI_SetLogDBByMask nastaví parametre pre zobrazenie údajov z monitorovacej databázy v
zobrazovači Monitorovanie (riadiaca funkcia).
Deklarácia
%HI_SetLogDBByMask( INT in refId, TEXT in mask, TEXT in skupinaMask, INT in priorityMask, BOOL in bASC, INT in pageLen, INT in intervalType [, HBJ in refToLG1, ...] )
alebo
%HI_SetLogDBByMask( INT in refId, TEXT in mask, TEXT in skupinaMask, INT in priorityMask, BOOL in bASC, INT in pageLen, TIME in bt, TIME in et [, HBJ in refToLG1, ....] )
Parametre
| refId | Referenčná premenná zobrazovača typu Monitorovanie. |
| mask | Maska (v okne pre nastavenie parametrov monitorovania). |
| skupinaMask | Filter pre zdroj udalostí. |
| priorityMask | Filter pre Typ udalosti. |
| bASC | Usporiadanie:
|
| pageLen | Veľkosť stránky v rozsahu 5 ... 200. |
| intervalType | Časový interval prezeraných udalostí. Možné hodnoty:
|
| bt | Počiatočný čas (pri definovaní iného čas. intervalu než umožňuje definovať parameter intervalType). |
| et | Koncový čas (pri definovaní iného čas. intervalu než umožňuje definovať parameter intervalType). |
| refToLG1, ... | Odkazy na logické skupiny. |
Popis
Parametre funkcie kopírujú chovanie príslušného
dialógu pre otvorenie monitorovacej databázy pri prezeraní udalostí
pre objekty vyhovujúce danej maske.
Parameter skupinaMask predstavuje filter pre zdroj udalosti. Musí byť rôzny od 0 a musí vzniknúť súčtom hodnôt preddefinovaných premenných _LOGF_PRTY_*.
Parameter priorityMask predstavuje filter pre Typ udalosti. Musí byť rôzny od 0 a musí vzniknúť súčtom hodnôt preddefinovaných premenných _LOG_PRTY_*.
Celočíselným parametrom intervalType je možné riadiť časový rozsah prezeraných udalostí v zmysle dialógu pre otvorenie monitorovacej databázy. Iný časový interval je možné zadať použitím parametrov bt a et.
Objekty vyhovujúce výberovej podmienke mask je možné ďalej filtrovať na základe ich príslušnosti k logickej skupine pomocou nepovinných parametrov refLG1, refLG2, .... Tieto parametre sú odkazy na príslušné logické skupiny.
Parameter skupinaMask predstavuje filter pre zdroj udalosti. Musí byť rôzny od 0 a musí vzniknúť súčtom hodnôt preddefinovaných premenných _LOGF_PRTY_*.
Parameter priorityMask predstavuje filter pre Typ udalosti. Musí byť rôzny od 0 a musí vzniknúť súčtom hodnôt preddefinovaných premenných _LOG_PRTY_*.
Celočíselným parametrom intervalType je možné riadiť časový rozsah prezeraných udalostí v zmysle dialógu pre otvorenie monitorovacej databázy. Iný časový interval je možné zadať použitím parametrov bt a et.
Objekty vyhovujúce výberovej podmienke mask je možné ďalej filtrovať na základe ich príslušnosti k logickej skupine pomocou nepovinných parametrov refLG1, refLG2, .... Tieto parametre sú odkazy na príslušné logické skupiny.
Príklad
%HI_SetLogDBByMask(_zobrazovac, "*s*", _LOGF_LOGONLOGOFF, _LOG_PRTY_INFO, @TRUE, 20, 8, AI_1_KB03\HBJ)
Poznámka
Parameter mask môže byť nahradený obsahom XML súboru, ktorý reprezentuje rozšírený filter. Ten umožňuje filtrovať cez všetky textové stĺpce v monitorovacej DB.
V ROOT elemente sú obalené názvy stĺpcov spolu s filtračnými podmienkami. Každý element, reprezentujúci filtračnú podmienku, môže ešte obsahovať atribút strict. Tento atribút určuje, či je filtrovanie cez daný stĺpec striktne požadované.
V ROOT elemente sú obalené názvy stĺpcov spolu s filtračnými podmienkami. Každý element, reprezentujúci filtračnú podmienku, môže ešte obsahovať atribút strict. Tento atribút určuje, či je filtrovanie cez daný stĺpec striktne požadované.
Pre elementy, reprezentujúce filtračné podmienky, platia tieto pravidlá:
- rezervované elementy sú: name, descript, person, oldvalue, newvalue alebo comment,
- iné ako rezervované elementy sa nesmú vyskytovať v ROOT elemente,
- každý rezervovaný element sa môže vyskytovať najviac raz,
- ak sa daný rezervovaný element v XML súbore nevyskytuje, nie je súčasťou filtra,
- ak pre element nie je definovaný atribút strict, alebo má inú hodnotu ako "off", potom je vždy nastavený na "on",
- záznamy musia vyhovovať všetkým elementom s nastaveným atribútom strict na "on" a súčasne aspoň jednému elementu s nastaveným atribútom strict na "off" (ak existuje),
- filtračná podmienka zadaná v elemente povoľuje tú istú syntax ako maska.
<?xml version="1.0" encoding="utf-8" ?>
<ROOT>
<name strict="on">!TF2\.<\name>
<descript strict="off">SystemD2000*<\descript>
<oldvalue strict="off">Run<\oldvalue>
<\ROOT>
je možné vyskladať pomocou tohto príkladu.
0 komentárov