Promotic
WikipediaLinkedInYoutubeTwitterFacebook

Acknowledge - metoda objektu PmAlarmEventItem

Popis:
Kvitace alarm položky.
Syntaxe:
Acknowledge([sUserNote As String], [tTimeAck As Date], [sExtra As String])
Volání:
oAlEvItem.Acknowledge sUserNote, tTimeAck
Parametry:
sUserNote[nepovinné] (String) Textová poznámka, která se uloží do dat společně s kvitovanou alarm/event položkou (povoluje se v záložce Uložení).
tTimeAck[nepovinné] (Date) Čas kvitace alarmu. Pokud není nastaveno, pak se použije aktuální čas počítače.
sExtra[nepovinné] (String) Dodatečné parametry metody.

Údaje jsou zde ve formátu PmNamedValues, například "ackerid:operator1;lang:en;".

"ackerid:xx;" - Identifikátor uživatele, který provedl kvitaci alarmu. Tento identifikátor se nastaví do vlastnosti AckerId příslušného alarmu a bude také zapsán na disk do sloupce AckerId (pokud je tento sloupec pro zápis na disk povolen). Pokud se parametr neuvede, pak se použije identifikátor uživatele, který kvitaci provedl (lokálně lokální uživatel, na Webu síťový uživatel). Například"ackerid:operator1;".
"lang:xx;" - Určení národního jazyka pro Makro výraz $.text. Jazyk je určen textovým identifikátorem, např. "cs", "sk", "en" atd. - viz Jazyky s plnou podporou v systému PROMOTIC. Pokud není nastaveno, pak se použije právě aktuální jazyk spuštěné aplikace. Má význam při hromadné kvitaci se zapnutým filtračním řetězcem (např. $all;area:boiler1;), kde je možno ovlivnit jazyk pro vyhodnocení lokalizovaných polí. Například"lang:en;".
Poznámka:
Kvitace se povede pouze tehdy, má-li lokální uživatel oprávnění Acknowledge.

Volání metody Acknowledge nad kvitovaným alarmem nemá žádný účinek. Nekvitovaný alarm se kvituje. Chování alarmu při kvitaci určuje konfigurátor Typ kvitace. Kvitaci alarmu zpravidla provádí interaktivně uživatel aplikace z prohlížeče alarmní skupiny.

Pro eventy nemá smysl (pouze pro alarmy).

Metoda je synchronní, tzn. že alarmní subsystém ji ihned vykoná. Nicméně vlastní zápis na disk do historie alarmů/eventů je asynchronní, to znamená, že že tato metoda předá alarmnímu subsystému požadavek na zápis do historie, ten je zařazen do fronty požadavků a alarmní subsystém jej později vykoná.

Příklad:
Dim oAlItem
Set oAlItem = oAlEv.Item("Teplota")
oAlItem.Acknowledge "UserNote"
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice