public void setReferences (String attributeName, ObjectReference [] refs) throws InvalidParameterException
This method sets references of the business object or notification. Note that if the updateEntity method of the IExecutionEngine interface is used to update the business object in the database after setting its references the system will delete any existing references of the business object and add whatever references are set by the setReferences method. If, however, the setReferences method sets the value to null and then the updateEntity method is called, the null value is interpreted by the system as “no change” so no existing references are deleted. To clear existing references use the deleteReferences method in the IExecutionEngine interface.
attributeName | the name of the attribute of the business object or notification the references of which are being set (must be of the reference type) | |
refs | the references being set. | |
| ''InvalidParameterException'“ | if the specified attribute name does not exist in the business object or notification or it is not a reference. |
There are a number of methods that are specific to the IEntity interface as opposed to the IObject interface, however, these are mostly used by the system are not relevant to custom process extensions.