The <finder> element represents in the Orchestrator client a type of object found through the plug-in.

The <finder> element identifies the Java class that defines the object the object finder represents. The <finder> element defines how the object appears in the Orchestrator client interface. It also identifies the scripting object that the Orchestrator scripting API defines to represent this object.

Finders act as an interface between object formats used by different types of plugged-in technologies.

The <finder> element is optional. A plug-in can have an unlimited number of <finder> elements. The <finder> element defines the following attributes:





An Orchestrator object type

Type of object represented by the finder. Mandatory attribute.


<finder-datasource name> attribute

Identifies the Java class that defines the object by using the datasource refid. Mandatory attribute.


Java method

Defines a custom finder method you implement in an IDynamicFinder instance, to return the ID and properties of a finder programmatically, instead defining it in the vso.xml file. Optional attribute.


true or false (default)

If true, hides the finder in the Orchestrator client. Optional attribute.


Path to a graphic file

A 16x16 icon to represent the finder in hierarchical lists in the Orchestrator client. Optional attribute.


Name of a Java class

The Java class that defines the object the finder finds and maps to a scripting object. Optional attribute.


<scripting-object type> attribute

The <scripting-object> type, if any, to which to map this finder. Optional attribute.

Table 1. Element Hierarchy

Parent Element

Child Elements


  • <id>

  • <description>

  • <properties>

  • <default-sorting>

  • <inventory-children>

  • <relations>

  • <inventory-tabs>

  • <events>