4.1

Type Value Description
String
type
Type of object looked for.
String
query
The query.
The query is a string enclosed in
quotation marks. Any object of the type
specified by the type parameter with a
name that matches the query string is
returned in the QueryResult object.
String
username
Orchestrator user name.
String
password
Orchestrator password.
Return Value
Returns the result of the query as a QueryResult object.
If find fails to match an object, QueryResult.getTotalCount returns 0 and QueryResult.getElement returns null.
If the server does not recognize the object type or plug-in searched for, find throws an exception. The find
operation also returns an exception if you pass it an invalid parameter.
findForId Operation
The findForId operation searches for a specific FinderResult object according to that FinderResult object's
type and id properties.
You can use the findForId operation to acquire information about FinderResult objects you have already found
by using the other find* operations. For example, you can use the findForId method to obtain the state of a
FinderResult object you found by using the find operation.
The findForId operation is declared as the following example shows.
public FinderResult findForId(String type, String id, String username,
String password);
Type Value Description
String
type
Type of object looked for.
String
id
ID of the object looked for.
String
username
Orchestrator user name.
String
password
Orchestrator password.
Return Value
Returns a FinderResult object containing details of the object found. Returns null if you pass it an invalid
parameter.
findRelation Operation
The findRelation operation finds all the children elements in an inventory that belong to a particular parent
or type of parent.
Knowing how a child is related to its parent is useful if you develop tree viewers to view the objects in a library.
The findRelation operation is declared as follows.
public FinderResult[] findRelation(String parentType, String parentId,
String relation, String username, String password);
Chapter 8 Developing a Web Services Client
VMware, Inc. 269