Interface WorkBasketDefinition
-
- All Superinterfaces:
- java.io.Serializable
public interface WorkBasketDefinition 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
Fields Modifier and Type Field and Description static java.lang.String
COPYRIGHT
static java.lang.String
DEFAULT_CONTAINER_JNDI_NAME_OF_STAFF_PLUGIN_PROVIDER
States the default value for getJNDINameOfStaffPluginProvider.static int
SUBSTITUTION_POLICY_NO_SUBSTITUTION
States that no substitution should take place.static int
SUBSTITUTION_POLICY_SELECT_USER_IF_PRESENT
States that only present users should act for absent users.static int
SUBSTITUTION_POLICY_SUBSTITUTE_IF_ABSENT
States that substitutes should act for absent users.static int
TYPE_CLEARANCE
States that tasks contained in this work basket cannot be processed as they are, but require special care.static 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.static int
TYPE_INDIVIDUAL
States that tasks contained in this work basket are assigned to a specific person.static int
TYPE_TOPIC
States that tasks contained in this work basket belong to a certain theme or topic.
-
Method Summary
Methods Modifier and Type Method and Description java.lang.String
getCustomText1()
Returns the custom text specified as custom text one.java.lang.String
getCustomText2()
Returns the custom text specified as custom text two.java.lang.String
getCustomText3()
Returns the custom text specified as custom text three.java.lang.String
getCustomText4()
Returns the custom text specified as custom text four.java.lang.String
getCustomText5()
Returns the custom text specified as custom text five.java.lang.String
getCustomText6()
Returns the custom text specified as custom text six.java.lang.String
getCustomText7()
Returns the custom text specified as custom text seven.java.lang.String
getCustomText8()
Returns the custom text specified as custom text eight.java.lang.String
getDefaultQueryTable()
Returns the name of the default query table associated to the work basket.java.lang.String
getDescription(java.util.Locale arg0)
Returns the description in the specified locale.java.lang.String
getDisplayName(java.util.Locale arg0)
Returns the display name in the specified locale.java.util.List
getDistributionTargets()
Returns a list of object IDs (WBIDs
) of work baskets that are distribution targets of this work basket.java.lang.String
getJNDINameOfStaffPluginProvider()
Returns the JNDI name of a user-defined people directory configuration.java.util.List
getLocalesOfDescriptions()
Returns the locales of all descriptions.java.util.List
getLocalesOfDisplayNames()
Returns the locales of all display names.java.lang.String
getName()
Returns the name of the work basket.java.lang.String
getOwner()
Returns the owner of the work basket.PeopleAssignment
getPeopleAssignment(int arg0)
Returns the staff assignments for the passed role.java.util.List
getReasonsOfPeopleAssignment()
Returns a list of Integer objects that state the assignment reasons.int
getSubstitutionPolicy()
Returns the substitution policy that takes place when people assignments are performed.int
getType()
Returns the type of the work basket.boolean
isCustomText1Updateable()
Signals whether the custom text 1 property can be changed for the kind and current state of the object.boolean
isCustomText2Updateable()
Signals whether the custom text 2 property can be changed for the kind and current state of the object.boolean
isCustomText3Updateable()
Signals whether the custom text 3 property can be changed for the kind and current state of the object.boolean
isCustomText4Updateable()
Signals whether the custom text 4 property can be changed for the kind and current state of the object.boolean
isCustomText5Updateable()
Signals whether the custom text 5 property can be changed for the kind and current state of the object.boolean
isCustomText6Updateable()
Signals whether the custom text 6 property can be changed for the kind and current state of the object.boolean
isCustomText7Updateable()
Signals whether the custom text 7 property can be changed for the kind and current state of the object.boolean
isCustomText8Updateable()
Signals whether the custom text 8 property can be changed for the kind and current state of the object.boolean
isDefaultQueryTableUpdateable()
Signals whether the default query table property can be changed for the kind and current state of the object.boolean
isDescriptionUpdateable()
Signals whether the description property can be changed for the kind and current state of the object.boolean
isDisplayNameUpdateable()
Signals whether the display name property can be changed for the kind and current state of the object.boolean
isDistributionTargetsUpdateable()
Signals whether the source w b ID property can be changed for the kind and current state of the object.boolean
isJNDINameOfStaffPluginProviderUpdateable()
Signals whether the jndi name staff provider property can be changed for the kind and current state of the object.boolean
isOwnerUpdateable()
Signals whether the owner property can be changed for the kind and current state of the object.boolean
isPeopleAssignmentUpdateable()
Signals whether the custom text 8 property can be changed for the kind and current state of the object.boolean
isSubstitutionPolicyUpdateable()
Signals whether the substitution policy property can be changed for the kind and current state of the object.boolean
isTypeUpdateable()
Signals whether the type property can be changed for the kind and current state of the object.void
setCustomText1(java.lang.String customText1)
Sets the custom text specified as custom text one.void
setCustomText2(java.lang.String customText2)
Sets the custom text specified as custom text two.void
setCustomText3(java.lang.String customText3)
Sets the custom text specified as custom text three.void
setCustomText4(java.lang.String customText4)
Sets the custom text specified as custom text four.void
setCustomText5(java.lang.String customText5)
Sets the custom text specified as custom text five.void
setCustomText6(java.lang.String customText6)
Sets the custom text specified as custom text six.void
setCustomText7(java.lang.String customText7)
Sets the custom text specified as custom text seven.void
setCustomText8(java.lang.String customText8)
Sets the custom text specified as custom text eight.void
setDefaultQueryTable(java.lang.String defaultQueryTable)
Sets the default query table associated to the business category.void
setDescription(java.lang.String description, java.util.Locale locale)
Sets the description in the specified locale.void
setDisplayName(java.lang.String displayName, java.util.Locale locale)
Sets the display name in the specified locale.void
setDistributionTargets(java.util.List wbids)
Sets the distribution targets associated to the work basket.void
setJNDINameOfStaffPluginProvider(java.lang.String jndiNameStaffProvider)
Sets the JNDI name of a user-defined people directory configuration.void
setOwner(java.lang.String owner)
Sets the owner of the work basket.void
setPeopleAssignment(int assignmentReason, PeopleAssignment people)
Sets the assignment reason for the specified people.void
setSubstitutionPolicy(int substitutionPolicy)
Sets the substitution policy that takes place when people assignments are performed.void
setType(int type)
Sets the type of the work basket.
-
-
-
Field Detail
-
COPYRIGHT
static final java.lang.String COPYRIGHT
- See Also:
- Constant Field Values
-
DEFAULT_CONTAINER_JNDI_NAME_OF_STAFF_PLUGIN_PROVIDER
static final java.lang.String DEFAULT_CONTAINER_JNDI_NAME_OF_STAFF_PLUGIN_PROVIDER
States the default value for getJNDINameOfStaffPluginProvider.- See Also:
- Constant Field Values
-
TYPE_GROUP
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:
- Constant Field Values
-
TYPE_CLEARANCE
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:
- Constant Field Values
-
TYPE_TOPIC
static final int TYPE_TOPIC
States that tasks contained in this work basket belong to a certain theme or topic.- See Also:
- Constant Field Values
-
TYPE_INDIVIDUAL
static final int TYPE_INDIVIDUAL
States that tasks contained in this work basket are assigned to a specific person.- See Also:
- Constant Field Values
-
SUBSTITUTION_POLICY_SELECT_USER_IF_PRESENT
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:
- Constant Field Values
-
SUBSTITUTION_POLICY_NO_SUBSTITUTION
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:
- Constant Field Values
-
SUBSTITUTION_POLICY_SUBSTITUTE_IF_ABSENT
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:
- Constant Field Values
-
-
Method Detail
-
getName
java.lang.String getName()
Returns the name of the work basket.
-
getType
int getType()
Returns the type of the work basket.Possible types are TYPE_GROUP, TYPE_TOPIC, TYPE_INDIVIDUAL, or TYPE_CLEARANCE.
-
getDisplayName
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
java.util.List getLocalesOfDisplayNames()
Returns the locales of all display names. Returns an empty list when there are no display names.
-
getDescription
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
java.util.List getLocalesOfDescriptions()
Returns the locales of all descriptions. Returns an empty list when there are no descriptions.
-
getOwner
java.lang.String getOwner()
Returns the owner of the work basket.
-
getDistributionTargets
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
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
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
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
java.lang.String getJNDINameOfStaffPluginProvider()
Returns the JNDI name of a user-defined people directory configuration.
-
getSubstitutionPolicy
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
java.lang.String getCustomText1()
Returns the custom text specified as custom text one. Returns null if not specified.
-
getCustomText2
java.lang.String getCustomText2()
Returns the custom text specified as custom text two. Returns null if not specified.
-
getCustomText3
java.lang.String getCustomText3()
Returns the custom text specified as custom text three. Returns null if not specified.
-
getCustomText4
java.lang.String getCustomText4()
Returns the custom text specified as custom text four. Returns null if not specified.
-
getCustomText5
java.lang.String getCustomText5()
Returns the custom text specified as custom text five. Returns null if not specified.
-
getCustomText6
java.lang.String getCustomText6()
Returns the custom text specified as custom text six. Returns null if not specified.
-
getCustomText7
java.lang.String getCustomText7()
Returns the custom text specified as custom text seven. Returns null if not specified.
-
getCustomText8
java.lang.String getCustomText8()
Returns the custom text specified as custom text eight. Returns null if not specified.
-
setType
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
boolean isTypeUpdateable()
Signals whether the type property can be changed for the kind and current state of the object.
-
setDisplayName
void setDisplayName(java.lang.String displayName, 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 calleddefault
which can be used to set the display name in the default language. The default language is specified by passing null ornew Locale("default")
.
-
isDisplayNameUpdateable
boolean isDisplayNameUpdateable()
Signals whether the display name property can be changed for the kind and current state of the object.
-
setDescription
void setDescription(java.lang.String description, 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 calleddefault
which can be used to set the description in the default language. The default language is specified by passing null ornew Locale("default")
.
-
isDescriptionUpdateable
boolean isDescriptionUpdateable()
Signals whether the description property can be changed for the kind and current state of the object.
-
setOwner
void setOwner(java.lang.String owner)
Sets the owner of the work basket.- Parameters:
owner
- The owner who is to be set.
-
isOwnerUpdateable
boolean isOwnerUpdateable()
Signals whether the owner property can be changed for the kind and current state of the object.
-
setDistributionTargets
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 bygetDistributionTargets
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
boolean isDistributionTargetsUpdateable()
Signals whether the source w b ID property can be changed for the kind and current state of the object.
-
setDefaultQueryTable
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
boolean isDefaultQueryTableUpdateable()
Signals whether the default query table property can be changed for the kind and current state of the object.
-
setJNDINameOfStaffPluginProvider
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
boolean isJNDINameOfStaffPluginProviderUpdateable()
Signals whether the jndi name staff provider property can be changed for the kind and current state of the object.
-
setSubstitutionPolicy
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
boolean isSubstitutionPolicyUpdateable()
Signals whether the substitution policy property can be changed for the kind and current state of the object.
-
setCustomText1
void setCustomText1(java.lang.String customText1)
Sets the custom text specified as custom text one.- Parameters:
customText1
- The custom text.
-
isCustomText1Updateable
boolean isCustomText1Updateable()
Signals whether the custom text 1 property can be changed for the kind and current state of the object.
-
setCustomText2
void setCustomText2(java.lang.String customText2)
Sets the custom text specified as custom text two.- Parameters:
customText2
- The custom text.
-
isCustomText2Updateable
boolean isCustomText2Updateable()
Signals whether the custom text 2 property can be changed for the kind and current state of the object.
-
setCustomText3
void setCustomText3(java.lang.String customText3)
Sets the custom text specified as custom text three.- Parameters:
customText3
- The custom text.
-
isCustomText3Updateable
boolean isCustomText3Updateable()
Signals whether the custom text 3 property can be changed for the kind and current state of the object.
-
setCustomText4
void setCustomText4(java.lang.String customText4)
Sets the custom text specified as custom text four.- Parameters:
customText4
- The custom text.
-
isCustomText4Updateable
boolean isCustomText4Updateable()
Signals whether the custom text 4 property can be changed for the kind and current state of the object.
-
setCustomText5
void setCustomText5(java.lang.String customText5)
Sets the custom text specified as custom text five.- Parameters:
customText5
- The custom text.
-
isCustomText5Updateable
boolean isCustomText5Updateable()
Signals whether the custom text 5 property can be changed for the kind and current state of the object.
-
setCustomText6
void setCustomText6(java.lang.String customText6)
Sets the custom text specified as custom text six.- Parameters:
customText6
- The custom text.
-
isCustomText6Updateable
boolean isCustomText6Updateable()
Signals whether the custom text 6 property can be changed for the kind and current state of the object.
-
setCustomText7
void setCustomText7(java.lang.String customText7)
Sets the custom text specified as custom text seven.- Parameters:
customText7
- The custom text.
-
isCustomText7Updateable
boolean isCustomText7Updateable()
Signals whether the custom text 7 property can be changed for the kind and current state of the object.
-
setCustomText8
void setCustomText8(java.lang.String customText8)
Sets the custom text specified as custom text eight.- Parameters:
customText8
- The custom text.
-
isCustomText8Updateable
boolean isCustomText8Updateable()
Signals whether the custom text 8 property can be changed for the kind and current state of the object.
-
setPeopleAssignment
void setPeopleAssignment(int assignmentReason, PeopleAssignment people)
Sets the assignment reason for the specified people. Possible reasons are:WorkItem.REASON_APPENDER
.WorkItem.REASON_CUSTOMROLE_1
.WorkItem.REASON_CUSTOMROLE_2
.WorkItem.REASON_CUSTOMROLE_3
.WorkItem.REASON_CUSTOMROLE_4
.WorkItem.REASON_CUSTOMROLE_5
.WorkItem.REASON_CUSTOMROLE_6
.WorkItem.REASON_CUSTOMROLE_7
.WorkItem.REASON_CUSTOMROLE_8
.WorkItem.REASON_CUSTOMROLE_9
.WorkItem.REASON_CUSTOMROLE_10
.WorkItem.REASON_CUSTOMROLE_11
.WorkItem.REASON_CUSTOMROLE_12
.WorkItem.REASON_CUSTOMROLE_13
.WorkItem.REASON_CUSTOMROLE_14
.WorkItem.REASON_CUSTOMROLE_15
.WorkItem.REASON_CUSTOMROLE_16
.WorkItem.REASON_CUSTOMROLE_17
.WorkItem.REASON_CUSTOMROLE_18
.WorkItem.REASON_CUSTOMROLE_19
.WorkItem.REASON_CUSTOMROLE_20
.WorkItem.REASON_DISTRIBUTOR
.WorkItem.REASON_INHERITANCE_ADMINISTRATOR
.WorkItem.REASON_INHERITANCE_EDITOR
.WorkItem.REASON_INHERITANCE_POTENTIAL_OWNER
.WorkItem.REASON_INHERITANCE_READER
.WorkItem.REASON_OPENER
.WorkItem.REASON_READER
.WorkItem.REASON_TRANSFER_INITIATOR
.- Parameters:
assignmentReason
- The assignment reason to be set.people
- The staff to be associated.
-
isPeopleAssignmentUpdateable
boolean isPeopleAssignmentUpdateable()
Signals whether the custom text 8 property can be changed for the kind and current state of the object.
-
-