2.2.4.6 t:TaskType Complex Type

The TaskType complex type specifies a task in the message store. The TaskType complex type extends the ItemType complex type, as specified in [MS-OXWSCORE] section 2.2.4.24.

 <xs:complexType name="TaskType">
   <xs:complexContent>
     <xs:extension
       base="t:ItemType"
     >
       <xs:sequence>
         <xs:element name="ActualWork"
           type="xs:int"
           minOccurs="0"
          />
         <xs:element name="AssignedTime"
           type="xs:dateTime"
           minOccurs="0"
          />
         <xs:element name="BillingInformation"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="ChangeCount"
           type="xs:int"
           minOccurs="0"
          />
         <xs:element name="Companies"
           type="t:ArrayOfStringsType"
           minOccurs="0"
          />
         <xs:element name="CompleteDate"
           type="xs:dateTime"
           minOccurs="0"
          />
         <xs:element name="Contacts"
           type="t:ArrayOfStringsType"
           minOccurs="0"
          />
         <xs:element name="DelegationState"
           type="t:TaskDelegateStateType"
           minOccurs="0"
          />
         <xs:element name="Delegator"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="DueDate"
           type="xs:dateTime"
           minOccurs="0"
          />
         <xs:element name="IsAssignmentEditable"
           type="xs:int"
           minOccurs="0"
          />
         <xs:element name="IsComplete"
           type="xs:boolean"
           minOccurs="0"
          />
         <xs:element name="IsRecurring"
           type="xs:boolean"
           minOccurs="0"
          />
         <xs:element name="IsTeamTask"
           type="xs:boolean"
           minOccurs="0"
          />
         <xs:element name="Mileage"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="Owner"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="PercentComplete"
           type="xs:double"
           minOccurs="0"
          />
         <xs:element name="Recurrence"
           type="t:TaskRecurrenceType"
           minOccurs="0"
          />
         <xs:element name="StartDate"
           type="xs:dateTime"
           minOccurs="0"
          />
         <xs:element name="Status"
           type="t:TaskStatusType"
           minOccurs="0"
          />
         <xs:element name="StatusDescription"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="TotalWork"
           type="xs:int"
           minOccurs="0"
          />
       </xs:sequence>
     </xs:extension>
   </xs:complexContent>
 </xs:complexType>

The following table lists and describes the child elements of the TaskType complex type.

Element name

Type

Description

ActualWork

xs:int [XMLSCHEMA2] section 3.3.17

Specifies an integer value that specifies the actual amount of time that is spent on a task.

AssignedTime

xs:dateTime [XMLSCHEMA2] section 3.2.7

Specifies an instance of the DateTime structure that contains the time when a task is assigned to a contact. This element is read-only for the client.

BillingInformation

xs:string [XMLSCHEMA2] section 3.2.1

Specifies a string value that contains billing information for a task.

ChangeCount

xs:int

Specifies an integer value that specifies the number of times the task has changed since it was created. This element is read-only for the client.

Companies

t:ArrayOfStringsType ([MS-OXWSCDATA] section 2.2.4.13)

Specifies an instance of an array of type string that represents a collection of companies that are associated with a task.

CompleteDate

xs:dateTime

Specifies an instance of the DateTime structure that represents the date on which a task is completed.

Contacts

t:ArrayOfStringsType

Specifies an instance of an array of type string that contains a list of contacts that are associated with a task.

DelegationState

t:TaskDelegateStateType (section 2.2.5.1)

Specifies one of the valid TaskDelegateStateType simple type enumeration values that represent the status of a delegated task.

Delegator

xs:string

Specifies a string value that contains the name of the delegator who assigned a task. This element is read-only for the client.

DueDate

xs:dateTime

Specifies an instance of the DateTime structure that represents the date when a task is due.

IsAssignmentEditable

xs:int

Specifies an integer value that represents whether the assignment of the task is editable. This element is read-only for the client.

IsComplete

xs:boolean [XMLSCHEMA2] section 3.2.2

Specifies a Boolean value that indicates whether a task has been completed. This element is read-only for the client.

IsRecurring

xs:boolean

Specifies a Boolean value that indicates whether a task is part of a recurring task. This element is read-only for the client.

IsTeamTask

xs:boolean

Specifies a Boolean value that indicates whether a task is owned by a team. This element is read-only for the client.

Mileage

xs:string

Specifies a string value that represents the mileage for a task.

Owner

xs:string

Specifies a string value that represents the owner of a task. Once the task item is created, this property is read-only for the client.<1>

PercentComplete

xs:double [XMLSCHEMA2] section 3.2.5

Specifies a double value from 0 through 100 that describes the completion status of a task.

Recurrence

t:TaskRecurrenceType section 2.2.4.4

Specifies an instance of the TaskRecurrenceType complex type that contains recurrence information for a recurring task.

StartDate

xs:dateTime

Specifies an instance of the DateTime structure that represents the start date of a task.

Status

t:TaskStatusType (section 2.2.5.2)

Specifies one of the valid TaskStatusType simple type enumeration values that represent the status of a task.

StatusDescription

xs:string

Specifies a string value that contains an explanation of the status of a task. This element is read-only for the client.

TotalWork

xs:int

Specifies an integer value that represents the total amount of work that is associated with a task.

Setting CompleteDate has the same effect as setting PercentComplete to 100 or Status to Completed. In a request that sets at least two of these properties, the last processed property will determine the value that is set for these elements. For example, if PercentComplete is 100, CompleteDate is January 1, 2007, and Status is NotStarted, and the properties are streamed in that order, the effect will be to set the Status of the task to NotStarted, the CompleteDate to null, and PercentComplete to 0.

Show: