GetItem operation (task)
The GetItem operation is used to get tasks from the Exchange store.
Remarks
The format of the GetItem request for tasks is the same as GetItem for any other item type. The only difference is in which additional properties can be requested within the response shape. Such additional properties must either be task-related properties or extended properties.
Task GetItem request example
Description
The following example of a GetItem request shows how to get a task item.
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>
<GetItem xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<ItemShape>
<t:BaseShape>AllProperties</t:BaseShape>
</ItemShape>
<ItemIds>
<t:ItemId Id="AAAtAEFkb..."/>
</ItemIds>
</GetItem>
</soap:Body>
</soap:Envelope>
Comments
Note
The item identifier and change key have been shortened to preserve readability.
Request elements
The following elements are used in the request:
Task GetItem response example
Description
The following example shows a successful response to a GetItem 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="662" MinorBuildNumber="0"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"/>
</soap:Header>
<soap:Body>
<GetItemResponse 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:GetItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Items>
<t:Task>
<t:ItemId Id="AAAtAEA=" ChangeKey="EwAAAB"/>
<t:ParentFolderId Id="AAAtAEFkbWl=" ChangeKey="AQAAAA=="/>
<t:ItemClass>IPM.Task</t:ItemClass>
<t:Subject>Buy new shoes</t:Subject>
<t:Sensitivity>Normal</t:Sensitivity>
<t:Body BodyType="Text"/>
<t:DateTimeReceived>2006-09-15T15:23:08Z</t:DateTimeReceived>
<t:Size>153</t:Size>
<t:Importance>Normal</t:Importance>
<t:IsSubmitted>false</t:IsSubmitted>
<t:IsDraft>true</t:IsDraft>
<t:IsFromMe>false</t:IsFromMe>
<t:IsResend>false</t:IsResend>
<t:IsUnmodified>false</t:IsUnmodified>
<t:DateTimeSent>2006-09-15T15:23:08Z</t:DateTimeSent>
<t:DateTimeCreated>2006-09-15T15:23:08Z</t:DateTimeCreated>
<t:HasAttachments>false</t:HasAttachments>
<t:Culture>en-US</t:Culture>
<t:ChangeCount>1</t:ChangeCount>
<t:IsComplete>false</t:IsComplete>
<t:IsRecurring>false</t:IsRecurring>
<t:PercentComplete>0</t:PercentComplete>
<t:Status>NotStarted</t:Status>
<t:StatusDescription>Not Started</t:StatusDescription>
</t:Task>
</m:Items>
</m:GetItemResponseMessage>
</m:ResponseMessages>
</GetItemResponse>
</soap:Body>
</soap:Envelope>
Comments
Note
The item and folder identifiers and change keys have been shortened to preserve readability.
Successful response elements
The following elements are used in the response: