Package com.logicaldoc.audit.webservice.soap

Interface AuditService

All Known Implementing Classes:

SoapAuditClient, SoapAuditService

public interface AuditService

Web Service definition interface for Notifications and Messages

Since:

6.5

Author:

Matteo Caruso - LogicalDOC

Method Summary

Modifier and Type	Method	Description
WSHistory[]	getDocumentHistory(String sid, long docId)	Gets the history of a given document
WSHistory[]	getHistory(String sid, long folderId, String oldestDate, String[] events, Integer max)	Lists all the histories in the given tree
WSHistory[]	getLatestHistory(String sid, long folderId, String oldestDate, String[] events, Integer max)	Lists all the histories in the given tree but just the more recent entry for each object(document or folder)
WSMessage[]	getMessages(String sid)	Lists messages routed to the current user
WSSubscription[]	getSubscriptions(String sid)	Lists all the subscriptions of the current user
void	markAsRead(String sid, long[] ids)	Marks a set of messages as read by the current user
WSHistory	saveDocumentHistory(String sid, WSHistory history)	Saves a document history
void	subscribe(String sid, Long[] ids, String type, String events)	Subscribes the current user to notifications emitted by documents or folders
void	unsubscribe(String sid, Long[] ids, String type)	Unsubscribes the current user to notifications emitted by documents or folders

Method Details

subscribe

void subscribe(String sid,
 Long[] ids,
 String type,
 String events)
        throws com.logicaldoc.core.security.authentication.AuthenticationException,
com.logicaldoc.webservice.WebserviceException,
com.logicaldoc.core.PersistenceException

Subscribes the current user to notifications emitted by documents or folders

Parameters:

sid - The session identifier

ids - The ids of documents or folders

type - one of Subscription.TYPE_x

events - Optional list of event codes separated by comma

Throws:

com.logicaldoc.core.PersistenceException - Error in the database

com.logicaldoc.webservice.WebserviceException - Error in the webservice

com.logicaldoc.core.security.authentication.AuthenticationException - Invalid session

unsubscribe

void unsubscribe(String sid,
 Long[] ids,
 String type)
          throws com.logicaldoc.core.security.authentication.AuthenticationException,
com.logicaldoc.webservice.WebserviceException,
com.logicaldoc.core.PersistenceException

Unsubscribes the current user to notifications emitted by documents or folders

Parameters:

sid - The session identifier

ids - The ids of documents or folders

type - one of Subscription.TYPE_x

Throws:

com.logicaldoc.core.PersistenceException - Error in the database

com.logicaldoc.webservice.WebserviceException - Error in the webservice

com.logicaldoc.core.security.authentication.AuthenticationException - Invalid session

getSubscriptions

WSSubscription[] getSubscriptions(String sid)
                           throws com.logicaldoc.core.security.authentication.AuthenticationException,
com.logicaldoc.webservice.WebserviceException,
com.logicaldoc.core.PersistenceException

Lists all the subscriptions of the current user

Parameters:

sid - identifier of the session

Returns:

array of subscriptions

Throws:

com.logicaldoc.core.PersistenceException - Error in the database

com.logicaldoc.webservice.WebserviceException - Error in the webservice

com.logicaldoc.core.security.authentication.AuthenticationException - Invalid session

getMessages

WSMessage[] getMessages(String sid)
                 throws com.logicaldoc.core.security.authentication.AuthenticationException,
com.logicaldoc.webservice.WebserviceException,
com.logicaldoc.core.PersistenceException

Lists messages routed to the current user

Parameters:

sid - identifier of the session

Returns:

array of messages

Throws:

com.logicaldoc.core.PersistenceException - Error in the database

com.logicaldoc.webservice.WebserviceException - Error in the webservice

com.logicaldoc.core.security.authentication.AuthenticationException - Invalid session

markAsRead

void markAsRead(String sid,
 long[] ids)
         throws com.logicaldoc.core.security.authentication.AuthenticationException,
com.logicaldoc.webservice.WebserviceException,
com.logicaldoc.core.PersistenceException

Marks a set of messages as read by the current user

Parameters:

sid - identifier of the session

ids - identifiers of messages

Throws:

com.logicaldoc.core.PersistenceException - Error in the database

com.logicaldoc.webservice.WebserviceException - Error in the webservice

com.logicaldoc.core.security.authentication.AuthenticationException - Invalid session

getHistory

WSHistory[] getHistory(String sid,
 long folderId,
 String oldestDate,
 String[] events,
 Integer max)
                throws com.logicaldoc.core.security.authentication.AuthenticationException,
com.logicaldoc.webservice.WebserviceException,
com.logicaldoc.core.PersistenceException

Lists all the histories in the given tree

Parameters:

sid - The session identifier

folderId - The tree to inspect

oldestDate - Optional oldest date to use as filter

events - Optional array of event codes to use as filter

max - Optional hint on the maximum number of records for each history type(document, folder ...)

Returns:

The list of histories

Throws:

com.logicaldoc.core.PersistenceException - Error in the database

com.logicaldoc.webservice.WebserviceException - Error in the webservice

com.logicaldoc.core.security.authentication.AuthenticationException - Invalid session

getLatestHistory

WSHistory[] getLatestHistory(String sid,
 long folderId,
 String oldestDate,
 String[] events,
 Integer max)
                      throws com.logicaldoc.core.security.authentication.AuthenticationException,
com.logicaldoc.webservice.WebserviceException,
com.logicaldoc.core.PersistenceException

Lists all the histories in the given tree but just the more recent entry for each object(document or folder)

Parameters:

sid - The session identifier

folderId - The tree to inspect

oldestDate - Optional oldest date to use as filter

events - Optional array of event codes to use as filter

max - Optional hint on the maximum number of records for each history type(document, folder ...)

Returns:

The list of histories

Throws:

com.logicaldoc.core.PersistenceException - Error in the database

com.logicaldoc.webservice.WebserviceException - Error in the webservice

com.logicaldoc.core.security.authentication.AuthenticationException - Invalid session

getDocumentHistory

WSHistory[] getDocumentHistory(String sid,
 long docId)
                        throws com.logicaldoc.core.security.authentication.AuthenticationException,
com.logicaldoc.webservice.WebserviceException,
com.logicaldoc.core.PersistenceException,
com.logicaldoc.core.security.authorization.PermissionException

Gets the history of a given document

Parameters:

sid - Session identifier

docId - The document id

Returns:

Array of history records

Throws:

com.logicaldoc.core.PersistenceException - Error in the database

com.logicaldoc.webservice.WebserviceException - Error in the webservice

com.logicaldoc.core.security.authentication.AuthenticationException - Invalid session

com.logicaldoc.core.security.authorization.PermissionException - The user does not have the required permission

saveDocumentHistory

WSHistory saveDocumentHistory(String sid,
 WSHistory history)
                       throws com.logicaldoc.core.security.authentication.AuthenticationException,
com.logicaldoc.webservice.WebserviceException,
com.logicaldoc.core.PersistenceException

Saves a document history

Parameters:

sid - Session identifier

history - The history to save

Returns:

The saved History

Throws:

com.logicaldoc.core.PersistenceException - Error in the database

com.logicaldoc.webservice.WebserviceException - Error in the webservice

com.logicaldoc.core.security.authentication.AuthenticationException - Invalid session