CreateItem operation (task)
The CreateItem operation creates task items in the Exchange store.
Task CreateItem Request
Description
The following example of a CreateItem request shows how to create a task item in a mailbox.
Code
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<CreateItem xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
MessageDisposition="SaveOnly">
<Items>
<t:Task>
<t:Subject>My task</t:Subject>
<t:DueDate>2006-10-26T21:32:52</t:DueDate>
<t:Status>NotStarted</t:Status>
</t:Task>
</Items>
</CreateItem>
</soap:Body>
</soap:Envelope>
Comments
Requests for recurring tasks are altered when they are received by the computer that is running Microsoft Exchange Server 2007 that has the Client Access server role installed. The following changes occur:
Only the date is saved for the StartDate (Recurrence) property of the recurrence range of the task. The time part is truncated.
The StartDate (Recurrence) property may be adjusted, depending on the recurrence pattern. For example, if the recurrence pattern is specified as every Monday and the StartDate is set to October 26, 2006, which is a Thursday, StartDate is adjusted to October 30, 2006, which is the next Monday.
If the StartDate property of the task is set, it is updated to match the StartDate (Recurrence) of the recurrence range. The DueDate property of the task is also updated based on the new StartDate.
If the StartDate is not set, only the DueDate property is updated to match the StartDate (Recurrence) of the recurrence range.
The following table shows the changes that the Client Access server makes to a recurring task that has a Task.Recurrence.Pattern of every Monday.
Changes to a recurring task
| Property | Original Value | Updated Value |
|---|---|---|
| Task.StartDate |
January 1, 2006 |
October 30, 2006 |
| Task.DueDate |
January 3, 2006 |
November 1, 2006 |
| Task.Recurrence.Range.StartDate |
October 26, 2006 |
October 30, 2006 |
By default, if a destination folder is not specified, task items are created in the Tasks folder.
Request elements
The following elements are used in the request:
Successful Task CreateItem Response
Description
The following example shows a successful response to the CreateItem request.
Code
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="653" MinorBuildNumber="0"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"/>
</soap:Header>
<soap:Body>
<CreateItemResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseMessages>
<m:CreateItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Items>
<t:Task>
<t:ItemId Id="AAAtAE=" ChangeKey="EwAAABYA"/>
</t:Task>
</m:Items>
</m:CreateItemResponseMessage>
</m:ResponseMessages>
</CreateItemResponse>
</soap:Body>
</soap:Envelope>
Successful response elements
The following elements are included in the response: