getAllReferences (IProcess, IEntity, String) [Documentation]

Index, Programmers Reference, Methods, IExecutionEngine Interface, GetAllReferences

public IEntity [] getAllReferences(IProcessparent, IEntity refOwner, String refOwnerAttr)
throws AccessDeniedException, ExecutionException;

This method retrieves all references of the specified instance of the business object referenced by the specified attribute of the reference type. The method getReferences of the IEntity interface also returns the references of the business object, so it is possible to retrieve the object by calling getEntity and then call getReferences method. However, calling the getEntity or getEntities methods will only retrieve single references and will not retrieve multiple references. The getAllReferences method, on the other hand, guarantees that all references of the business object referenced through the specified attribute are retrieved.

Parameters

`refOwner`	the instance of the business object the references of which are retrieved
`refOwnerAttr`	the name of the attribute of the business object () the references of which are retrieved (must be of the reference type)

Returns

The instances of the business objects referenced through the specified attribute or null if no instances are referenced through the specified attribute.