Promotic
WikipediaLinkedInYoutubeTwitterFacebook

Otevření prohlížeče objektu PmaEventGroup

Prohlížeč tohoto objektu se otevírá metodou Pm.CreateView, kde v parametru sViewPath se zadá cesta k tomuto objektu.
 
Objekt PmaEventGroup implementuje jediný prohlížeč:
- /#history : (Přednastaveno) Prohlížeč eventů (historie).
 
Vlastní prohlížeč historie je realizován pomocí předkonfigurovaného obrazu PmaPanel. Tento obraz je zaregistrován v objektu PmaEventGroup.

Při vlastním otevírání prohlížeče objektu PmaEventGroup dojde interně k přesměrování na příslušný zaregistrovaný obraz. Viz Prohlížení alarmů/eventů.

Syntaxe:
JavaScriptVyber a zkopíruj do schránky

var oCreator = Pm.CreateView(oFrom, sViewPath, sView, sFrame);
oCreator.Open();
Parametry prohlížeče:
oFrom(Object) Objekt, který zprostředkuje otevření prohlížeče. Může se jednat o PmaPanel, PmgFrame nebo PmaWorkspace. Objekt určuje odkud hledat cestu, vůči komu pozicovat okno, kdo bude rodičem, atd.

Hodnota null znamená, že se použije aktivní pracovní plocha (Pm.GetActiveWorkspace).

Viz vlastnost PmViewCreator.From.

sViewPath(String) Cesta (relativní nebo absolutní) k objektu nebo komponentě, jehož prohlížeč má být otevřen.

Viz vlastnost PmViewCreator.ViewPath.

sView(String) Parametry prohlížeče (liší se u jednotlivých typů prohlížečů)

Údaje jsou zde ve formátu KeyVal, například "název1:hodnota1;název2:hodnota2;".

Viz vlastnost PmViewCreator.View.

 
Parametry prohlížeče:
pars[nepovinné] (PmMap) Prohlížečem je ve skutečnosti předkonfigurovaný obraz PmaPanel, proto jsou všechny parametry prohlížeče obsaženy v parametru pars. Předkonfigurovaný obraz PmaPanel prohlížeče historie pracuje s následujícími parametry.
filter (nepovinné) - Filtrační řetězec typu KeyVal.

Pokud se neuvede, pak budou zobrazeny všechny položky dané skupiny.

Pro snadné vytvoření/nastavení vnořené mapy (Submap) v položce jiné mapy, lze použít metodu PmMap.mapSetSubmapAt. Tato metoda zajistí, že v dané položce bude vnořená mapa a do této mapy navíc umí hromadně přidat položky z řetězce v syntaxi KeyVal.

grouppath (nepovinné) - Cesta k objektu PmaEventGroup.

Pokud se cesta neuvede, pak je tento parametr doplněn při přesměrování otevření z eventové skupiny na zaregistrovaný obraz prohlížeče.

Arguments[nepovinné] (Variant) () Hodnota předávaná otevíranému prohlížeči obrazu. Tato hodnota může být jednoduchá (Integer, String, ...), pole nebo objekt typu PmArray nebo PmMap (nedoporučuje se zde předávat jiné typy objektů).
Tato hodnota je pak dostupná:
- v události onOpen
- v objektu PmaPanel pomocí vlastnosti PmgRoot.Arguments
onOpen[nepovinné] (Function) Událostní funkce která se vyvolá při otevření prohlížeče.

Pro JavaScript se zde zadává function.

Pro VBScript se zde zadává objekt PmAction.

Funkce má jeden parametr ev obsahující informace o dané události.

ev.Arguments - (Variant) Vstupní hodnota prohlížeče. Viz Arguments.
onClose[nepovinné] (Function) Událostní funkce pro obsloužení události zavření prohlížeče.

Pro JavaScript se zde zadává function.

Pro VBScript se zde zadává objekt PmAction.

Funkce má jeden parametr ev obsahující informace o dané události.

ev.CloseReason - (String) Identifikátor typu zavření okna. Viz parametr sReason v metodě PmgRoot.Close.
ev.ReturnValue - (Variant) Výstupní hodnota prohlížeče. Viz PmgRoot.ReturnValue.
sFrame(String) Parametry pro rámec (frame), ve kterém bude zobrazen prohlížeč

Údaje jsou zde ve formátu KeyVal, například "target:_blank;".

Viz vlastnost PmViewCreator.Frame.

Parametry prohlížeče jsou v podobě objektu PmMap, který je naplněn z hodnoty parametru sView (typu KeyVal) v metodě Pm.CreateView.

Naplněním z KeyVal hodnoty jsou všechny parametry na počátku uložené jako řetězec. Obsah objektu PmMap však může být libovolně měněn, položky lze přidávat, mazat nebo měnit jejich hodnotu.

Objekt PmMap může obsahovat jiné vnořené objekty PmMap. Ke zpřístupnění existující nebo založení nové položky typu PmMap lze využít metodu PmMap.mapSetSubmapAt.

Příklad2:
Otevření prohlížeče historie eventů (s výchozím nastavením) v pojmenovaném nezávislém okně
JavaScriptVyber a zkopíruj do schránky

var oCreator = Pm.CreateView(pMe.PmPanel, "/Eventy/#history", "", "target:_blank.events");
oCreator.Open();
Příklad3:
Otevření prohlížeče historie eventů s předáním filtračního parametru v pojmenovaném nezávislém okně
JavaScriptVyber a zkopíruj do schránky

var oCreator = Pm.CreateView(pMe.PmPanel, "/Eventy/#history", "pars:{filter:{desc:#eq:Boil;}};", "target:_blank.events");
oCreator.Open();
Příklad4:
Otevření prohlížeče historie eventů s předáním cesty ke grouppath
JavaScriptVyber a zkopíruj do schránky

var oCreator = Pm.CreateView(pMe.PmPanel, "../EventHistory", "pars:{grouppath:../Events;};", "target:_blank.events");
oCreator.Open();

Historie:
Pm9.00.09: Vytvořeno
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice