com.ibm.task.api

Interface WorkBasketDefinition

All Superinterfaces:
java.io.Serializable

  1. public interface WorkBasketDefinition
  2. extends java.io.Serializable
Accesses the properties of a work basket and allows for setting values. A work basket definition is used to create or update a persistently stored work basket.

Since:
6.2.0.3

Field Summary

Modifier and Type Field and Description
  1. static
  2. java.lang.String
COPYRIGHT
  1. static
  2. java.lang.String
DEFAULT_CONTAINER_JNDI_NAME_OF_STAFF_PLUGIN_PROVIDER
States the default value for getJNDINameOfStaffPluginProvider.
  1. static
  2. int
SUBSTITUTION_POLICY_NO_SUBSTITUTION
States that no substitution should take place.
  1. static
  2. int
SUBSTITUTION_POLICY_SELECT_USER_IF_PRESENT
States that only present users should act for absent users.
  1. static
  2. int
SUBSTITUTION_POLICY_SUBSTITUTE_IF_ABSENT
States that substitutes should act for absent users.
  1. static
  2. int
TYPE_CLEARANCE
States that tasks contained in this work basket cannot be processed as they are, but require special care.
  1. static
  2. int
TYPE_GROUP
States that tasks contained in this work basket are to be processed by a certain group of people, for example, teams or departments.
  1. static
  2. int
TYPE_INDIVIDUAL
States that tasks contained in this work basket are assigned to a specific person.
  1. static
  2. int
TYPE_TOPIC
States that tasks contained in this work basket belong to a certain theme or topic.

Method Summary

Modifier and Type Method and Description
  1. java.lang.String
getCustomText1()
Returns the custom text specified as custom text one.
  1. java.lang.String
getCustomText2()
Returns the custom text specified as custom text two.
  1. java.lang.String
getCustomText3()
Returns the custom text specified as custom text three.
  1. java.lang.String
getCustomText4()
Returns the custom text specified as custom text four.
  1. java.lang.String
getCustomText5()
Returns the custom text specified as custom text five.
  1. java.lang.String
getCustomText6()
Returns the custom text specified as custom text six.
  1. java.lang.String
getCustomText7()
Returns the custom text specified as custom text seven.
  1. java.lang.String
getCustomText8()
Returns the custom text specified as custom text eight.
  1. java.lang.String
getDefaultQueryTable()
Returns the name of the default query table associated to the work basket.
  1. java.lang.String
getDescription(java.util.Locale arg0)
Returns the description in the specified locale.
  1. java.lang.String
getDisplayName(java.util.Locale arg0)
Returns the display name in the specified locale.
  1. java.util.List
getDistributionTargets()
Returns a list of object IDs ( WBIDs) of work baskets that are distribution targets of this work basket.
  1. java.lang.String
getJNDINameOfStaffPluginProvider()
Returns the JNDI name of a user-defined people directory configuration.
  1. java.util.List
getLocalesOfDescriptions()
Returns the locales of all descriptions.
  1. java.util.List
getLocalesOfDisplayNames()
Returns the locales of all display names.
  1. java.lang.String
getName()
Returns the name of the work basket.
  1. java.lang.String
getOwner()
Returns the owner of the work basket.
  1. PeopleAssignment
getPeopleAssignment(int arg0)
Returns the staff assignments for the passed role.
  1. java.util.List
getReasonsOfPeopleAssignment()
Returns a list of Integer objects that state the assignment reasons.
  1. int
getSubstitutionPolicy()
Returns the substitution policy that takes place when people assignments are performed.
  1. int
getType()
Returns the type of the work basket.
  1. boolean
isCustomText1Updateable()
Signals whether the custom text 1 property can be changed for the kind and current state of the object.
  1. boolean
isCustomText2Updateable()
Signals whether the custom text 2 property can be changed for the kind and current state of the object.
  1. boolean
isCustomText3Updateable()
Signals whether the custom text 3 property can be changed for the kind and current state of the object.
  1. boolean
isCustomText4Updateable()
Signals whether the custom text 4 property can be changed for the kind and current state of the object.
  1. boolean
