com.compoze.collab.exchange
Interface IExchangeTask

All Superinterfaces:

IAttachmentSupport, IExchangeItem, IGroupwareItem, IItem, com.compoze.collab.messaging.IMessagingItem, ITask, java.io.Serializable

All Known Subinterfaces:

IMapiTask

public interface IExchangeTask
extends ITask, IExchangeItem

The IExchangeTask class represents a task in Exchange. Tasks include regular tasks, recurring tasks, regenerative tasks, and assigned tasks.

Field Summary

static Key	ACTUAL_WORK Key that represents the actual work for a task.
static Key	ASSOCIATED_TASK_LINK Represents the property that holds the link between a task and task requests / task notices.
static Key	BILLING_INFO Key that represents the billing info for a task.
static ItemClass	CLASS The ItemClass that represents an Exchange task.
static Key	COMPANIES Key that represents the companies for a task.
static Key	DELEGATOR Key that represents the total work for a task.
static Key	DUE_CALENDAR Key that represents the due calendar for a task.
static Key	IS_COMPLETE Key that represents the 'is complete' for a task.
static Key	IS_TEAM_TASK Key that represents the 'is team task' for a task.
static int	KEYID_ACTUAL_WORK The int ID for the ACTUAL_WORK key.
static int	KEYID_ASSOCIATED_TASK_LINK The int ID for the ASSOCIATED_TASK_LINK key.
static int	KEYID_BILLING_INFO The int ID for the BILLING_INFO key.
static int	KEYID_COMPANIES The int ID for the COMPANIES key.
static int	KEYID_DELEGATOR The int ID for the DELEGATOR key.
static int	KEYID_DUE_CALENDAR The int ID for the DUE_CALENDAR key.
static int	KEYID_IS_COMPLETE The int ID for the IS_COMPLETE key.
static int	KEYID_IS_TEAM_TASK The int ID for the IS_TEAM_TASK key.
static int	KEYID_OWNER The int ID for the OWNER key.
static int	KEYID_PERCENT_COMPLETE The int ID for the ITask.PERCENT_COMPLETE key.
static int	KEYID_RECURRENCE_PATTERN The int ID for the RECURRENCE_PATTERN key.
static int	KEYID_REMINDER_DATE The int ID for the REMINDER_DATE key.
static int	KEYID_START_CALENDAR The int ID for the START_CALENDAR key.
static int	KEYID_TOTAL_WORK The int ID for the TOTAL_WORK key.
static Key	OWNER Key that represents the total work for a task.
static Key	RECURRENCE_PATTERN Key that represents the recurrence pattern for a task.
static Key	REMINDER_DATE Key that represents the reminder date for a task.
static Key	START_CALENDAR Key that represents the start calendar for a task.
static Key	TOTAL_WORK Key that represents the total work for a task.

Fields inherited from interface com.compoze.collab.groupware.ITask

DATE_COMPLETED, DUE_DATE, IS_RECURRING, KEYID_DATE_COMPLETED, KEYID_DUE_DATE, KEYID_IS_RECURRING, KEYID_START_DATE, KEYID_STATUS, PERCENT_COMPLETE, START_DATE, STATUS

Fields inherited from interface com.compoze.collab.groupware.IGroupwareItem

CATEGORIES, DATE_CREATED, DATE_LAST_MODIFIED, IMPORTANCE, KEYID_CATEGORIES, KEYID_DATE_CREATED, KEYID_DATE_LAST_MODIFIED, KEYID_IMPORTANCE, KEYID_SIZE, KEYID_SUBJECT, SIZE, SUBJECT

Fields inherited from interface com.compoze.collab.messaging.IMessagingItem

BODY, BODY_HTML, KEYID_BODY, KEYID_BODY_HTML

Fields inherited from interface com.compoze.collab.IItem

ID, ITEM_CLASS, KEYID_ID, KEYID_ITEM_CLASS, KEYID_PARENT_ID, MINIMUM_ITEM_KEYS, PARENT_ID

Fields inherited from interface com.compoze.collab.exchange.IExchangeItem

CONTACT_NAMES, CREATOR_ENTRYID, FLAG, FLAG_REMIND_BY, FLAG_TEXT, HAS_REMINDER, HIDE_ATTACHMENTS, ICON_INDEX, IS_HIDDEN, KEYID_CONTACT_NAMES, KEYID_CREATOR_ENTRYID, KEYID_FLAG, KEYID_FLAG_REMIND_BY, KEYID_FLAG_TEXT, KEYID_HAS_REMINDER, KEYID_HIDE_ATTACHMENTS, KEYID_ICON_INDEX, KEYID_IS_HIDDEN, KEYID_MILEAGE, KEYID_NORMALIZED_SUBJECT, KEYID_PRIORITY, KEYID_SENSITIVITY, KEYID_SUBJECT_PREFIX, MILEAGE, NORMALIZED_SUBJECT, PRIORITY, SENSITIVITY, SUBJECT_PREFIX

Fields inherited from interface com.compoze.collab.IAttachmentSupport

ATTACHMENTS, HAS_ATTACHMENT, KEYID_ATTACHMENTS, KEYID_HAS_ATTACHMENT

Method Summary

void	decline(boolean bSend, boolean bSaveInSent) Declines the task, if it is has already been accepted.
int	getActualWork() Gets the actual work.
java.lang.String	getBillingInfo() Gets the billing info.
java.lang.String[]	getCompanies() Gets the companies.
java.lang.String	getDelegator() Gets the delegator.
java.util.Calendar	getDueCalendar() Gets the due calendar.
boolean	getHasReminder() Gets the 'has reminder' flag.
java.lang.String	getOwner() Gets the owner.
double	getPercentComplete() Gets the percent complete.
TaskRecurrencePattern	getRecurrencePattern() Gets the recurrence pattern.
java.util.Date	getReminderDate() Gets the reminder date.
java.util.Calendar	getStartCalendar() Gets the start calendar.
int	getTotalWork() Gets the total work.
boolean	isComplete() Gets whether the task is complete.
boolean	isCurrentUserRecipient() Returns if the current user is a recipient of the task.
boolean	isTeamTask() Gets if the task is a team assigned task.
void	markComplete(boolean bComplete, boolean bSend, boolean bSaveInSent) Marks the task as complete and commits the changes to the Exchange store.
void	setActualWork(int iActualWork) Sets the actual work.
void	setBillingInfo(java.lang.String sBillingInfo) Sets the billing info.
void	setCompanies(java.lang.String[] sCompanies) Sets the companies.
void	setDelegator(java.lang.String sDelegator) Sets the delegator.
void	setHasReminder(boolean bHasReminder) Sets the 'has reminder' flag.
void	setOwner(java.lang.String sOwner) Sets the owner.
void	setPercentComplete(double dPercentComplete) Sets the percent complete.
void	setRecurrencePattern(TaskRecurrencePattern pattern) Sets the recurrence pattern.
void	setReminderDate(java.util.Date reminderDate) Sets the reminder date.
void	setStatus(TaskStatus status) Sets the status of the task.
void	setTotalWork(int iTotalWork) Sets the total work.
void	skip() Skips an instance of a task, if it is a recurring task.

Methods inherited from interface com.compoze.collab.groupware.ITask

getDateCompleted, getDueDate, getStartDate, getStatus, isRecurring, setDateCompleted, setDueDate, setDueDate, setStartDate, setStartDate

Methods inherited from interface com.compoze.collab.groupware.IGroupwareItem

getBodyHtml, getBodyHtml, getCategories, getDateCreated, getDateLastModified, getImportance, getNormalizedSubject, getSize, getSubject, getSubject, getSubjectPrefix, setBodyHtml, setCategories, setImportance, setSubject

Methods inherited from interface com.compoze.collab.messaging.IMessagingItem

getBody, setBody

Methods inherited from interface com.compoze.collab.IItem

commit, containsKey, containsKey, copyProperties, copyTo, delete, fetchProperties, getAttribute, getEnum, getID, getInputStream, getItemClass, getOutputStream, getParent, getParent, getParentID, getProperties, getProperties, getProperties, getProperty, getProperty, getProperty, getReader, getRootContainer, getSession, getWriter, isMissing, moveTo, removeAttribute, removeProperty, setAttribute, setProperties, setProperty, setProperty, setProperty

Methods inherited from interface com.compoze.collab.exchange.IExchangeItem

getContactNames, getFlagStatus, getFlagText, getHideAttachments, getMileage, getPriority, getSensitivity, getSubjectPrefix, isHidden, setContactNames, setFlagStatus, setFlagText, setHideAttachments, setMileage, setPriority, setSensitivity, setSubjectPrefix

