Task

Provides information and actions for a task. A subtype of Message.

Properties

The following table lists properties along with their access and descriptions.

Property	Access	Description
Accepted	R/O	Boolean. TRUE if this task has been accepted.
Archived	R/W	Boolean. TRUE if this message has been archived.
AssignedDate	R/W	Date. The date and time to which this task is assigned. 0 = Master Task List item.
Autodate	R/O	Boolean. TRUE if this task has an auto-date.
AutodateMessages	R/O	MessageList. List includes current item.
Categories	R/O	Categories Collection. The collection of Category objects on this Mail, Appointment, Document Reference, Note, Phone Message, Task, or AddressBookEntry.
ChecklistCompleted	R/W	Boolean. TRUE if the item is part of the Checklist folder Messages collection or a Task item AND the item has been marked Completed. FALSE otherwise.
ChecklistCompletedDate	R/O	Date. The date this item was marked complete.
ChecklistDueDate	R/W	Date. The date this item should be Completed. Returns an error if the Message item is not a Task or is not part of the Checklist folder Messages collection.
ChecklistPercentComplete	R/W	Integer. Between 0 and 100 percent, how complete the checklist item is. If this value is set to a number outside the 0 to 100 range, an error is returned. If the value is set to 100, the item will also be marked complete.
ChecklisShowOnCalendarDate	R/W	Date. The date this item should appear on the calendar task list.
CommonMessageID	R/O	String. The ID of the message, regardless of its location. For example, an email will have the same CommonMessageID for both Sent and Received.
Completed	R/W	Boolean. TRUE if this task has been completed.
DelayedDeliveryDate	R/W	Date. When the Message.Send() method is called, the message is not delivered until the specified Date. This property can be used only on a Draft Message.
Delegated	R/O	Boolean. TRUE if this task has been delegated.
DeliveredDate	R/O	Date. The date and time this message item was delivered to the account.
DraftAutoDates	R/O	DraftAutoDates collection. The collection contains additional Dates which the Appointment, Note, or Task is created on.
DueDate	R/W	Date. The date and time this task is due to be completed.
Forwarded	R/O	Boolean. TRUE if this item has been forwarded to another user. Otherwise, FALSE.
MessageProperty	R/O	String. Based on the MessagePropertiesConstant passed in, a different string is returned.
NotifyWhenAccepted	R/W	Enum (NotifyMessageConstants). Specifies the type of notification to send when this task has been accepted.
NotifyWhenCompleted	R/W	Enum (NotifyMessageConstants). Specifies the type of notification to send when this task has been completed.
NotifyWhenDeclined	R/W	Enum (NotifyMessageConstants). Specifies the type of notification to send when this task has been declined.
OnCalendar	R/W	Boolean. TRUE if this task, should appear on a Calendar display.
Personal	R/O	Boolean. TRUE if this task is a personal task.
PersonalSubject	R/W	String. A text string to be shown by the GroupWise Windows client as the Subject text. This text appears only for the current user. The normal subject or their own Personal Subject text appears for other users.
Replied	R/O	Boolean. TRUE if this item has been replied to. Otherwise, FALSE.
Sharer	R/O	Address. The user who added this message to a shared folder. If this message was not added to a shared folder, this will be the same as the Sender property.
ShowOnChecklist	R/W	Boolean. TRUE if the item is part of the Checklist folder Messages collection. FALSE otherwise.
Size	R/O	Returns the size of the attachments and message body. If there are no attachments, only the size of the message body is returned.
StartDate	R/W	Date. The date and time this task is to start.
TaskCategory	R/W	String. Assigning a longer string causes an exception to be thrown.
TaskCompletedDate	R/O	Date. The date this item was marked complete.
TaskPercentComplete	R/W	Integer. Between 0 and 100 percent, how complete the checklist item is. If this value is set to a number outside the 0 to 100 range, an error is returned. If the value is set to 100, the item will also be marked complete.
TaskPriority	R/W	Long. The numerical priority of this task within its category.

Methods

Accept([String Comment], [Boolean AllInstances]): Accepts this task. Comment is the text you would like to send in reply as you accept the task. AllInstances is used for auto-date tasks. If AllInstances is set to TRUE, this method will accept all instances of the auto-dated task. Passing a value for AllInstances for a task that is not auto-dated is legal but ignored. If AllInstances is omitted, FALSE is assumed.
Appointment Delegate([Boolean AllInstances]): Delegate this task. AllInstances is used for auto-date tasks. If AllInstances is set to TRUE, this method will delegate all instances of the auto-dated task. Passing a value for AllInstances for a task that is not auto-dated is legal but ignored. If AllInstances is omitted, FALSE is assumed.
Decline([String Comment], [Boolean AllInstances]): Declines this task. Comment is the text you would like to send in reply as you decline the appointment. AllInstances is used for auto-date tasks. If AllInstances is set to TRUE, this method will decline all instances of the auto-dated task. Passing a value for AllInstances for a task that is not auto-dated is legal but ignored. If AllInstances is omitted, FALSE is assumed.
LocalDelete(): Deletes this message only from the currently connected post office database. No synchronization will take place between the master database and a remote database.
MoveToMasterTaskList(): Move this task to the master task list.
RemoveChecklistDueDate(): Removes the Checklist Due Date from the Message item. Returns an error if the item is not on the Checklist.

Remarks

When a Task object is refreshed, it updates the Message objects returned by its AutodateMessages property, but it does not recursively refresh the Message objects themselves.