| pMe | (Object) Reference na PmaReport objekt, ve kterém daná událost vzniká. |
|---|---|
| pEvent | (Object) Reference na objekt, který popisuje informace o dané události.
pEvent.Context - (Object) [pro čtení] Obsahuje referenci na objekt s dodatečnými informacemi o kontextu volání (např. uživatel).
pEvent.Context.User - (Object) vlastnost s referencí na objekt PmUser, ve kterém jsou podrobnější informace o uživateli (lokálním nebo síťovém), který metodu zavolal. Lze použít například:
- ke chránění metody na konkrétního přihlášeného uživatele nebo skupinu uživatelů.
- pro ukládání a čtení stavových privátních dat uživatele pomocí metod SetPrivateData a GetPrivateData.
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 - (String) vrací informaci o požadovaném národním jazyce, ve kterém jsou požadovány případné textové výstupy metody (vhodné zejména při volání metody z Web obrazů). Jazyk je určen textovým identifikátorem, např. "cs", "sk", "en" atd. - viz Jazyky s plnou podporou v systému PROMOTIC. pEvent.Pars - (Object) [pro čtení] Obsahuje referenci na objekt s dodatečnými parametry reportu, dodaných při otevření prohlížeče (viz Výchozí hodnota sViewPars nebo Otevření prohlížeče objektu PmaReport). Každý jednotlivý parametr je tvořen identifikátorem (název) a hodnotou. Těmito parametry lze parametrizovat obsah reportu (aktualizace) při otevření prohlížeče. Jednak lze na základě těchto parametrů parametrizovat načítaná data v události onReportRequest a také lze hodnoty těchto parametrů předávat přímo do reportu v podobě klíčových slov.
K jednotlivým parametrům lze přistupovat pomocí následujících metod tohoto objektu: pEvent.Pars.GetValueAt - Syntaxe: String GetValueAt(String sId). Metoda umožňuje získat hodnotu jednoho parametru podle jeho identifikátoru (jména).
Pokud daný parametr neexistuje, pak metoda vrací: null pro JavaScript nebo Empty pro VBScript (lze testovat metodou Pm.IsValid). pEvent.Modify - (Long) [pro čtení i zápis] Výstupní hodnota indikující, zda došlo k aktualizaci klíčových hodnot nebo souboru se vzorem a zda má být report znovu vytvořen (viz metoda MakeReport).
0 - Nedošlo ke změně, výsledný report se nebude znovu vytvářet (použije se report z cache objektu PmaReport).
1 - Došlo ke změně, výsledný report se musí znovu vytvořit. |
pEvent.Modify = 1;
pMe.SetKeyValue("kPar1", pEvent.Pars.GetValueAt("par1"));
pMe.SetKeyValue("kPar2", pEvent.Pars.GetValueAt("par2"));