| pMe | (Object) Odniesienie do PmaReport obiektu, w którym dane zdarzenie powstaje. |
|---|---|
| pEvent | (Object) Odniesienie do obiektu zawierającego ściślejsze informacje o danym zdarzeniu.
pEvent.Context - (Object) [do odczytu] Zawiera odniesienie do obiektu z dodatkowymi parametrami dotyczącymi kontekstu wywołania (np. użytkownik).
pEvent.Context.User - (Object) właściwość z odniesieniem do obiektu PmUser, w którym znajdują się szczegółowe informacje o użytkownikowi (lokalnym lub sieciowym), który wywołał metodę. Można zastosować na przykład:
- do zabezpieczenia metody dla konkretnego zalogowanego użytkownika lub dla grupy użytkowników.
- do przechowania i odczytu prywatnych danych użytkownika przy pomocy metod SetPrivateData oraz GetPrivateData.
Uwaga! Żeby w podobiekcie User znalazła się wiarygodna wartość jest konieczne, żeby w odpowiednim uprawnieniu WebRead nie bzůo pseudo grup $ANY oraz $ANY_NET (tzn. żeby przy otworzeniu strony Webowej użytkownik musiał być zalogowany). pEvent.Context.Language - (String) zwraca informację owymaganym języku narodowym, w którym są wymagane ewentualne wyjścia tekstowe metody (odpowiednie zwłaszcza przy wywołaniu metody z Web paneli). Język jest określony przez identyfikator tekstowy, np. "pl", "en", "cs" itd. - patrz Języki z pełnym wsparciem w systemie PROMOTIC. pEvent.Pars - (Object) [do odczytu] zawiera odniesienie do obiektu z dodatkowymi parametrami raportu, dostarczonymi przy otwarciu przeglądarki (patrz Wartość domyślna sViewPars lub Otwarcie przeglądarki obiektu PmaReport). Każdy poszczególny parametr jest tworzony przez identyfikator (nazwa) i przez wartość. Przy pomocy tych parametrów można wpływać na zawartość raportu (aktualizacja) podczas otwarcia przeglądarki. Na podstawie tych parametrów można określać dane wczytane we właściwym zdarzeniu onReportRequest poza tym można wartości tych parametrów przekazywać bezpośrednio do raportu w formie słów kluczowych.
Z poszczególnymi parametrami można pracować przy pomocy następujących metod tego obiektu: pEvent.Pars.GetValueAt - Składnia: String GetValueAt(String sId). Metoda umożliwia uzyskanie wartości jednego parametru według jego identyfikatora (nazwy).
Jeżeli dany parametr nie istnieje, wtedy metoda zwraca: null dla JavaScript lub Empty pro VBScript (można sprawdzić przy pomocy metody Pm.IsValid). pEvent.Modify - (Long) [do odczytu i zapisu] Wyjściowa metoda, wskazująca, czy doszło do aktualizacji kluczowych wartości lub pliku z szablonem i czy raport ma zostać ponownie wytworzony (patrz metoda MakeReport).
0 - Nie doszło do zmiany, raport końcowy nie będzie ponownie wytwarzany (zostanie zastosowany raport z cache obiektu PmaReport).
1 - Doszło do zmiany, końcowy raport trzeba ponownie wytworzyć. |
pEvent.Modify = 1;
pMe.SetKeyValue("kPar1", pEvent.Pars.GetValueAt("par1"));
pMe.SetKeyValue("kPar2", pEvent.Pars.GetValueAt("par2"));