Set o = oItem.Pm(sPath)
|sPath||(String) Relative or absolute path to the PROMOTIC object in the application tree or to its subobject (case sensitive text). |
The path describes the location of the object in the tree structure. Each tree level adress is separated by the / character. The immersed PROMOTIC object is referrenced by its name. The superior PROMOTIC object is referrenced by .. characters. The immersed implementation subobject (other than PmObject type) is referrenced by # character, followed by the implementation subobject type definition (e.g. #vars). It means that, the # addressing leaves the PROMOTIC objects tree (created by user) and starts to address the implementation subobjects of the PROMOTIC object. For example "/appdata/data/#vars/Temperature".
|nAttr||[optional] (Long) Enables to change the behavior of the function.|
0 (default) - Default behavior.
1 - When referencing the non-existing object, the global error won't be generated in the INFO system.
When the path (sPath parameter) doesn't begin with a slash (/), then it represents the relative path. Then the reference is got relative to the PmPanel object where the graphic item (where the script is called) is placed.
When the path begins with a slash, then it represents the absolute path. Then the reference is got by absolute addressing relative to the root object of the application tree - which means relative to the PmRoot object.
For more detailed explanation of the absolute and relative path see the PmObject.Pm method.
This method is not functional for Web panels.
This method is no longer functional if the Level of integration of panel viewer and the local application configurator is set to value client - LIMITED access from scripts to the PmPanel object and Pm object.
Set oTemp = oItem.Pm("/Boiler1/Temperature")
Set oTemp = oItem.Pm("../Temperature")