3.1.4.2 AddDiscussionBoardItem

  • Article

The AddDiscussionBoardItem operation<34> is used to add new discussion items to a specified discussion board.

 <wsdl:operation name="AddDiscussionBoardItem">
     <wsdl:input message="AddDiscussionBoardItemSoapIn" />
     <wsdl:output message="AddDiscussionBoardItemSoapOut" />
 </wsdl:operation>

The protocol client sends an AddDiscussionBoardItemSoapIn request message (section 3.1.4.2.1.1) and the protocol server responds with an AddDiscussionBoardItemSoapOut response message (section 3.1.4.2.1.2), as follows:

  1. If the specified listName is a valid GUID and corresponds to the identification of a list on the site, use that list.

  2. If the specified listName is not a valid GUID or does not correspond to the identification of a list on the site, check whether the listName corresponds to the list title of a list on the site and if so, use that list.

  3. If the specified listName does not correspond to a list from either of these checks, the protocol server SHOULD<35> return a SOAP fault with error code 0x82000006. This indicates that a list corresponding to the specified listName does not exist on the server.

  4. If the list is not a discussion board, the protocol server MUST return a SOAP fault. There is no error code returned for this fault.

  5. If both parameters are valid, the protocol server MUST add a discussion item to the discussion board.