A FinderResult represents an object from the Orchestrator inventory that Orchestrator locates in an external application by using a plug-in. For example, a FinderResult object can represent a virtual machine from vCenter Server.

FinderResult objects represent any object that a plug-in registers with Orchestrator in its vso.xml file. FinderResult objects represent the items, from all installed plug-ins, that you find when you call one of the find* operations. The items returned can be any type of object that an Orchestrator plug-in defines. Most workflows require FinderResult instances as input parameters, as most workflows act upon Orchestrator objects.

You cannot set a FinderResult as a workflow attribute directly. You must set WorkflowTokenAttribute in workflows instead, which take the type and the dunesUri from FinderResult objects.

The find operation finds objects according to query criteria that the vso.xml file defines. It does not return FinderResult objects directly, but returns QueryResult objects instead. QueryResult objects contain arrays of FinderResult objects.

The objects searched for can also be identified by ID or by relation using the findForId and findRelation operations, as the following example shows.

public FinderResult findForId(String type, String id, String username, String password);
public FinderResult[] findRelation(String parentType, String parentId, String relation, String username, String password);

FinderResult is not an Orchestrator scriptable object.

The following table shows the properties of the FinderResult object.






Type of object found.



ID of the discovered object.

Array of properties


A list of the discovered object's properties.

The format of the properties values is defined by each plug-in in its vso.xml file, under the FinderResult description.



A string representation of the object.

If a FinderResult object is accessed through a plug-in, it is identified by a dunesUri string, rather than by another type of string or ID. The format of the dunesUri is as follows.