isCustomText5Updateable()
Signals whether the custom text 5 property can be changed for the kind and current state of the object.
  1. boolean
isCustomText6Updateable()
Signals whether the custom text 6 property can be changed for the kind and current state of the object.
  1. boolean
isCustomText7Updateable()
Signals whether the custom text 7 property can be changed for the kind and current state of the object.
  1. boolean
isCustomText8Updateable()
Signals whether the custom text 8 property can be changed for the kind and current state of the object.
  1. boolean
isDefaultQueryTableUpdateable()
Signals whether the default query table property can be changed for the kind and current state of the object.
  1. boolean
isDescriptionUpdateable()
Signals whether the description property can be changed for the kind and current state of the object.
  1. boolean
isDisplayNameUpdateable()
Signals whether the display name property can be changed for the kind and current state of the object.
  1. boolean
isDistributionTargetsUpdateable()
Signals whether the source w b ID property can be changed for the kind and current state of the object.
  1. boolean
isJNDINameOfStaffPluginProviderUpdateable()
Signals whether the jndi name staff provider property can be changed for the kind and current state of the object.
  1. boolean
isOwnerUpdateable()
Signals whether the owner property can be changed for the kind and current state of the object.
  1. boolean
isPeopleAssignmentUpdateable()
Signals whether the custom text 8 property can be changed for the kind and current state of the object.
  1. boolean
isSubstitutionPolicyUpdateable()
Signals whether the substitution policy property can be changed for the kind and current state of the object.
  1. boolean
isTypeUpdateable()
Signals whether the type property can be changed for the kind and current state of the object.
  1. void
setCustomText1(java.lang.String customText1)
Sets the custom text specified as custom text one.
  1. void
setCustomText2(java.lang.String customText2)
Sets the custom text specified as custom text two.
  1. void
setCustomText3(java.lang.String customText3)
Sets the custom text specified as custom text three.
  1. void
setCustomText4(java.lang.String customText4)
Sets the custom text specified as custom text four.
  1. void
setCustomText5(java.lang.String customText5)
Sets the custom text specified as custom text five.
  1. void
setCustomText6(java.lang.String customText6)
Sets the custom text specified as custom text six.
  1. void
setCustomText7(java.lang.String customText7)
Sets the custom text specified as custom text seven.
  1. void
setCustomText8(java.lang.String customText8)
Sets the custom text specified as custom text eight.
  1. void
setDefaultQueryTable(java.lang.String defaultQueryTable)
Sets the default query table associated to the business category.
  1. void
setDescription(java.lang.String description,java.util.Locale locale)
Sets the description in the specified locale.
  1. void
setDisplayName(java.lang.String displayName,java.util.Locale locale)
Sets the display name in the specified locale.
  1. void
setDistributionTargets(java.util.List wbids)
Sets the distribution targets associated to the work basket.
  1. void
setJNDINameOfStaffPluginProvider(java.lang.String jndiNameStaffProvider)
Sets the JNDI name of a user-defined people directory configuration.
  1. void
setOwner(java.lang.String owner)
Sets the owner of the work basket.
  1. void
setPeopleAssignment(int assignmentReason,PeopleAssignment people)
Sets the assignment reason for the specified people.
  1. void
setSubstitutionPolicy(int substitutionPolicy)
Sets the substitution policy that takes place when people assignments are performed.
  1. void
setType(int type)
Sets the type of the work basket.

Field Detail

  1. static final java.lang.String COPYRIGHT
See Also:

DEFAULT_CONTAINER_JNDI_NAME_OF_STAFF_PLUGIN_PROVIDER

  1. static final java.lang.String DEFAULT_CONTAINER_JNDI_NAME_OF_STAFF_PLUGIN_PROVIDER
States the default value for getJNDINameOfStaffPluginProvider.
See Also:

TYPE_CLEARANCE

  1. static final int TYPE_CLEARANCE
States that tasks contained in this work basket cannot be processed as they are, but require special care.
See Also:

TYPE_TOPIC

  1. static final int TYPE_TOPIC
