Share via

3.1.4.16 GetListAndView

  • Article

The GetListAndView operation is used to retrieve properties and fields for a specified list and a view.

 <wsdl:operation name="GetListAndView">
     <wsdl:input message="GetListAndViewSoapIn" />
     <wsdl:output message="GetListAndViewSoapOut" />
 </wsdl:operation>

The protocol client sends a GetListAndViewSoapIn request message (section 3.1.4.16.1.1) and the server MUST respond with a GetListAndViewSoapOut response message (section 3.1.4.16.1.2), as follows:

  1. If the specified listName is a valid GUID and corresponds to the identification of a list on the site, the protocol server MUST return a GetListAndViewResponse element.

  2. If the specified listName is not a valid GUID or does not correspond to the identification of a list on the site, check if the listName corresponds to the list title of a list on the site and if so, the protocol server MUST return a GetListAndViewResponse element.

  3. If the specified listName does not correspond to a list from either of these checks, the protocol server SHOULD<56> return a SOAP fault with error code 0x82000006. This indicates that the list does not exist or might have been deleted by another user.

  4. If the specified viewName is not specified or is an empty string, the default view properties MUST be returned.

  5. If the specified viewName is not a valid GUID and is not an empty string, the protocol server MUST return a SOAP fault with error code 0x82000001. This indicates that a required parameter is missing or invalid.

  6. If the specified viewName does not correspond to an existing viewName for the given list and it is not an empty string, the protocol server MUST return a SOAP fault with error code 0x82000005. This indicates that the view does not exist or might have been deleted by another user.