Methods inherited from interface com.compoze.collab.IAttachmentSupport

addAttachment, getAttachment, getAttachmentCount, getAttachments, hasAttachment

Field Detail

KEYID_ACTUAL_WORK

static final int KEYID_ACTUAL_WORK

The int ID for the ACTUAL_WORK key.

See Also:

Constant Field Values

KEYID_BILLING_INFO

static final int KEYID_BILLING_INFO

The int ID for the BILLING_INFO key.

See Also:

Constant Field Values

KEYID_COMPANIES

static final int KEYID_COMPANIES

The int ID for the COMPANIES key.

See Also:

Constant Field Values

KEYID_DUE_CALENDAR

static final int KEYID_DUE_CALENDAR

The int ID for the DUE_CALENDAR key.

See Also:

Constant Field Values

KEYID_IS_COMPLETE

static final int KEYID_IS_COMPLETE

The int ID for the IS_COMPLETE key.

See Also:

Constant Field Values

KEYID_IS_TEAM_TASK

static final int KEYID_IS_TEAM_TASK

The int ID for the IS_TEAM_TASK key.

See Also:

Constant Field Values

KEYID_OWNER

static final int KEYID_OWNER

The int ID for the OWNER key.

See Also:

Constant Field Values

KEYID_PERCENT_COMPLETE

static final int KEYID_PERCENT_COMPLETE

The int ID for the ITask.PERCENT_COMPLETE key.

See Also:

Constant Field Values

KEYID_RECURRENCE_PATTERN

static final int KEYID_RECURRENCE_PATTERN

The int ID for the RECURRENCE_PATTERN key.

See Also:

Constant Field Values

KEYID_REMINDER_DATE

static final int KEYID_REMINDER_DATE

The int ID for the REMINDER_DATE key.

See Also:

Constant Field Values

KEYID_START_CALENDAR

static final int KEYID_START_CALENDAR

The int ID for the START_CALENDAR key.

See Also:

Constant Field Values

KEYID_TOTAL_WORK

static final int KEYID_TOTAL_WORK

The int ID for the TOTAL_WORK key.

See Also:

Constant Field Values

KEYID_DELEGATOR

static final int KEYID_DELEGATOR

The int ID for the DELEGATOR key.

See Also:

Constant Field Values

KEYID_ASSOCIATED_TASK_LINK

static final int KEYID_ASSOCIATED_TASK_LINK

The int ID for the ASSOCIATED_TASK_LINK key.

See Also:

Constant Field Values

ACTUAL_WORK

static final Key ACTUAL_WORK

Key that represents the actual work for a task.

BILLING_INFO

static final Key BILLING_INFO

Key that represents the billing info for a task.

COMPANIES

static final Key COMPANIES

Key that represents the companies for a task.

DUE_CALENDAR

static final Key DUE_CALENDAR

Key that represents the due calendar for a task.

IS_COMPLETE

static final Key IS_COMPLETE

Key that represents the 'is complete' for a task.

IS_TEAM_TASK

static final Key IS_TEAM_TASK

Key that represents the 'is team task' for a task.

RECURRENCE_PATTERN

static final Key RECURRENCE_PATTERN

Key that represents the recurrence pattern for a task.

REMINDER_DATE

static final Key REMINDER_DATE

Key that represents the reminder date for a task.

START_CALENDAR

static final Key START_CALENDAR

Key that represents the start calendar for a task.

TOTAL_WORK

static final Key TOTAL_WORK

Key that represents the total work for a task.

DELEGATOR

static final Key DELEGATOR

Key that represents the total work for a task.

OWNER

static final Key OWNER

Key that represents the total work for a task.

ASSOCIATED_TASK_LINK

static final Key ASSOCIATED_TASK_LINK

Represents the property that holds the link between a task and task requests / task notices.

CLASS

static final ItemClass CLASS

The ItemClass that represents an Exchange task.

Method Detail

setActualWork

void setActualWork(int iActualWork)
                   throws CollaborationException

Sets the actual work.

Parameters:

iActualWork - the actual work

Throws:

CollaborationException - if there was an error setting the actual work

getActualWork

int getActualWork()
                  throws CollaborationException

Gets the actual work.

Returns:

the actual work

Throws:

CollaborationException - if there was an error getting the actual work

