Příklad použití: Představme si složku PmaFolder, která představuje nějaké zařízení (např. Kotel). Někdy je nutno odstavit tento Kotel z jiné složky. Lze to dělat tak, že v jiné složce bude podrobný algoritmus jak odstavit Kotel ale daleko lepší je vytvořit metodu přímo v objektu "Kotel", ve které bude algoritmus pro odstávku. Z jiné složky se pak zavola pouze tato metoda.
pMe | (Object) Reference na Pma objekt, ve kterém je metoda definována. |
---|---|
pResult | [jen pro zápis] (Variant) Výstupní parametr, který slouží ke vrácení výsledné hodnoty metody. Je dostupný pouze pro metody, které jsou psány v jazyce VBScript. Pro jazyk JavaScript se vrácená hodnota zadá v příkaze return. |
pContext | (Object) (pro objekty PmaRoot a PmaPanel) obsahuje referenci na objekt s dodatečnými informacemi o způsobu, kterým byla metoda vyvolána. pContext.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ů. - k uchová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). pContext.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 vyvolává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. Viz konfigurátor "Hlavní jazyk runtime". pContext.TypeEnable - (Long) Typ povolení volání metody klientem. Projektant může (dle nastaveného uživatele, hesla či adresy počítače) operaci zakázat. Nastavení tohoto parametru je doporučeno pouze pro speciální případy. Běžné zabezpečení je lepší provádět standardně pomocí oprávnění: WebMethods. Upozornění! Vlastnost je funkční pouze pro Web obrazy. 1 (přednastaveno) - povolení operace. -1 - vyžádání přihlášení uživatele (pokud uživatel nebyl zadán) nebo zakázání uživatele (pokud uživatel byl zadán ale je špatný název a heslo). -2 - zakázání operace pro daného klienta bezpodmínečně. |
Parametry definované projektantem | (Variant) Slouží jako předávané parametry při volání dané metody. Tyto parametry se definují v konfigurátoru "Parametry". |
var val = pMe.Pm("DAT").Item(par1).Value;
return val + 10;
var n = oFolder.Methods.dataadd("data1");
if (pContext.User.Type == 2 && Pm.TestUserInGroup(1, "$ADMIN", pContext.User.Id))
//...
var val = Pm.Methods.GetStartTime(par1);