com.collabnet.ce.soap60.webservices.news

Interface INewsAppSoap

public interface INewsAppSoap

Provides SOAP services for managing the news posts.

Change History

Version 6.0

• editNewsPost: New operation added in 6.0 to edit a news post

Since:

4.1

Method Summary

Modifier and Type	Method and Description
NewsPostSoapDO	createNewsPost(java.lang.String sessionId, java.lang.String projectId, java.lang.String title, java.lang.String body) Posts a news item to the project.
void	deleteNewsPost(java.lang.String sessionId, java.lang.String postId) Deletes a news post.
void	editNewsPost(java.lang.String sessionId, java.lang.String postId, java.lang.String title, java.lang.String body) Modifies a news post.
NewsPostSoapList	findNews(java.lang.String sessionId, java.lang.String queryString, java.lang.String projectId, boolean searchAttachments) Finds a list of news posts matching a search string.
NewsPostSoapList	getAllNewsPostList(java.lang.String sessionId) Returns news for all user projects.
NewsPostSoapList	getNewsPostList(java.lang.String sessionId, java.lang.String projectId) Returns project news.

Method Detail

getNewsPostList

NewsPostSoapList getNewsPostList(java.lang.String sessionId,
                                 java.lang.String projectId)
                          throws java.rmi.RemoteException

Returns project news.

Parameters:

sessionId - User session id.

projectId - Project id.

Returns:

List of news posts associated with this project.

Throws:

com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.

com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified project id is invalid.

com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.

com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.

java.rmi.RemoteException

Since:

4.1

getAllNewsPostList

NewsPostSoapList getAllNewsPostList(java.lang.String sessionId)
                             throws java.rmi.RemoteException

Returns news for all user projects.

Parameters:

sessionId - User session id.

Returns:

List of all news posts associated with user's projects.

Throws:

com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.

com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified project id is invalid.

com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.

com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.

java.rmi.RemoteException

Since:

4.1

createNewsPost

NewsPostSoapDO createNewsPost(java.lang.String sessionId,
                              java.lang.String projectId,
                              java.lang.String title,
                              java.lang.String body)
                       throws java.rmi.RemoteException

Posts a news item to the project.

Parameters:

sessionId - User session id.

projectId - Project id.

title - News post title.

body - News post body.

Returns:

Newly created new item data.

Throws:

com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.

com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified project id is invalid.

com.collabnet.ce.soap60.fault.IllegalArgumentFault - when one or more parameters are invalid.

com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.

com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.

java.rmi.RemoteException

Since:

4.1

editNewsPost

void editNewsPost(java.lang.String sessionId,
                  java.lang.String postId,
                  java.lang.String title,
                  java.lang.String body)
           throws java.rmi.RemoteException

Modifies a news post.

Parameters:

sessionId - User session id.

postId - Post id.

title - News post title.

body - News post body.

Throws:

com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.

com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified post id is invalid.

com.collabnet.ce.soap60.fault.IllegalArgumentFault - when one or more parameters are invalid.

com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.

com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.

java.rmi.RemoteException

Since:

6.0

deleteNewsPost

void deleteNewsPost(java.lang.String sessionId,
                    java.lang.String postId)
             throws java.rmi.RemoteException

Deletes a news post.

Parameters:

sessionId - User session id.

postId - News post id.

Throws:

com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.

com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified project id is invalid.

com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.

com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.

java.rmi.RemoteException

Since:

4.1

findNews

NewsPostSoapList findNews(java.lang.String sessionId,
                          java.lang.String queryString,
                          java.lang.String projectId,
                          boolean searchAttachments)
                   throws java.rmi.RemoteException

Finds a list of news posts matching a search string.

Parameters:

sessionId - User session id.

queryString - Query string.

projectId - The project in which to find news posts. (if null, search all projects)

searchAttachments - Whether to search attachments.

Returns:

List of posts matching search criteria.

Throws:

com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.

com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified project id is invalid.

com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.

com.collabnet.ce.soap60.fault.SearchQuerySyntaxFault - when the specified search query string is syntactically invalid.

com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.

java.rmi.RemoteException

Since:

4.1