Předem upozorňujeme, že to není tak, že každý takový objekt má například metodu pro zobrazení svého obsahu (na první pohled by to vypadalo logicky ale zjistilo se, že to není praktické), nýbrž někde jinde se oznámí "chci otevřít prohlížeč objektu", přičemž se v parametru sObjectPath zadá cesta k tomuto objektu.
Sada těchto metod umožní otevřít libovolný prohlížeč v rámci objektu PmaWorkspace, v objektu PmgFrame nebo také v podobě samostatného okna. Metoda je z důvodu praktičnosti implementována do několika objektů:
Metoda je asynchronní, tzn. pouze aktivuje otevření příslušného prohlížeče (případně zavření předcházejího) ale po ukončení metody ještě nemusí být prohlížeč skutečně otevřen.
Upozornění! Otevřít libovolný prohlížeč v objektu PmgFrame lze pouze metodou PmgFrame.OpenView.
Údaje jsou zde ve formátu KeyVal, například "target:_blank;modal:1;".
V tom případě dochází ke zkombinování údajů ze statického výchozího nastavení objektu s údaji předanými dynamicky. Pokud je stejný údaj uveden na obou místech, pak přednost dostane dynamický údaj, dodaný při otevření prohlížeče.
Tato pozice je jen doporučená. Pokud okno se svou velikostí nevejde na obrazovku, pak se tato pozice posune tak, aby byla viditelná co největší část tohoto okna.
Pozice se zde stanovuje relativně k obsahu okna (view) a ne k oknu samotnému (frame). Lze tak například nové okno umístit vedle Pmg objektu, ze kterého je okno otevíráno. Viz Příklad otevření okna s umístěním podle Pmg objektu.
Údaje jsou zde ve formátu KeyVal, například "název1:hodnota1;název2:hodnota2;".
Tyto údaje obvykle parametrizují nebo filtrují vlastní obsah objektu pro zobrazení a závisí na typu otevíraného objektu.
Statické výchozí hodnoty parametrů sParams lze nastavit v konfigurátoru "PmaPanel > Obraz > Výchozí hodnota sParams". V tom případě dochází ke zkombinování údajů ze statického výchozího nastavení objektu s údaji předanými dynamicky. Pokud je stejný údaj uveden na obou místech, pak přednost dostane dynamický údaj, dodaný při otevření prohlížeče.
Každý jednotlivý parametr je tvořen identifikátorem a hodnotou.
Syntaxe: "par:name1=value1;par:name2=value2; ...".
Statické výchozí hodnoty parametrů sParams lze nastavit v konfigurátoru "PmaReport > Report > Výchozí hodnota sParams". V tom případě dochází ke zkombinování údajů ze statického výchozího nastavení objektu s údaji předanými dynamicky. Pokud je stejný údaj uveden na obou místech, pak přednost dostane dynamický údaj, dodaný při otevření prohlížeče.
Pokud je soubor v podsložce, pak se musí parametr file zadat v podobě "podsložka/soubor".
Pokud parametr file není uveden, pak se otevře soubor "default.htm" a pokud takový soubor neexistuje, pak se otevře dynamicky vytvořená HTML stránka se seznamem souborů.
Adresu je nutno uvádět v plném tvaru včetně protokolu: (http://, https:// nebo file://).
Různá filtrační pole mohou být použita i zároveň, alarm potom musí vyhovavat všem (např. "desc:FIQ100;priority.ge:5;").
Filtrační text xx nesmí být prázdný řetězec (např. nelze zadat "desc:;").
Údaje jsou zde ve formátu KeyVal, například "desc:Test2;records:50;".
Existují následující druhy filtračních textů ("field" představuje některý sloupec alarmů):
Poznámka! Pokud pole začíná textem s., pak se jedná o volbu skrytou koncovému uživateli v alarm prohlížeči a slouží k nastavení pevné filtrace skriptem bez ohledu na nastavení uživatelské části filtru. Pro stejný sloupec lze použít oba typy filtračních polí současně. Aby alarm vyhověl, musí vyhovět oběma filtračním polím. Toho lze s výhodou využít k nastavení pevné filtrace skriptem (neovlivnitelné koncovým uživatelem) a současně nastavit i počáteční stav uživatelské filtrace (měnitelnou koncovým uživatelem). Například s.source:#begin:Kotel;source:Kotel1;.
Časový rozsah lze zadat jako celé číslo následované znakem časové jednotky (bez mezery). Časové jednotky jsou: w = týden, d = den, h = hodina, m = minuta, s = sekunda. Například timerange:12h; nebo timerange:90m;.
Objekt se vytváří metodou Pm.CreatePmMap.
var oExtra = Pm.CreatePmMap();
oExtra.Arguments = 3.14;
oExtra.onClose = Pm.CreatePmAction(1, pMe, "ClosePanel");
pMe.PmPanel.OpenView("/Kotel/Panel", "target:_blank;", "", oExtra);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ů).
Zadání této hodnoty je často důležité například při otevírání modálniho okna, které má sloužit pro editování údajů.
Vlastnost Arguments pak slouží jako vstupní inicializační hodnota (vlastnost ReturnValue jako výstupní upravená hodnota) - viz Jak pracovat s modálními okny.
Při prohlížení objektu PmForm (tzn. pokud je zadáno sObjectPath="/#glob/form") se tato hodnota nastavuje na dynamicky vytvořený a nakonfigurovaný objekt PmForm. Viz Postup vytvoření formuláře.
Pro jiné typy prohlížečů tato hodnota nemá využití.
Objekt pro tuto vlastnost se vytváří metodou Pm.CreatePmAction.
Tato metoda projektanta musí mít dva parametry:
Objekt pro tuto vlastnost se vytváří metodou Pm.CreatePmAction.
Tato metoda projektanta musí mít dva parametry:
Objekt pro tuto vlastnost se vytváří metodou Pm.CreatePmAction.
Toto je funkční pouze pokud zobrazovaný objekt je PmForm.
Tato metoda projektanta musí mít dva parametry:
OpenViewModal metoda se nyní považuje za zastaralou - tato metoda je totiž "synchronní", tzn. při zavolání čeká skript na ukončení tohoto okna a teprve pak pokračuje dále. Tento přístup však není funkční v mnoha Web prohlížečích a z hlediska běhu skriptu je nekoncepční.
Nový typ otevírání modálního okna metodou OpenView (s nastaveným údajem modal:1;) otevře okno modálně ale skript pokračuje dál. Až je modální okno zavřeno, vyvolá se metoda projektanta, která byla zadána v údaji oExtra.onClose
Viz Jak pracovat s modálními okny.