getReferences (String)
public ObjectReference [] getReferences (String attributeName) throws InvalidParameterException
This method retrieves references of the business object or notification. If the business object was obtained in the first place by the calls to the getEntityor getEntities methods of the IExecutionEngine interface the getReferences method will always return null for multiple references (it will always return the only existing reference if the attribute is a single reference). Use the getAllReferences method in the IExecutionEngine interface to obtain all multiple references of the business object.
Parameters
attributeName | The name of the attribute of the business object or notification the references of which are returned (must be of the reference type) |
Returns
The references as ObjectReference objects or null if no objects are referenced by the specified attribute.
Throws
InvalidParameterException | if the specified attribute name does not exist in the business object or notification or it is not a reference. |