IBM WebSphere Application ServerTM
Release 7

com.ibm.bpe.api
Interface WorkItemData

All Superinterfaces:
java.io.Serializable

public interface WorkItemData
extends java.io.Serializable

Accesses the properties of a work item.

A work item represents a relationship between a person or group of persons and an object, typically an activity or task instance. The relationship is described by attributes such as the type of the associated object and the reason why the object is assigned.

For example, work items are created whenever a human task (staff), receive, or pick activity is encountered during the navigation of a process instance. The associated people assignment is performed and returns a list or group of persons. Each person on the list or the group receives a work item for the activity instance. Similarly, work items are created for the starter, process administrators, editors, and readers of a process instance.

Since:
5.0

Field Summary
static java.lang.String COPYRIGHT
           
static int OBJECT_TYPE_ACTIVITY
          States that the work item has been created for an activity instance.
static int OBJECT_TYPE_APPLICATION_COMPONENT
          Do not use - internal only.
static int OBJECT_TYPE_ESCALATION_INSTANCE
          States that the work item has been created for an escalation instance.
static int OBJECT_TYPE_ESCALATION_TEMPLATE
          Do not use - internal only.
static int OBJECT_TYPE_EVENT
          States that the work item has been created for a receive event.
static int OBJECT_TYPE_MAX
          Do not use - internal only.
static int OBJECT_TYPE_PROCESS_INSTANCE
          States that the work item has been created for a process instance.
static int OBJECT_TYPE_PROCESS_TEMPLATE
          Do not use - internal only.
static int OBJECT_TYPE_STATE_MACHINE_EVENT
          Do not use - internal only.
static int OBJECT_TYPE_STATE_MACHINE_INSTANCE
          Do not use - internal only.
static int OBJECT_TYPE_STATE_MACHINE_TEMPLATE
          Do not use - internal only.
static int OBJECT_TYPE_TASK_INSTANCE
          States that the work item has been created for a task instance.
static int OBJECT_TYPE_TASK_TEMPLATE
          Do not use - internal only.
static int REASON_ADMINISTRATOR
          States that operations can be executed on the associated object that require administrator rights, for example, deletion of an object.
static int REASON_EDITOR
          States that operations can be executed on the associated object that require editor authority, for example, setting the output message of an object.
static int REASON_ESCALATION_RECEIVER
          States that operations can be executed on the associated object that require escalation receiver rights, for example, reading properties of an object that is escalated.
static int REASON_MAX
          Do not use - internal only.
static int REASON_ORIGINATOR
          States that operations can be executed on the associated object that require originator rights.
static int REASON_OWNER
          States that the associated object can be completed.
static int REASON_POTENTIAL_INSTANCE_CREATOR
          States that operations can be executed on the associated object that require instance creator rights, for example, creating objects.
static int REASON_POTENTIAL_OWNER
          States that the associated object can be claimed.
static int REASON_POTENTIAL_SENDER
          Deprecated. Not used.
static int REASON_POTENTIAL_STARTER
          States that operations can be executed on the associated object that require potential starter rights, for example, creating objects.
static int REASON_READER
          States that operations can be executed on the associated object that require reader authority, for example, reading the properties of an object.
static int REASON_STARTER
          States that operations can be executed on the associated object that require starter authority.
static int REASON_STATE_MACHINE_END
          Do not use - internal only.
static int REASON_STATE_MACHINE_EVENT_AVAILABLE
          Do not use - internal only.
static int REASON_STATE_MACHINE_START
          Do not use - internal only.
 
Method Summary
 int getAssignmentReason()
          Returns the reason why the work item is assigned.
 int getAssociatedObjectType()
          Returns the type of the object associated to or containing the work item's associated object.
 OID getAssociatedOid()
          Returns the object ID of the object associated to or containing the work item's associated object.
 java.util.Calendar getCreationTime()
          Returns the creation time of the work item.
 java.lang.String getGroupName()
          Returns the name of the group of persons associated with the work item.
 com.ibm.bpe.api.WIID getID()
          Returns the object identifier.
 boolean getIsAssignedToEverybody()
          Returns whether the workitem is assigned to everybody.
 OID getObjectID()
          Returns the object ID of the associated object.
 int getObjectType()
          Returns the type of the associated object.
 java.lang.String getOwnerID()
          Returns the user ID of the workitem owner if the work item is not assigned to everybody or to a group of persons.
 

Field Detail

COPYRIGHT

static final java.lang.String COPYRIGHT
See Also:
Constant Field Values

OBJECT_TYPE_STATE_MACHINE_INSTANCE

static final int OBJECT_TYPE_STATE_MACHINE_INSTANCE
Do not use - internal only.

See Also:
Constant Field Values

OBJECT_TYPE_STATE_MACHINE_TEMPLATE

static final int OBJECT_TYPE_STATE_MACHINE_TEMPLATE
Do not use - internal only.

See Also:
Constant Field Values

OBJECT_TYPE_APPLICATION_COMPONENT

static final int OBJECT_TYPE_APPLICATION_COMPONENT
Do not use - internal only.

See Also:
Constant Field Values

OBJECT_TYPE_PROCESS_INSTANCE

static final int OBJECT_TYPE_PROCESS_INSTANCE
States that the work item has been created for a process instance.

See Also:
Constant Field Values

OBJECT_TYPE_TASK_INSTANCE

