Package com.collabnet.ce.soap60.webservices.page

Class PageAppSoapStub

java.lang.Object

com.collabnet.ce.soap60.webservices.ClientSoapStub

com.collabnet.ce.soap60.webservices.page.PageAppSoapStub

All Implemented Interfaces:

IPageAppSoap

public class PageAppSoapStub
extends ClientSoapStub
implements IPageAppSoap

Field Summary

Fields inherited from class com.collabnet.ce.soap60.webservices.ClientSoapStub

DEFAULT_CLIENT_TIME_OUT

Constructor Summary

Constructors

Constructor	Description
PageAppSoapStub(String soapServerUrl)

Method Summary

Modifier and Type	Method	Description
String	addPageImage(String sessionId, String projectId, String fileId, String filename, String mimetype)	Adds an uploaded file as an image for a page.
PageComponentSoapDO	createComponent(String sessionId, String pageId, String compName, String componentType, boolean topOfPage, int visibility, SoapNamedValues attributes, String content)	Creates a page component.
PageComponent2SoapDO	createComponent2(String sessionId, String pageId, String compName, String componentType, boolean topOfPage, int visibility, SoapNamedValues attributes, String content)	Creates a page component.
PageSoapDO	createPage(String sessionId, String projectId, String parentId, String title, boolean visible, boolean freeform)	Creates a new project page.
void	deletePage(String sessionId, String pageId)	Deletes an existing page
void	deletePageComponent(String sessionId, String pageComponentId)	Deletes an existing page component
void	deletePageImage(String sessionId, String projectId, String attachmentId)	Deletes the specified attachment of the specified object.
PageComponent2SoapDO	getPageComponent(String sessionId, String pageComponentId)	Gets page component meta data and settings for a given page component id.
PageComponentSoapDO[]	getPageComponents(String sessionId, String pageId)	Gets an array of page components for a page (in the correct order)
PageSoapDO	getPageData(String sessionId, String pageId)	Gets a project page.
String	getPageImageUrl(String sessionId, String projectId, String attachmentId)	Gets relative URL to access to the uploaded image from an HTML page.
PageSoapList	getPageList(String sessionId, String projectId)	Gets all pages for a user in the specified project (in the correct order).
String	getTextComponentContent(String sessionId, String pageCompId)	Gets the content of a Text component.
AttachmentSoapList	listPageImages(String sessionId, String projectId)	Lists the images for a project.
void	movePage(String sessionId, String pageFolderPath, String destPath)	Moves a page (including sub pages and contents).
void	setComponentDisplayOrder(String sessionId, String pageId, String[] componentIds)	Sets the display order for components within a page
void	setLifecycleMetricComponentContent(String sessionId, PageComponent2SoapDO pageComponent, String content)	Sets Lifecycle metric component.
void	setPageComponentData(String sessionId, PageComponentSoapDO pageComponent)	Updates a page component
void	setPageData(String sessionId, PageSoapDO pageData)	Edits an existing page.
boolean	setPageDisplayOrder(String sessionId, String folderId, String[] childrenPageIds)	Sets the page display order.
void	setTextComponentContent(String sessionId, String pageCompId, String content)	Sets the content of a Text component.

Methods inherited from class com.collabnet.ce.soap60.webservices.ClientSoapStub

getServiceCall, getSoapServer, getTimeout, setTimeout, soapParam

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PageAppSoapStub

public PageAppSoapStub(String soapServerUrl)

Method Detail

getPageData

public PageSoapDO getPageData(String sessionId,
                              String pageId)
                       throws RemoteException

Description copied from interface: IPageAppSoap

Gets a project page. This API only fetches the page data and does not fetch the component contents.

Specified by:

getPageData in interface IPageAppSoap

Parameters:

sessionId - User session id.

pageId - the pageId for which data is to be fetched.

Returns:

the page data

Throws:

InvalidSessionFault - when the specified session id is invalid.

NoSuchObjectFault - when the specified page id is invalid.

PermissionDeniedFault - when the user has insufficient privileges.

SystemFault - when an unexpected system level error occurs.

RemoteException

getTextComponentContent

public String getTextComponentContent(String sessionId,
                                      String pageCompId)
                               throws RemoteException

Description copied from interface: IPageAppSoap

Gets the content of a Text component.

Specified by:

getTextComponentContent in interface IPageAppSoap

Parameters:

sessionId - User session id.

pageCompId - page component id for which the content/source is to be fetched.

Returns:

content of the text component as string

Throws:

InvalidSessionFault - when the specified session id is invalid.

NoSuchObjectFault - when the specified page component id is invalid.

InvalidComponentTypeFault - if the type of the component is not Text

PermissionDeniedFault - when the user has insufficient privileges.

