WOAnyField

The WOAnyField component provides an interface for the user to qualify a WODisplayGroup’s enterprise objects based on a single attribute of the objects. The user can choose the attribute, an operator (less than, greater than, equal to, or not equal to), and a value for the attribute. The attribute can be an attribute of the displayed objects, or an attribute of another object obtained by traversing a relationship. The component sets a WODisplayGroup’s queryMatch dictionary according to the user’s choices but does not redisplay the objects.

This component must be embedded within a WOForm. If you want to redisplay the objects with the new qualifier, bind the action attribute of the WOForm’s submit button to the WODisplayGroup’s qualifyDataSource method.

Synopsis

WOAnyField { displayGroup=aDisplayGroup; displayKey=aString;] [formatter=formatterObj;

key=aString; keyList=anArray; [relationshipKey=aString;] [selectedKey=aString;]

sourceEntityName=aString; [value=anObject;] };

Bindings

displayGroup

The display group for which the WOAnyField component sets the queryMatch dictionary.

displayKey

The string corresponding to key that the WOAnyField component displays. Can be bound to the same String as key.

formatter

A String format pattern for the attribute corresponding to key used to format the attribute’s values for display as strings and format user entered strings back into the attribute’s values. The formatter attribute should specify a variable containing (or method returning) a preconfigured formatter object.

key

The key corresponding to the current iteration through the key list.

keyList

An array containing keys corresponding to the attributes with which the user can qualify the displayed objects.

relationshipKey

The key corresponding to one of the source entity’s relationships. If this binding is specified, the WOAnyField component builds the queryMatch dictionary based on attributes from the destination object. This binding allows you to query with a single level of indirection. For example, you can query for all movies produced by studios starting with ’P’. If this binding is omitted, the source entity’s attributes are used.

selectedKey

The key that is selected when the WOAnyField component is first displayed.

sourceEntityName

The name of entity displayed by the display group.

value

The value that appears in the value text field when the WOAnyField component is first displayed.

---