5.5.1

Prerequisites
You must have created a connection to the Orchestrator Web services endpoint in your Web service client
application class.
Procedure
1 Create a FinderResult object by calling the findForId operation on an object.
finderResult = vsoWebControl.findForId("VC:VirtualMachine", "vcenter/vm-xx",
username, password);
In the preceding example, vcenter/vm-xx is the ID of a virtual machine object that the findForID
operation finds.
The findForID operation returns a FinderResult instance directly, rather than creating an array of
FinderResult objects like find. Finding objects by their unique ID always returns only one object.
2 Extract the results from a FinderResult object.
To show, interpret, or process the results in the FinderResult objects that the find operation returns,
you must convey these results to the Web service application.
The following example shows how to extract the results returned in a FinderResult object.
public static void displayFinderResult(FinderResult finderResult) {
if (finderResult != null) {
System.out.println("Finder result is of type '"
+ finderResult.getType()
+ "', id '" + finderResult.getId()
+ "' and uri '"
+ finderResult.getDunesUri() + "'");
System.out.println("And has properties :");
Property[] props = finderResult.getProperties();
if (props != null) {
for (int ii = 0; ii < props.length; ii++) {
System.out.println("\t" + props[ii].getName() + "="
+ props[ii].getValue());
}
}
}
The example defines an internal method, displayFinderResult, which takes a FinderResult object and
obtains and shows its type, ID, the URI at which it is located, and its properties. You can use the URI to
set arguments when starting or answering workflows. The getType, getId, getProperties and
getDunesUri methods are defined by the FinderResult object.
You found objects in the Orchestrator server that the Web service client can access and run workflows upon.
Find Objects by Using the findRelation Operation
You can use the findRelation operation to locate the children of a particular object.
The findRelation operation returns an array of FinderResult objects that correspond to the children of a
particular object.
Prerequisites
You must have created a connection to the Orchestrator Web services endpoint in your Web service client
application class.
Developing a Web Services Client for VMware vCenter Orchestrator
60 VMware, Inc.