RDOTaskItem object |
RDOTaskItem object represents an "IPM.Task" message in one of Outlook Task folders. RDOTaskItem is derived from the RDOMail object and as such inherits all the properties, methods and events implemented by the RDOMail object.
Everywhere RDOMail object is normally returned (RDOSession.GetMessageFromID, RDOFolder.Items, etc), RDOTaskItem will be returned if the message class is "IPM.Task".
The example below logs to the default profile, then creates and sends a task request to 3 recipients.
set Session =
CreateObject("Redemption.RDOSession") |
Derived from: RDOMailIn addition to all the properties and methods specific to RDONoteItem, it also implements all properties, methods and events of the RDOMail object, from which it is derived. |
|||
|
|||
Properties |
|||
|
|||
ActualWork |
Returns or sets a Long indicating the actual effort (in minutes) spent on the task. Read/write.
|
||
CardData |
Returns or sets a String representing the text of the card data for the task. Read/write.
|
||
Complete |
True if the task is completed. Read/write Boolean.
|
||
ContactNames |
Sets or returns a String representing the contact names associated with the task item or journal entry. Read/write.
|
|
|
Contacts |
Returns an array of String representing the contact names associated with the task item or journal entry. Read-only.
|
|
|
DateCompleted |
Returns or sets a Date indicating the completion date of the task. Read/write.
|
|
|
DelegationState |
Returns an
rdoTaskDelegationState constant indicating the delegation state of the
task. Read-only. |
|
|
Delegator |
Returns a String representing the display name of the delegator for the task. Read-only.
|
|
|
DueDate |
Returns or sets a Date indicating the due date for the task. Read/write.
|
|
|
IsRecurring |
True if the task is a
recurring task. When the GetRecurrencePattern method is used with an
RDOTaskItem object, this property is set to True. Read-only Boolean. |
|
|
Ordinal |
Returns or sets a Long specifying the position in the view (ordinal) for the task. Read/write.
|
|
|
Owner |
Returns or sets a String indicating the owner for the task. This is a free-form string field. Setting this property to someone other than the current user does not have the effect of delegating the task. Read/write if the task is stored on the Exchange Server public folder. Read-only if it's stored in a user's mailbox or personal folders file.
|
|
|
Ownership |
Returns an rdoTaskOwnership
specifying the ownership state of the task. Read-only. |
|
|
RecurrenceState |
Returns an rdoRecurrenceState
constant indicating the recurrence property of the specified object.
Read-only. RecurrenceState can be one of
these rdoRecurrenceState constants. |
|
|
PercentComplete |
Returns or sets a Long indicating the percentage of the task completed at the current date and time. Read/write.
|
|
|
ResponseState |
Returns an rdoTaskResponse
constant indicating the overall status of the response to the specified
task request. Read-only.
This
method is not implemented in the current version of Redemption. |
|
|
Role |
Returns or sets a String containing the free-form text string associating the owner of a task with a role for the task. Read/write.
|
|
|
SchedulePlusPriority |
Returns or sets a String
representing the Microsoft Schedule+ priority for the task. Can be 1
through 9, A through Z, or A1 through Z9. Priority 1 is the highest.
Read/write. |
|
|
StartDate |
Returns or sets a Date specifying the starting date and time for the specified task. Read/write.
|
|
|
Status |
Returns or sets an
rdoTaskStatus constant specifying the status for the task. Corresponds
to the Status field of a TaskItem. Read/write. |
|
|
StatusOnCompletionRecipients |
Returns or sets a
semicolon-delimited String of display names for recipients who will
receive status upon completion of the task. This property is calculated
from the Recipients property. Recipients returned by the
StatusOnCompletionRecipients property correspond to BCC recipients in
the Recipients collection. Read/write. |
|
|
StatusUpdateRecipients |
Returns a semicolon-delimited
String of display names for recipients who receive status updates for
the task. This property is calculated from the Recipients property.
Recipients returned by the StatusUpdateRecipients property correspond to
CC recipients in the Recipients collection. Read-only. |
|
|
TeamTask |
True if the task is a team task. Read/write Boolean.
|
|
|
TotalWork |
Returns or sets a Long
indicating the total work for the task. Corresponds to the Total work
field on the Details tab of a Task item. Read/write. |
|
|
Methods |
|||
|
|||
Assign |
Assigns a task and returns a
an RDOTaskItem object that represents it. This method allows a task to
be assigned (delegated) to another user. You must create a task before
you can assign it, and you must assign a task before you can send it. An
assigned task is sent as a TaskRequestItem object. |
||
CancelResponseState |
Resets an unsent response to
a task request back to a simple task. After you receive a task request
and respond to it, but before sending the response, you can use this
method to revert the task to its state before you responded. |
||
ClearRecurrencePattern |
Removes the recurrence
settings and restores the single-occurrence state for an appointment or
task. |
||
GetRecurrencePattern |
Returns an
RDORecurrencePattern object that
represents the recurrence attributes of an appointment. If there
is no existing recurrence pattern, a new empty RDORecurrencePattern
object is returned. |
set Session =
CreateObject("Redemption.RDOSession") set Task =
Session.GetDefaultFolder(olFolderTasks).Items.Add |
|
MarkComplete |
Marks the task as completed.
Sets PercentComplete to "100%", Complete to True, and DateCompleted to
the current date. |
||
Respond(Response, fNoUI, fAdditionalTextDialog) |
Responds to a task request
for the TaskItem object.
This method is not implemented in the current version of Redemption.
|
|
|
SkipRecurrence |
Clears the current instance of a recurring task and sets the recurrence to the next instance of that task.
This method is not implemented in the current version of Redemption.
|
|
|
StatusReport |
Sends a status report to all
Cc recipients (recipients returned by the StatusUpdateRecipients
property) with the current status for the task. Returns an Object
representing the status report. |
|
|
|