Difference between revisions of "NXSL:FindObject"

From NetXMS Wiki
Jump to navigation Jump to search
(Created page with "__NOTOC__ Find NetXMS object by object id or name. == Syntax == FindObject(''id'', ''node''); == Parameters == :{| |- | ''id'' || ID or name of the object to find. |- | ...")
 
m
Line 14: Line 14:
| ''id'' || ID or name of the object to find.
| ''id'' || ID or name of the object to find.
|-
|-
| ''node'' || Node object, you can use predefined variable $node to refer to current node. You can also use null or omit this parameter if trusted nodes check is disabled (see notes for more information).
| ''node'' || Node object, you can use predefined variable $node to refer to current node. You can also use null or omit this parameter if trusted nodes check is disabled (see [[SG:Security Issues|Security Issues]] for more information).
|}
|}



Revision as of 16:32, 10 April 2012

Find NetXMS object by object id or name.


Syntax

FindObject(id, node);


Parameters

id ID or name of the object to find.
node Node object, you can use predefined variable $node to refer to current node. You can also use null or omit this parameter if trusted nodes check is disabled (see Security Issues for more information).


Return Value

Node object with given id or name on success or null on failure (either because object with given name/id does not exist, or access to it was denied).


Examples

FindObject("server.netxms.org", $node)	-> object
FindObject(2)				-> object
FindObject("bad_object_name", $node)	-> NULL