States that tasks contained in this work basket belong to a certain theme or topic.
See Also:

TYPE_GROUP

  1. static final int TYPE_GROUP
States that tasks contained in this work basket are to be processed by a certain group of people, for example, teams or departments.
See Also:

TYPE_INDIVIDUAL

  1. static final int TYPE_INDIVIDUAL
States that tasks contained in this work basket are assigned to a specific person.
See Also:

SUBSTITUTION_POLICY_NO_SUBSTITUTION

  1. static final int SUBSTITUTION_POLICY_NO_SUBSTITUTION
States that no substitution should take place. All users resolved by people assignment criteria are returned.
See Also:

SUBSTITUTION_POLICY_SUBSTITUTE_IF_ABSENT

  1. static final int SUBSTITUTION_POLICY_SUBSTITUTE_IF_ABSENT
States that substitutes should act for absent users. If all substitutes are absent or explicitely excluded by people assignment criteria, default people assignments are performed, for example, task administrators become potential owners.
See Also:

SUBSTITUTION_POLICY_SELECT_USER_IF_PRESENT

  1. static final int SUBSTITUTION_POLICY_SELECT_USER_IF_PRESENT
States that only present users should act for absent users. If all users and their subsitutes are absent or excluded by people assignment criteria, users originally resolved are returned.
See Also:

Method Detail

getName

  1. java.lang.String getName()
Returns the name of the work basket.

getType

  1. int getType()
Returns the type of the work basket.

Possible types are TYPE_GROUP, TYPE_TOPIC, TYPE_INDIVIDUAL, or TYPE_CLEARANCE.


getDisplayName

  1. java.lang.String getDisplayName( java.util.Locale arg0)
Returns the display name in the specified locale. Returns the display name in the default locale when a display name in the specified locale is not found.

If no locale is specified, the display name in the default locale is returned or any available display name, if there is only a single display name.

Parameters:
arg0 - The locale for which the display name is to be provided.

getLocalesOfDisplayNames

  1. java.util.List getLocalesOfDisplayNames( )
Returns the locales of all display names. Returns an empty list when there are no display names.

getDescription

  1. java.lang.String getDescription( java.util.Locale arg0)
Returns the description in the specified locale. Returns the description in the default locale when a description in the specified locale is not found.

If no locale is specified, the description in the default locale is returned or any available description, if there is only a single description.

Parameters:
arg0 - The locale for which the description is to be provided.

getLocalesOfDescriptions

  1. java.util.List getLocalesOfDescriptions( )
Returns the locales of all descriptions. Returns an empty list when there are no descriptions.

getOwner

  1. java.lang.String getOwner()
Returns the owner of the work basket.

getDistributionTargets

  1. java.util.List getDistributionTargets( )
Returns a list of object IDs ( WBIDs) of work baskets that are distribution targets of this work basket.

Note, if you modify an existing list of distribution targets, then you must call setDistributionTargets before calling updateWorkBasket. The list returned by this method is a copy of the list contained in the WorkBasketDefinition.

For example,
WorkBasketDefinition workBasketDefinition = service.getWorkBasketDefinition("MyWorkBasket");
List lst = workBasketDefinition.getDistributionTargets();
lst.add(wbid);
workBasketDefinition.setDistributionTargets(lst);
service.updateWorkBasket(workBasketDefinition);
.


getDefaultQueryTable

  1. java.lang.String getDefaultQueryTable( )
Returns the name of the default query table associated to the work basket. Returns null if no query table is associated.

getPeopleAssignment

  1. PeopleAssignment getPeopleAssignment( int arg0)
Returns the staff assignments for the passed role. Possible roles are: WorkItem.REASON_READER.

Parameters:
arg0 - The role for which the people assignment is to be provided.

getReasonsOfPeopleAssignment

  1. java.util.List getReasonsOfPeopleAssignment( )
Returns a list of Integer objects that state the assignment reasons. Returns an empty list when there are no people assignments.

getJNDINameOfStaffPluginProvider

  1. java.lang.String getJNDINameOfStaffPluginProvider( )
Returns the JNDI name of a user-defined people directory configuration.

