minBusObjArray()

Returns the business objects that have the minimum value for the specified attribute, as a BusObjArray object.

Syntax

BusObjArray minBusObjArray(String attr)
 

Parameters

attr
A String, LongText, Integer, Float, or Double variable that refers to an attribute in the business object.

Returns

A list of business objects in the form of BusObjArray or null.

Exceptions

UnknownAttributeException - When the specified attribute is not a valid attribute in the business objects passed in.

UnsupportedAttributeTypeException - When the type of the specified attribute is not one of the supported attribute types listed in the note section.

All of the above exceptions are subclassed from CollaborationException. The minBusObjArray() method can set the following exception type for these exceptions: AttributeException.

Notes

The minBusObjArray() method finds one or more business objects with the minimum value for the specified attribute, and returns these business objects in a BusObjArray object.

For example, suppose that this is a business object array containing Employee business objects and that the input argument is the attribute Salary, a Float. The method determines the smallest value for Salary in all the Employee business objects and returns the business object that contains that value. If multiple business objects have that smallest Salary value, the method returns all of those business objects.

A business object is ignored if the specified attribute contains null. If the value is null in all business objects in the array, null is returned.

When the attribute is of type String, the method returns the shortest string lexically.

Examples

BusObjArray boarrayWithMinSalary = items.minBusObjArray("Salary");
 

Copyright IBM Corp. 2003