PropertyMissingException - if the property was requested but not available

See Also:

ACTUAL_WORK

setBillingInfo

void setBillingInfo(java.lang.String sBillingInfo)
                    throws CollaborationException

Sets the billing info.

Parameters:

sBillingInfo - the billing info

Throws:

CollaborationException - if there was an error setting the billing info

getBillingInfo

java.lang.String getBillingInfo()
                                throws CollaborationException

Gets the billing info.

Returns:

the billing info

Throws:

CollaborationException - if there was an error getting the billing info

See Also:

setBillingInfo(String)

setCompanies

void setCompanies(java.lang.String[] sCompanies)
                  throws CollaborationException

Sets the companies.

Parameters:

sCompanies - the companies

Throws:

CollaborationException - if there was an error setting the companies

getCompanies

java.lang.String[] getCompanies()
                                throws CollaborationException

Gets the companies.

Returns:

the companies

Throws:

CollaborationException - if there was an error getting the companies

See Also:

setCompanies(String[])

setDelegator

void setDelegator(java.lang.String sDelegator)
                  throws CollaborationException

Sets the delegator.

Parameters:

sDelegator - the delegator for this task.

Throws:

CollaborationException - if there was an error setting the delegator

getDelegator

java.lang.String getDelegator()
                              throws CollaborationException

Gets the delegator.

Returns:

the delegator

Throws:

CollaborationException - if there was an error getting the delegator

See Also:

setDelegator(String)

setOwner

void setOwner(java.lang.String sOwner)
              throws CollaborationException

Sets the owner.

Parameters:

sOwner - the owner for this task.

Throws:

CollaborationException - if there was an error setting the owner

getOwner

java.lang.String getOwner()
                          throws CollaborationException

Gets the owner.

Returns:

the owner

Throws:

CollaborationException - if there was an error getting the owner

See Also:

setOwner(String)

getDueCalendar

java.util.Calendar getDueCalendar()
                                  throws CollaborationException

Gets the due calendar.

Returns:

the due calendar

Throws:

CollaborationException - if there was an error getting the due calendar

setHasReminder

void setHasReminder(boolean bHasReminder)
                    throws CollaborationException

Sets the 'has reminder' flag.

Parameters:

bHasReminder - the 'has reminder' flag

Throws:

CollaborationException - if there was an error setting the 'has reminder' flag

getHasReminder

boolean getHasReminder()
                       throws CollaborationException

Gets the 'has reminder' flag.

Returns:

the 'has reminder' flag

Throws:

CollaborationException - if there was an error getting the 'has reminder' flag

PropertyMissingException - if the property was requested but not available

See Also:

setHasReminder(boolean)

setPercentComplete

void setPercentComplete(double dPercentComplete)
                        throws CollaborationException

Sets the percent complete. Depending on the percent complete value supplied, other values on a task will automatically change. Requires the IS_COMPLETE key.

== 1.0:

• ITask.STATUS to COMPLETED.
• IExchangeTask.IS_COMPLETE to true.

== 0.0:

• ITask.STATUS to NOT_STARTED.
• IExchangeTask.IS_COMPLETE to false.
• IExchangeTask.DATE_COMPLETE to null.

< 1.0 && > 0.0 and isComplete() is true:

• ITask.STATUS to IN_PROGRESS.
• IExchangeTask.IS_COMPLETE to false.
• IExchangeTask.DATE_COMPLETE to null.

Specified by:

setPercentComplete in interface ITask

Parameters:

dPercentComplete - the percent complete. This value must be >= 0.0, and <= 1.0.

Throws:

CollaborationException - if there was an error setting the percent complete

See Also:

IS_COMPLETE

getPercentComplete

double getPercentComplete()
                          throws CollaborationException

Gets the percent complete.

Specified by:

getPercentComplete in interface ITask

Returns:

the percent complete

Throws:

CollaborationException - if there was an error getting the percent complete

PropertyMissingException - if the property was requested but not available

See Also:

setPercentComplete(double)

setRecurrencePattern

void setRecurrencePattern(TaskRecurrencePattern pattern)
                          throws CollaborationException

Sets the recurrence pattern. Automatically updates ITask.IS_RECURRING to reflect the specified pattern.

Parameters:

pattern - the recurrence pattern. If set to null, then the pattern is removed from the task.

Throws:

CollaborationException - if there was an error setting the recurrence pattern

