Promotic
WikipediaLinkedInYoutubeTwitterFacebook

ActivateNew - metoda objektu PmaAlarmGroup

Popis:
Dynamické vytvoření nové alarm položky (objektu PmAlarmItem) v aktivním a nekvitovaném stavu (červená) nebo aktivace již existující položky. Metoda vrací příslušnou alarm položku. Tuto referenci lze získat i voláním metody Item.
Syntaxe:
Object ActivateNew(String sId, String sIdCopy, [String sSource], [String sDesc], [String sComment], [Date sTimeOn], [Long nAttr])
Volání:
oAl.ActivateNew sId, sIdCopy, sSource, sDesc, sComment, tTimeOn, nAttr
Parametry:
sId(String) Jednoznačný textový identifikátor nové alarm položky. Tento identifikátor se pak využívá při volání metod například: Activate, Inactivate, Acknowledge, Item, atd.
sIdCopy(String) Jednoznačný textový identifikátor alarm položky typu vzor (viz konfigurátor "Vzor pro dynamicky vytvářené položky"), jejíž konfigurace se použije.
sSource[nepovinné] (String) Označení zdroje alarm položky. Umožňuje uživateli třídit a filtrovat alarm položky v prohlížeči v běžící aplikaci podle zadaného zdroje. Pokud není nastaveno, pak se použije hodnota se vzoru.
sDesc[nepovinné] (String) Vlastní popis alarm položky. Základní text alarm položky, který je zobrazen v prohlížeči v běžící aplikaci. Pokud není nastaveno, pak se použije hodnota se vzoru.
sComment[nepovinné] (String) Textový komentář, který se uloží do dat společně s aktivovanou alarm položkou (povoluje se v záložce "Uložení").
sTimeOn[nepovinné] (Date) Čas aktivace alarm položky. Pokud není nastaveno, pak se použije aktuální čas počítače.
nAttr[nepovinné] (Long) Atributy, které upřesňují chování příkazu při existenci/neexistenci alarm položky.
0 (přednastaveno) - Při existenci alarm položky se zadaným identifikátorem, příkaz provede aktivaci nad existující alarm položkou. Při neexistenci alarm položky se zadaným identifikátorem, příkaz vytváří novou alarm položku s následnou aktivací.
1 - Při existenci alarm položky se zadaným idenitifikátorem, příkaz selže. Při neexistenci alarm položky se zadaným idenitifikátorem, příkaz vytváří novou alarm položku s následnou aktivací.
Vrácená hodnota:
Vrací nově vytvořenou (nebo existující) a aktivovanou alarm položku typu PmAlarmItem. V případě chyby vrací hodnotu null pro JavaScript nebo Nothing pro VBScript (pravděpodobně již existuje alarm položka se zadaným Id). Hodnotu Nothing lze testovat VBScript operátorem Is.
Viz také:
Příklad:
JavaScriptVBScriptVyber a zkopíruj do schránky

oAl.ActivateNew("T1_HI", "HI", "Kotel", "T1 over high limit", "Teplota");
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice