A convenience function for retrieving single configuration object matching specified criteria. In contrast to getid function, this function returns configuration object instance, not an array of objects. If no matches exist or more than one match exists, getid1 raises an exception.

getid1 ( <criteria> )

Arguments

criteria

a string in the form of (/<type>:[<name>]/)+

Result

An instance of wdr.config.ConfigObject object.

Examples

  • Retrieving Cell object
print getid1('/Cell:/')

wdrCell(cells/wdrCell|cell.xml#Cell_1)
  • Retrieving JavaProcessDef from a named server
print getid1('/Server:wdrServer/JavaProcessDef:/')

(cells/wdrCell/nodes/wdrNode/servers/wdrServer|server.xml#JavaProcessDef_1335359012301)

See also