getRecurrencePattern

TaskRecurrencePattern getRecurrencePattern()
                                           throws CollaborationException

Gets the recurrence pattern.

Returns:

the recurrence pattern

Throws:

CollaborationException - if there was an error getting the recurrence pattern

See Also:

setRecurrencePattern(TaskRecurrencePattern)

setReminderDate

void setReminderDate(java.util.Date reminderDate)
                     throws CollaborationException

Sets the reminder date.

Parameters:

reminderDate - the reminder date. (null implies no reminder date and removes the reminder from the task).

Throws:

CollaborationException - if there was an error setting the reminder date

getReminderDate

java.util.Date getReminderDate()
                               throws CollaborationException

Gets the reminder date.

Returns:

the reminder date

Throws:

CollaborationException - if there was an error getting the reminder date

See Also:

setReminderDate(Date)

getStartCalendar

java.util.Calendar getStartCalendar()
                                    throws CollaborationException

Gets the start calendar.

Returns:

the start calendar

Throws:

CollaborationException - if there was an error getting the start calendar

setTotalWork

void setTotalWork(int iTotalWork)
                  throws CollaborationException

Sets the total work.

Parameters:

iTotalWork - the total work

Throws:

CollaborationException - if there was an error setting the total work

getTotalWork

int getTotalWork()
                 throws CollaborationException

Gets the total work.

Returns:

the total work

Throws:

CollaborationException - if there was an error getting the total work

PropertyMissingException - if the property was requested but not available

See Also:

setTotalWork(int)

isComplete

boolean isComplete()
                   throws CollaborationException

Gets whether the task is complete.

Returns:

whether the task is complete

Throws:

CollaborationException - if there was an error getting the complete status

PropertyMissingException - if the property was requested but not available

isCurrentUserRecipient

boolean isCurrentUserRecipient()
                               throws CollaborationException

Returns if the current user is a recipient of the task.

Returns:

true if the current user is a recipient of the task

Throws:

CollaborationException - if there was an error getting the current recipient

isTeamTask

boolean isTeamTask()
                   throws CollaborationException

Gets if the task is a team assigned task.

Returns:

true if the task is a team assigned task

Throws:

CollaborationException - if there was an error getting if the task is assigned

PropertyMissingException - if the property was requested but not available

decline

void decline(boolean bSend,
             boolean bSaveInSent)
             throws CollaborationException

Declines the task, if it is has already been accepted.

Parameters:

bSend - sends a decline message back to the task originator.

bSaveInSent - if sending, save to sent items

Throws:

OperationUnsupportedException - always

CollaborationException

skip

void skip()
          throws CollaborationException

Skips an instance of a task, if it is a recurring task.

Throws:

CollaborationException - if there was an error skipping a task instance

markComplete

void markComplete(boolean bComplete,
                  boolean bSend,
                  boolean bSaveInSent)
                  throws CollaborationException

Marks the task as complete and commits the changes to the Exchange store. If IS_RECURRING, then creates the next task in the series, if one exists.

Specified by:

markComplete in interface ITask

Parameters:

bComplete - true if the task is completed, false otherwise

bSend - true to send the status if needed

bSaveInSent - if sending, true to save a copy

Throws:

CollaborationException - if there was an error updating the task

See Also:

RECURRENCE_PATTERN, IS_COMPLETE, ITask.DUE_DATE, ITask.IS_RECURRING

setStatus

void setStatus(TaskStatus status)
               throws CollaborationException

Sets the status of the task. Depending on the status value supplied, other values on a task will automatically change. Requires the IS_COMPLETE key.

TaskStatusEnum.COMPLETED:

• IExchangeTask.PERCENT_COMPLETE to 1.0.
• IExchangeTask.IS_COMPLETE to true.

TaskStatusEnum.NOT_STARTED:

• IExchangeTask.PERCENT_COMPLETE to 0.0.
• IExchangeTask.IS_COMPLETE to false.
• IExchangeTask.DATE_COMPLETE to null.

Any other status and isComplete() is true:

• IExchangeTask.PERCENT_COMPLETE to 0.0.
• IExchangeTask.IS_COMPLETE to false.
• IExchangeTask.DATE_COMPLETE to null.

Specified by:

setStatus in interface ITask

Parameters:

status - the status

Throws:

CollaborationException - if there was an error setting the status