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/2] 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/2] 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/2] 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/2] 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/2] 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.