Using Work Item Attribute Fields
You can use the values of the 40 custom work item attribute fields as criteria in both sort and filter expressions.
These fields correspond to the customizable attributes workItemAttributes.attribute1 to workItemAttributes.attribute40 that you can set using the work item scripting methods described in the TIBCO ActiveMatrix BPMBusiness Data Services Guide ("Process Manager and Work Manager Scripting" > "WorkItem" topic). Also, for information about defining scripts in your processes at design time, see the "Using Scripts" topic in the TIBCO Business Studio BPM Implementation guide.
By default, these custom fields are locally logged, but are neither audited nor published by Event Collector. However, you can configure the system to audit and/or to publish any of these attributes for any event. See "Configuring TIBCO ActiveMatrix BPM Auditing" in TIBCO ActiveMatrix BPM - BPM Administration for information on changing the default auditing and logging behavior.
You can use these attributes to hold data associated with the work item. For example, you could use them to track data about the customer with whom the work item is associated. Assume that a script in your business process sets the following values, mapping fields from the business process to work item attributes:
WorkManagerFactory.getWorkItem().workItemAttributes.attribute1=customer_number WorkManagerFactory.getWorkItem().workItemAttributes.attribute2=customer_name WorkManagerFactory.getWorkItem().workItemAttributes.attribute3=customer_contact
You could then use a setResourceOrderFilterCriteria function to sort or filter by any of these values.