GetItem operation (task)
Published: July 16, 2012
Applies to: Exchange 2013 | Exchange Online | Exchange Server 2007 | Exchange Server 2010 | apps for Office
The GetItem operation is used to get tasks from the Exchange store.
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.
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
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:
Note