getSubstitutionPolicy

  1. int getSubstitutionPolicy()
Returns the substitution policy that takes place when people assignments are performed.

Possible substitution policies are SUBSTITUTION_POLICY_NO_SUBSTITUTION, SUBSTITUTION_POLICY_SUBSTITUTE_IF_ABSENT, SUBSTITUTION_POLICY_SELECT_USER_IF_PRESENT.


getCustomText1

  1. java.lang.String getCustomText1( )
Returns the custom text specified as custom text one. Returns null if not specified.

getCustomText2

  1. java.lang.String getCustomText2( )
Returns the custom text specified as custom text two. Returns null if not specified.

getCustomText3

  1. java.lang.String getCustomText3( )
Returns the custom text specified as custom text three. Returns null if not specified.

getCustomText4

  1. java.lang.String getCustomText4( )
Returns the custom text specified as custom text four. Returns null if not specified.

getCustomText5

  1. java.lang.String getCustomText5( )
Returns the custom text specified as custom text five. Returns null if not specified.

getCustomText6

  1. java.lang.String getCustomText6( )
Returns the custom text specified as custom text six. Returns null if not specified.

getCustomText7

  1. java.lang.String getCustomText7( )
Returns the custom text specified as custom text seven. Returns null if not specified.

getCustomText8

  1. java.lang.String getCustomText8( )
Returns the custom text specified as custom text eight. Returns null if not specified.

setType

  1. void setType(int type)
Sets the type of the work basket.

Possible types are TYPE_GROUP, TYPE_TOPIC, TYPE_INDIVIDUAL, or TYPE_CLEARANCE.

Parameters:
type - The type that is to be set.

isTypeUpdateable

  1. boolean isTypeUpdateable()
Signals whether the type property can be changed for the kind and current state of the object.

setDisplayName

  1. void setDisplayName(java.lang.String displayName,
  2. java.util.Locale locale)
Sets the display name in the specified locale.

Parameters:
displayName - The new value of the display name.
locale - The locale for which the display name is set. Note that there is a special locale called default which can be used to set the display name in the default language. The default language is specified by passing null or new Locale("default").

isDisplayNameUpdateable

  1. boolean isDisplayNameUpdateable( )
Signals whether the display name property can be changed for the kind and current state of the object.

setDescription

  1. void setDescription(java.lang.String description,
  2. java.util.Locale locale)
Sets the description in the specified locale.

Parameters:
description - The new value of the description.
locale - The locale for which the description is set. Note that there is a special locale called default which can be used to set the description in the default language. The default language is specified by passing null or new Locale("default").

isDescriptionUpdateable

  1. boolean isDescriptionUpdateable( )
Signals whether the description property can be changed for the kind and current state of the object.

setOwner

  1. void setOwner(java.lang.String owner)
Sets the owner of the work basket.
Parameters:
owner - The owner who is to be set.

isOwnerUpdateable

  1. boolean isOwnerUpdateable()
Signals whether the owner property can be changed for the kind and current state of the object.

setDistributionTargets

  1. void setDistributionTargets(java.util.List wbids)
Sets the distribution targets associated to the work basket. Note, if you modify an existing list of distribution targets, then you must call this method before calling updateWorkBasket. The list returned by getDistributionTargets is a copy of the list contained in the WorkBasketDefinition.

For example,
WorkBasketDefinition workBasketDefinition = service.getWorkBasketDefinition("MyWorkBasket");
List lst = workBasketDefinition.getDistributionTargets();
lst.add(wbid);
workBasketDefinition.setDistributionTargets(lst);
service.updateWorkBasket(workBasketDefinition);
.


isDistributionTargetsUpdateable

  1. boolean isDistributionTargetsUpdateable( )
Signals whether the source w b ID property can be changed for the kind and current state of the object.

setDefaultQueryTable

  1. void setDefaultQueryTable(java.lang.String defaultQueryTable)
Sets the default query table associated to the business category.

Parameters:
defaultQueryTable - The default query table associated to the business category.

isDefaultQueryTableUpdateable

  1. boolean isDefaultQueryTableUpdateable( )
Signals whether the default query table property can be changed for the kind and current state of the object.

setJNDINameOfStaffPluginProvider

  1. void setJNDINameOfStaffPluginProvider( java.lang.String jndiNameStaffProvider)
Sets the JNDI name of a user-defined people directory configuration.

Parameters:
jndiNameStaffProvider - The JNDI name of the user-defined people directory configuration.

isJNDINameOfStaffPluginProviderUpdateable

  1. boolean isJNDINameOfStaffPluginProviderUpdateable( )
Signals whether the jndi name staff provider property can be changed for the kind and current state of the object.

setSubstitutionPolicy

  1. void setSubstitutionPolicy(int substitutionPolicy)
Sets the substitution policy that takes place when people assignments are performed.

Possible substitution policies are SUBSTITUTION_POLICY_NO_SUBSTITUTION, SUBSTITUTION_POLICY_SUBSTITUTE_IF_ABSENT, SUBSTITUTION_POLICY_SELECT_USER_IF_PRESENT.

Parameters:
substitutionPolicy - The substitution policy that should take place.

isSubstitutionPolicyUpdateable

  1. boolean isSubstitutionPolicyUpdateable( )
Signals whether the substitution policy property can be changed for the kind and current state of the object.

setCustomText1

  1. void setCustomText1(java.lang.String customText1)
Sets the custom text specified as custom text one.

Parameters:
customText1 - The custom text.

isCustomText1Updateable

  1. boolean isCustomText1Updateable( )
Signals whether the custom text 1 property can be changed for the kind and current state of the object.

setCustomText2

  1. void setCustomText2(java.lang.String customText2)
Sets the custom text specified as custom text two.

Parameters:
customText2 - The custom text.

isCustomText2Updateable

  1. boolean isCustomText2Updateable( )
Signals whether the custom text 2 property can be changed for the kind and current state of the object.

setCustomText3

  1. void setCustomText3(java.lang.String customText3)
Sets the custom text specified as custom text three.

Parameters:
customText3 - The custom text.

isCustomText3Updateable

  1. boolean isCustomText3Updateable( )
Signals whether the custom text 3 property can be changed for the kind and current state of the object.

setCustomText4

  1. void setCustomText4(java.lang.String customText4)
Sets the custom text specified as custom text four.

Parameters:
customText4 - The custom text.

isCustomText4Updateable

  1. boolean isCustomText4Updateable( )
Signals whether the custom text 4 property can be changed for the kind and current state of the object.

setCustomText5

  1. void setCustomText5(java.lang.String customText5)
Sets the custom text specified as custom text five.

Parameters:
customText5 - The custom text.

isCustomText5Updateable

  1. boolean isCustomText5Updateable( )
Signals whether the custom text 5 property can be changed for the kind and current state of the object.

setCustomText6

  1. void setCustomText6(java.lang.String customText6)
Sets the custom text specified as custom text six.

Parameters:
customText6 - The custom text.

isCustomText6Updateable

  1. boolean isCustomText6Updateable( )
Signals whether the custom text 6 property can be changed for the kind and current state of the object.

setCustomText7

  1. void setCustomText7(java.lang.String customText7)
Sets the custom text specified as custom text seven.

Parameters:
customText7 - The custom text.

isCustomText7Updateable

  1. boolean isCustomText7Updateable( )
Signals whether the custom text 7 property can be changed for the kind and current state of the object.

setCustomText8

  1. void setCustomText8(java.lang.String customText8)
Sets the custom text specified as custom text eight.

Parameters:
customText8 - The custom text.

isCustomText8Updateable

  1. boolean isCustomText8Updateable( )
Signals whether the custom text 8 property can be changed for the kind and current state of the object.

setPeopleAssignment

  1. void setPeopleAssignment(int assignmentReason,
  2. PeopleAssignment people)
Parameters:
assignmentReason - The assignment reason to be set.
people - The staff to be associated.

isPeopleAssignmentUpdateable

  1. boolean isPeopleAssignmentUpdateable( )
Signals whether the custom text 8 property can be changed for the kind and current state of the object.