SystemFault - when an unexpected system level error occurs.

RemoteException

setTextComponentContent

public void setTextComponentContent(String sessionId,
                                    String pageCompId,
                                    String content)
                             throws RemoteException

Description copied from interface: IPageAppSoap

Sets the content of a Text component.

Specified by:

setTextComponentContent in interface IPageAppSoap

Parameters:

sessionId - User session id.

pageCompId - page component id for which the content/source is to be fetched.

content - the new content

Throws:

InvalidSessionFault - when the specified session id is invalid.

NoSuchObjectFault - when the specified page component id is invalid.

InvalidComponentTypeFault - if the type of the component is not Text

VersionMismatchFault - when component data is stale

IllegalArgumentFault - for invalid content

PermissionDeniedFault - when the user has insufficient privileges.

SystemFault - when an unexpected system level error occurs.

RemoteException

setLifecycleMetricComponentContent

public void setLifecycleMetricComponentContent(String sessionId,
                                               PageComponent2SoapDO pageComponent,
                                               String content)
                                        throws RemoteException

Description copied from interface: IPageAppSoap

Sets Lifecycle metric component. The API replaces the existing HTML source and other metric properties.

Specified by:

setLifecycleMetricComponentContent in interface IPageAppSoap

Parameters:

sessionId - User session id.

pageComponent - the page component to be updated.

content - the html content

Throws:

InvalidSessionFault - when the specified session id is invalid.

NoSuchObjectFault - when the specified page component id is invalid.

InvalidComponentTypeFault - if the type of the component is not metrics

VersionMismatchFault - when component data is stale

IllegalArgumentFault - for invalid content

PermissionDeniedFault - when the user has insufficient privileges.

SystemFault - when an unexpected system level error occurs.

RemoteException

getPageList

public PageSoapList getPageList(String sessionId,
                                String projectId)
                         throws RemoteException

Description copied from interface: IPageAppSoap

Gets all pages for a user in the specified project (in the correct order).

Specified by:

getPageList in interface IPageAppSoap

Parameters:

sessionId - User session id.

projectId - the project for which the pages are to be fetched

Returns:

list of pages for the user in the project

Throws:

InvalidSessionFault - when the specified session id is invalid.

NoSuchObjectFault - when the specified page component id is invalid.

SystemFault - when an unexpected system level error occurs.

RemoteException

createPage

public PageSoapDO createPage(String sessionId,
                             String projectId,
                             String parentId,
                             String title,
                             boolean visible,
                             boolean freeform)
                      throws RemoteException

Description copied from interface: IPageAppSoap

Creates a new project page.

Specified by:

createPage in interface IPageAppSoap

Parameters:

sessionId - User session id.

projectId - Id of the project in which the page is to be created

parentId - parent folder id under which the page is to be created

title - title of the page

visible - visibility of the page

freeform - true if the page link must be hidden in the left navigation

Returns:

the newly created page

Throws:

InvalidSessionFault - when the specified session id is invalid.

NoSuchObjectFault - when the specified page component id is invalid.

PermissionDeniedFault - when the user has insufficient privileges.

ObjectAlreadyExistsFault - If a page with the same name already exists in the project

SystemFault - when an unexpected system level error occurs.

RemoteException

setPageData

public void setPageData(String sessionId,
                        PageSoapDO pageData)
                 throws RemoteException

Description copied from interface: IPageAppSoap

Edits an existing page. This API will not modify the component data.

Specified by:

setPageData in interface IPageAppSoap

Parameters:

sessionId - User session id.

pageData - the page to be edited.

Throws:

InvalidSessionFault - when the specified session id is invalid.

PermissionDeniedFault - when the user has insufficient privileges.

NoSuchObjectFault - when the specified page component id is invalid.

VersionMismatchFault - when page data is stale

SystemFault - when an unexpected system level error occurs.

RemoteException

getPageComponents

public PageComponentSoapDO[] getPageComponents(String sessionId,
                                               String pageId)
                                        throws RemoteException

Description copied from interface: IPageAppSoap

Gets an array of page components for a page (in the correct order)

Specified by:

getPageComponents in interface IPageAppSoap

Parameters:

sessionId - User session id.

pageId - the id of the page from which to get the list of components

Returns:

array of page components

Throws:

InvalidSessionFault - when the specified session id is invalid.

PermissionDeniedFault - when the user has insufficient privileges.

NoSuchObjectFault - when the specified page component id is invalid.

SystemFault - when an unexpected system level error occurs.

RemoteException

deletePage

public void deletePage(String sessionId,
                       String pageId)
                throws RemoteException

Description copied from interface: IPageAppSoap

Deletes an existing page

Specified by:

deletePage in interface IPageAppSoap

