3.1.4.6 UpdateItem Operation

The UpdateItem operation updates Post objects on the server. This operation is specified in [MS-OXWSCORE] section 3.1.4.9.

The following is the WSDL port type specification for the UpdateItem operation.

 <wsdl:operation name="UpdateItem">
      <wsdl:input message="tns:UpdateItemSoapIn" />
      <wsdl:output message="tns:UpdateItemSoapOut" />
 </wsdl:operation>

The following is the WSDL binding specification for the UpdateItem operation.

 <wsdl:operation name="UpdateItem">
    <soap:operation soapAction="http://schemas.microsoft.com/exchange/services/2006/messages/UpdateItem"/>
    <wsdl:input>
       <soap:header message="tns:UpdateItemSoapIn" part="Impersonation" use="literal"/>
       <soap:header message="tns:UpdateItemSoapIn" part="MailboxCulture" use="literal"/>
       <soap:header message="tns:UpdateItemSoapIn" part="RequestVersion" use="literal"/>
       <soap:header message="tns:UpdateItemSoapIn" part="TimeZoneContext" use="literal"/>
       <soap:body parts="request" use="literal"/>
    </wsdl:input>
    <wsdl:output>
       <soap:body parts="UpdateItemResult" use="literal"/>
       <soap:header message="tns:UpdateItemSoapOut" part="ServerVersion" use="literal"/>
    </wsdl:output>
 </wsdl:operation>

The following table summarizes the set of WSDL message definitions that are specific to the UpdateItem operation.

Message name

Description

UpdateItemSoapIn

The UpdateItemSoapIn message is specified in [MS-OXWSCORE] section 3.1.4.9.1.1. It specifies the UpdateItem operation request to update one or more Post objects on the server.

The UpdateItem element ([MS-OXWSCORE] section 3.1.4.9.2.1) that specifies the XML request MUST contain an ItemChanges element ([MS-OXWSCORE] section 3.1.4.9.3.2) that contains one or more ItemChange elements ([MS-OXWSCORE] section 3.1.4.9.3.9).

Each ItemChange element MUST contain an ItemId child element ([MS-OXWSCORE] section 3.1.4.9.3.7) with an Id attribute ([MS-OXWSCORE] section 2.2.4.25) that identifies the Post object.

An ItemChange element MUST NOT contain an OccurrenceId child element ([MS-OXWSCORE] section 3.1.4.9.3.7) or a RecurringMasterItemId child element ([MS-OXWSCORE] section 3.1.4.9.3.7) for a change to a Post object.

Each AppendToItemField element ([MS-OXWSCORE] section 3.1.4.9.3.8) and SetItemField element ([MS-OXWSCORE] section 3.1.4.9.3.8) in the request MUST contain a PostItem element of type PostItemType (section 2.2.4.1).

UpdateItemSoapOut

The UpdateItemSoapOut message is specified in [MS-OXWSCORE] section 3.1.4.9.1.2. It specifies the server response to the UpdateItem operation request.

In the response message, the Items element ([MS-OXWSCDATA] section 2.2.4.43) contains one or more PostItem elements of type PostItemType.

The client sends a tns:UpdateItemSoapIn request WSDL message and the server MUST respond with a tns:UpdateItemSoapOut response WSDL message.

Show: