onUserItemAction - událost objektu PmaAlarmGroup

Popis:

Událost je vyvolána při zvolení příslušné akce lokálním/síťovým uživatelem v prohlížeči stavu.

Parametry:

pMe	(Object) Reference na PmaAlarmGroup objekt, ve kterém daná událost vzniká.
pEvent	(Object) Reference na objekt popisující podrobněji informace o dané události. pEvent.Action - (String) Určuje zvolenou akci nad alarm položkou. ack - Uživatel zvolil kvitaci vybrané alarm položky v prohlížeči stavu. ackall - Uživatel zvolil kvitaci všech alarm položek v prohlížeči stavu. pEvent.ItemId - (String) Identifikátor vybrané alarm položky (pokud se nejedná o hromadnou operaci). pEvent.TimeOn - (Date) Čas vzniku vybrané alarm položky (pokud se nejedná o hromadnou operaci). Jedná se o doplňkovou informaci k identifikátoru alarm položky, umožňující jednoznačnou identifikaci vybrané alarm položky. Pokud je v konfigurátoru "Počet neaktivních, nekvitovaných alarmů (modrých)" povoleno uchovávat neaktivní, nekvitované (modré) alarmy, pak může existovat více alarm položek se stejným identifikátorem. pEvent.Context - (Object) Reference na objekt s dodatečnými informacemi o uživateli, který provedl akci s následným vyvoláním této události. Vznik a zánik alarmu je vyvolán vždy lokálním uživatelem. Kvitace alarmu může být vyvolána jak lokálním uživatelem z lokální aplikace nebo síťovým uživatelem ze vzdáleného klienta (např. Web). Informaci o uživateli lze použít například buď k povolení/zakázaní akce (pokud to jde) nebo k zapsání informace o uživateli do alarmů/eventů. pEvent.Context.User - Reference na objekt PmUser, ve kterém jsou podrobnější informace o uživateli (lokálním nebo síťovém), který provedl akci s následným vyvoláním této události. Upozornění! Aby v podobjektu User byla věrohodná hodnota je nutno, aby v příslušném oprávnění "WebRead" nebyly pseudo skupiny $ANY a $ANY_NET (tzn. aby při otevření Web stránky musel být přihlášen uživatel). pEvent.Context.Language - Vrací informaci o požadovaném národním jazyce. Jazyk je určen textovým identifikátorem, např. "cs", "sk", "en" atd. - viz Jazyky s plnou podporou v systému PROMOTIC. Viz konfigurátor "PmaRoot > Aplikace > Hlavní jazyk runtime". pEvent.Enabled - (Boolean) Určuje, zda se nad vybranou alarm položkou požadovaná akce provede nebo ne. true (přednastaveno) - Alarm systém provede zvolenou akci nad vybranou alarm položkou. false - Alarm systém neprovede zvolenou akci nad vybranou alarm položkou.

pMe

(Object) Reference na PmaAlarmGroup objekt, ve kterém daná událost vzniká.

pEvent

(Object) Reference na objekt popisující podrobněji informace o dané události.

pEvent.Action - (String) Určuje zvolenou akci nad alarm položkou.

ack - Uživatel zvolil kvitaci vybrané alarm položky v prohlížeči stavu.

ackall - Uživatel zvolil kvitaci všech alarm položek v prohlížeči stavu.

pEvent.ItemId - (String) Identifikátor vybrané alarm položky (pokud se nejedná o hromadnou operaci).

pEvent.TimeOn - (Date) Čas vzniku vybrané alarm položky (pokud se nejedná o hromadnou operaci). Jedná se o doplňkovou informaci k identifikátoru alarm položky, umožňující jednoznačnou identifikaci vybrané alarm položky. Pokud je v konfigurátoru "Počet neaktivních, nekvitovaných alarmů (modrých)" povoleno uchovávat neaktivní, nekvitované (modré) alarmy, pak může existovat více alarm položek se stejným identifikátorem.

pEvent.Context - (Object) Reference na objekt s dodatečnými informacemi o uživateli, který provedl akci s následným vyvoláním této události. Vznik a zánik alarmu je vyvolán vždy lokálním uživatelem. Kvitace alarmu může být vyvolána jak lokálním uživatelem z lokální aplikace nebo síťovým uživatelem ze vzdáleného klienta (např. Web). Informaci o uživateli lze použít například buď k povolení/zakázaní akce (pokud to jde) nebo k zapsání informace o uživateli do alarmů/eventů.

pEvent.Context.User - Reference na objekt PmUser, ve kterém jsou podrobnější informace o uživateli (lokálním nebo síťovém), který provedl akci s následným vyvoláním této události.

Upozornění! Aby v podobjektu User byla věrohodná hodnota je nutno, aby v příslušném oprávnění "WebRead" nebyly pseudo skupiny $ANY a $ANY_NET (tzn. aby při otevření Web stránky musel být přihlášen uživatel).

pEvent.Context.Language - Vrací informaci o požadovaném národním jazyce. Jazyk je určen textovým identifikátorem, např. "cs", "sk", "en" atd. - viz Jazyky s plnou podporou v systému PROMOTIC. Viz konfigurátor "PmaRoot > Aplikace > Hlavní jazyk runtime".

pEvent.Enabled - (Boolean) Určuje, zda se nad vybranou alarm položkou požadovaná akce provede nebo ne.

true (přednastaveno) - Alarm systém provede zvolenou akci nad vybranou alarm položkou.

false - Alarm systém neprovede zvolenou akci nad vybranou alarm položkou.

Viz také:

- onStateChange

Příklad:

Do položky Debug_info INFO systému vypíšeme každou změnu každé položky spojenou s přihlášeným uživatelem:

JavaScriptVBScriptVyber a zkopíruj do schránky


Pm.Debug("Alarm - Action=" + pEvent.Action + ", itemId=" + pEvent.ItemId + ", -> user=" + pEvent.Context.User.Id + ", Time=" + Now());

Získá název kvitované položky objektu PmaData mající Datová rozšíření ExtAlarmBinary. A jméno přihlášeného uživatele, který tuto alarm položku kvitoval.

JavaScriptVBScriptVyber a zkopíruj do schránky


var sVarName, sUserName;
var oItem = pMe.Item(pEvent.ItemId);
var oExt = oItem.Extension();

if (oExt && oExt.ClassName == "ExtAlarmBinary")
{
	sVarName = oExt.Var.Name;
	sUserName = pEvent.Context.User.Name;
}