Parameters:

sessionId - User session id.

pageId - the page to be deleted.

Throws:

InvalidSessionFault - when the specified session id is invalid.

NoSuchObjectFault - when the specified page id is invalid.

PermissionDeniedFault - when the user has insufficient privileges.

CannotDeleteHomePageFault - when the user tries to delete the home page.

SystemFault - when an unexpected system level error occurs.

RemoteException

deletePageComponent

public void deletePageComponent(String sessionId,
                                String pageComponentId)
                         throws RemoteException

Description copied from interface: IPageAppSoap

Deletes an existing page component

Specified by:

deletePageComponent in interface IPageAppSoap

Parameters:

sessionId - User session id.

pageComponentId - the id of the page component to be deleted.

Throws:

InvalidSessionFault - when the specified session id is invalid.

NoSuchObjectFault - when the specified page id is invalid.

PermissionDeniedFault - when the specified page id is invalid.

SystemFault - when an unexpected system level error occurs.

RemoteException

setComponentDisplayOrder

public void setComponentDisplayOrder(String sessionId,
                                     String pageId,
                                     String[] componentIds)
                              throws RemoteException

Description copied from interface: IPageAppSoap

Sets the display order for components within a page

Specified by:

setComponentDisplayOrder in interface IPageAppSoap

Parameters:

sessionId - User session id.

pageId - the id of the page where the components belong

componentIds - ids of component in the order which is to be set

Throws:

InvalidSessionFault - when the specified session id is invalid.

NoSuchObjectFault - when the specified page component id is invalid.

PermissionDeniedFault - when the user has insufficient privileges.

SystemFault - when an unexpected system level error occurs.

RemoteException

createComponent

public PageComponentSoapDO createComponent(String sessionId,
                                           String pageId,
                                           String compName,
                                           String componentType,
                                           boolean topOfPage,
                                           int visibility,
                                           SoapNamedValues attributes,
                                           String content)
                                    throws RemoteException

Description copied from interface: IPageAppSoap

Creates a page component.

Specified by:

createComponent in interface IPageAppSoap

Parameters:

sessionId - User session id.

pageId - the id of the page where the component is to be created.

compName - component name

componentType - component type.

topOfPage - true if the component is to be created at top of the page

visibility - defines the visibility of this component, 1= visible, 0 = hidden.

attributes - component attributes.

content - text component content, applicable for Text components and Lifecycle metrics components.

Returns:

the newly created component

Throws:

InvalidSessionFault - when the specified session id is invalid.

NoSuchObjectFault - when the specified page component id is invalid.

IllegalArgumentFault - for incorrect parameter values

PermissionDeniedFault - when the user has insufficient privileges.

ObjectAlreadyExistsFault - If a component with the same name already exists in the page

SystemFault - when an unexpected system level error occurs.

RemoteException

createComponent2

public PageComponent2SoapDO createComponent2(String sessionId,
                                             String pageId,
                                             String compName,
                                             String componentType,
                                             boolean topOfPage,
                                             int visibility,
                                             SoapNamedValues attributes,
                                             String content)
                                      throws RemoteException

Description copied from interface: IPageAppSoap

Creates a page component.

Specified by:

createComponent2 in interface IPageAppSoap

Parameters:

sessionId - User session id.

pageId - the id of the page where the component is to be created.

compName - component name

componentType - component type.

topOfPage - true if the component is to be created at top of the page

visibility - defines the visibility of this component, 1= visible, 0 = hidden.

attributes - component attributes.

content - text component content, applicable for Text components and Lifecycle metrics components.

Returns:

the newly created component

Throws:

InvalidSessionFault - when the specified session id is invalid.

NoSuchObjectFault - when the specified page component id is invalid.

IllegalArgumentFault - for incorrect parameter values

PermissionDeniedFault - when the user has insufficient privileges.

ObjectAlreadyExistsFault - If a component with the same name already exists in the page

SystemFault - when an unexpected system level error occurs.

RemoteException

setPageComponentData

public void setPageComponentData(String sessionId,
                                 PageComponentSoapDO pageComponent)
                          throws RemoteException

Description copied from interface: IPageAppSoap

Updates a page component

Specified by:

setPageComponentData in interface IPageAppSoap

Parameters:

sessionId - User session id.

pageComponent - the page component to be updated.

Throws:

InvalidSessionFault - when the specified session id is invalid.

NoSuchObjectFault - when the specified page id is invalid.

PermissionDeniedFault - when the specified page id is invalid.

VersionMismatchFault - when the component data is stale.

IllegalArgumentFault - for incorrect data.

SystemFault - when an unexpected system level error occurs.

RemoteException

setPageDisplayOrder