static final int OBJECT_TYPE_TASK_INSTANCE
States that the work item has been created for a task instance.

See Also:
Constant Field Values

OBJECT_TYPE_PROCESS_TEMPLATE

static final int OBJECT_TYPE_PROCESS_TEMPLATE
Do not use - internal only.

See Also:
Constant Field Values

OBJECT_TYPE_TASK_TEMPLATE

static final int OBJECT_TYPE_TASK_TEMPLATE
Do not use - internal only.

See Also:
Constant Field Values

OBJECT_TYPE_STATE_MACHINE_EVENT

static final int OBJECT_TYPE_STATE_MACHINE_EVENT
Do not use - internal only.

See Also:
Constant Field Values

OBJECT_TYPE_ACTIVITY

static final int OBJECT_TYPE_ACTIVITY
States that the work item has been created for an activity instance.

See Also:
Constant Field Values

OBJECT_TYPE_EVENT

static final int OBJECT_TYPE_EVENT
States that the work item has been created for a receive event.

See Also:
Constant Field Values

OBJECT_TYPE_ESCALATION_INSTANCE

static final int OBJECT_TYPE_ESCALATION_INSTANCE
States that the work item has been created for an escalation instance.

See Also:
Constant Field Values

OBJECT_TYPE_MAX

static final int OBJECT_TYPE_MAX
Do not use - internal only.

See Also:
Constant Field Values

OBJECT_TYPE_ESCALATION_TEMPLATE

static final int OBJECT_TYPE_ESCALATION_TEMPLATE
Do not use - internal only.

See Also:
Constant Field Values

REASON_STATE_MACHINE_START

static final int REASON_STATE_MACHINE_START
Do not use - internal only.

See Also:
Constant Field Values

REASON_STATE_MACHINE_EVENT_AVAILABLE

static final int REASON_STATE_MACHINE_EVENT_AVAILABLE
Do not use - internal only.

See Also:
Constant Field Values

REASON_EDITOR

static final int REASON_EDITOR
States that operations can be executed on the associated object that require editor authority, for example, setting the output message of an object.

See Also:
Constant Field Values

REASON_MAX

static final int REASON_MAX
Do not use - internal only.

See Also:
Constant Field Values

REASON_POTENTIAL_SENDER

static final int REASON_POTENTIAL_SENDER
Deprecated. Not used.
See Also:
Constant Field Values

REASON_ADMINISTRATOR

static final int REASON_ADMINISTRATOR
States that operations can be executed on the associated object that require administrator rights, for example, deletion of an object.

See Also:
Constant Field Values

REASON_POTENTIAL_STARTER

static final int REASON_POTENTIAL_STARTER
States that operations can be executed on the associated object that require potential starter rights, for example, creating objects.

See Also:
Constant Field Values

REASON_STARTER

static final int REASON_STARTER
States that operations can be executed on the associated object that require starter authority.

See Also:
Constant Field Values

REASON_POTENTIAL_OWNER

static final int REASON_POTENTIAL_OWNER
States that the associated object can be claimed.

See Also:
Constant Field Values

REASON_ORIGINATOR

static final int REASON_ORIGINATOR
States that operations can be executed on the associated object that require originator rights.

See Also:
Constant Field Values

REASON_OWNER

static final int REASON_OWNER
States that the associated object can be completed.

See Also:
Constant Field Values

REASON_STATE_MACHINE_END

static final int REASON_STATE_MACHINE_END
Do not use - internal only.

See Also:
Constant Field Values

REASON_READER

static final int REASON_READER
States that operations can be executed on the associated object that require reader authority, for example, reading the properties of an object.

See Also:
Constant Field Values

REASON_ESCALATION_RECEIVER

static final int REASON_ESCALATION_RECEIVER
States that operations can be executed on the associated object that require escalation receiver rights, for example, reading properties of an object that is escalated.

See Also:
Constant Field Values

REASON_POTENTIAL_INSTANCE_CREATOR

static final int REASON_POTENTIAL_INSTANCE_CREATOR
States that operations can be executed on the associated object that require instance creator rights, for example, creating objects.

See Also:
Constant Field Values
Method Detail

getID

com.ibm.bpe.api.WIID getID()
Returns the object identifier.


getOwnerID

java.lang.String getOwnerID()
Returns the user ID of the workitem owner if the work item is not assigned to everybody or to a group of persons.


getIsAssignedToEverybody

boolean getIsAssignedToEverybody()
Returns whether the workitem is assigned to everybody. If assigned to everybody, the owner ID and the group name are null strings.


getObjectType

int getObjectType()
Returns the type of the associated object.


getObjectID

OID getObjectID()
Returns the object ID of the associated object.


getAssociatedObjectType

int getAssociatedObjectType()
Returns the type of the object associated to or containing the work item's associated object.


getAssociatedOid

OID getAssociatedOid()
Returns the object ID of the object associated to or containing the work item's associated object. For example, the PIID of the process instance containing the activity instance for which this work item has been created.


getAssignmentReason

int getAssignmentReason()
Returns the reason why the work item is assigned.


getCreationTime

java.util.Calendar getCreationTime()
Returns the creation time of the work item.


getGroupName

java.lang.String getGroupName()
Returns the name of the group of persons associated with the work item. If there is no group associated, null is returned.


IBM WebSphere Application ServerTM
Release 7