3.1.4.8 UpdateLists

  • Article

The UpdateLists operation is used to insert, update, and delete list items in one or more lists.

The following is the WSDL port type specification of the UpdateLists WSDL operation.

 <wsdl:operation name="UpdateLists" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
   <wsdl:input message="tns:UpdateListsSoapIn"/>
   <wsdl:output message="tns:UpdateListsSoapOut"/>
 </wsdl:operation>

The protocol client sends an UpdateListsSoapIn request message and the protocol server sends an UpdateListsSoapOut response message that consists of zero or more u elements. The protocol server MUST process each u element as follows:

  1. If the list name specified in the ln attribute of the u element is a valid GUID and corresponds to the identifier of a list on the site, use that list for the operation.

  2. If the specified list name is not a valid GUID or does not correspond to the identifier of a list on the site, check if the list name corresponds to the title of a list on the site. If it does, use that list if performing either an Insert or Update command. If the list name corresponds to the title of a list on the site and performing a Delete command, return an error code of "-2130575322" in the ec attribute of the u element in the response that corresponds to this part of the request.

  3. If the specified list name does not match a list based on either of the two previous conditions, the protocol server MUST return a SOAP fault, as described in section 2.2.2.1.

  4. If there is a macro token specified in the mit element of the request, the protocol server MUST wait for the data macro that corresponds to that macro token to finish running before processing the u elements. If the request times out in an implementation-specific period of time, the protocol server MUST return an error code of "-2147467259" in the ec attribute of the u elements that failed to be updated.

  5. Otherwise, the protocol server MUST process the operations on the list and return success or failure in the ec attribute of the u element in the response that corresponds to this part of the request.