public boolean setPageDisplayOrder(String sessionId,
                                   String folderId,
                                   String[] childrenPageIds)
                            throws RemoteException

Description copied from interface: IPageAppSoap

Sets the page display order. This API will not modify the component data.

Specified by:

setPageDisplayOrder in interface IPageAppSoap

Parameters:

sessionId - User session id.

folderId - the folder to be used.

childrenPageIds - page keys in the new intended order based on array order must pass in all pages.

Returns:

true is the update went perfectly

Throws:

InvalidSessionFault - when the specified session id is invalid.

PermissionDeniedFault - when the user has insufficient privileges.

NoSuchObjectFault - when the specified page component id is invalid.

SystemFault - when an unexpected system level error occurs.

RemoteException

movePage

public void movePage(String sessionId,
                     String pageFolderPath,
                     String destPath)
              throws RemoteException

Description copied from interface: IPageAppSoap

Moves a page (including sub pages and contents).

Specified by:

movePage in interface IPageAppSoap

Parameters:

sessionId - User session id.

pageFolderPath - The path to the page to move

destPath - The path of the destination parent folder

Throws:

InvalidSessionFault - when the specified session id is invalid.

PermissionDeniedFault - when the user has insufficient privileges.

NoSuchObjectFault - when the specified folder component id is invalid.

SystemFault - when an unexpected system level error occurs.

RemoteException

addPageImage

public String addPageImage(String sessionId,
                           String projectId,
                           String fileId,
                           String filename,
                           String mimetype)
                    throws RemoteException

Description copied from interface: IPageAppSoap

Adds an uploaded file as an image for a page.

Specified by:

addPageImage in interface IPageAppSoap

Parameters:

sessionId - User session id.

projectId - Project id.

fileId - Image file ID returned by FileStorageApp/SimpleFileStorageApp webservice.

filename - Image file name.

mimetype - Image file type.

Returns:

attachment id of the added image

Throws:

InvalidSessionFault - when the sessionId is invalid.

PermissionDeniedFault - when permission is denied for the specified operation.

NoSuchObjectFault - when the specified object is invalid.

SystemFault - when an unexpected system error occurs.

RemoteException

listPageImages

public AttachmentSoapList listPageImages(String sessionId,
                                         String projectId)
                                  throws RemoteException

Description copied from interface: IPageAppSoap

Lists the images for a project.

Specified by:

listPageImages in interface IPageAppSoap

Parameters:

sessionId - User session id.

projectId - Project id.

Returns:

List of page images as AttachmentSoapList.

Throws:

InvalidSessionFault - when the sessionId is invalid.

PermissionDeniedFault - when permission is denied for the specified operation.

NoSuchObjectFault - when the specified object is invalid.

SystemFault - when an unexpected system error occurs.

RemoteException

getPageImageUrl

public String getPageImageUrl(String sessionId,
                              String projectId,
                              String attachmentId)
                       throws RemoteException

Description copied from interface: IPageAppSoap

Gets relative URL to access to the uploaded image from an HTML page.

Specified by:

getPageImageUrl in interface IPageAppSoap

Parameters:

sessionId - User session id.

projectId - Project id.

attachmentId - Attachment id of the image.

Returns:

the relative URL for the image.

Throws:

InvalidSessionFault - when the sessionId is invalid.

PermissionDeniedFault - when permission is denied for the specified operation.

NoSuchObjectFault - when the specified object is invalid.

SystemFault - when an unexpected system error occurs.

RemoteException

deletePageImage

public void deletePageImage(String sessionId,
                            String projectId,
                            String attachmentId)
                     throws RemoteException

Description copied from interface: IPageAppSoap

Deletes the specified attachment of the specified object.

Specified by:

deletePageImage in interface IPageAppSoap

Parameters:

sessionId - User session id.

projectId - Project id.

attachmentId - The attachment id.

Throws:

InvalidSessionFault - when the specified session id is invalid.

NoSuchObjectFault - when the specified object id is invalid.

PermissionDeniedFault - when the user has insufficient privileges.

SystemFault - when an unexpected system error occurs.

RemoteException

getPageComponent

public PageComponent2SoapDO getPageComponent(String sessionId,
                                             String pageComponentId)
                                      throws RemoteException

Description copied from interface: IPageAppSoap

Gets page component meta data and settings for a given page component id.

Specified by:

getPageComponent in interface IPageAppSoap

Parameters:

sessionId - User session id.

pageComponentId - the id of the page component from which to get the component

Returns:

page component

Throws:

InvalidSessionFault - when the specified session id is invalid.

PermissionDeniedFault - when the user has insufficient privileges.

NoSuchObjectFault - when the specified page component id is invalid.

SystemFault - when an unexpected system level error occurs.

RemoteException