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:

Attributes

Value

Description

type

An Orchestrator object type

Type of object represented by the finder. Mandatory attribute.

datasource

<finder-datasource name> attribute

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

dynamic-finder

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.

hidden

true or false (default)

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

image

Path to a graphic file

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

java-class

Name of a Java class

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

script-object

<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

<finders>

  • <id>

  • <description>

  • <properties>

  • <default-sorting>

  • <inventory-children>

  • <relations>

  • <inventory-tabs>

  • <events>