Difference between revisions of "OKMNotification"

From OpenKM Documentation
Jump to: navigation, search
(Created page with '{{TOCright}} __TOC__ Methods related to notifications. Category: Webservices Guide')
 
(StringArray getSubscriptors(String token, String nodePath))
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{TOCright}} __TOC__
+
__TOC__
  
 
Methods related to notifications.
 
Methods related to notifications.
 +
 +
== void subscribe(String token, String nodePath) ==
 +
Add user subscription to a node.
 +
 +
'''Parameters'''
 +
* ''token'' - The session authorization token.
 +
* ''nodePath'' - The complete path to the node.
 +
 +
'''Returns'''
 +
* None
 +
 +
'''Throws'''
 +
* ''PathNotFoundException'' - If the node defined by nodePath do not exists.
 +
* ''AccessDeniedException'' - If the token authorization information is not valid.
 +
* ''RepositoryException'' - If there is any error accessing to the repository.
 +
 +
== void unsubscribe(String token, String nodePath) ==
 +
Remove an user subscription from a node.
 +
 +
'''Parameters'''
 +
* ''token'' - The session authorization token.
 +
* ''nodePath'' - The complete path to the node.
 +
 +
'''Returns'''
 +
* None
 +
 +
'''Throws'''
 +
* ''PathNotFoundException'' - If the node defined by nodePath do not exists.
 +
* ''AccessDeniedException'' - If the token authorization information is not valid.
 +
* ''RepositoryException'' - If there is any error accessing to the repository.
 +
 +
== String[] getSubscriptors(String token, String nodePath) ==
 +
Get user subscriptions from am item (document or folder).
 +
 +
'''Parameters'''
 +
* ''token'' - The session authorization token.
 +
* ''nodePath'' - The complete path to the node.
 +
 +
'''Returns'''
 +
* An array of subscribed users.
 +
 +
'''Throws'''
 +
* ''PathNotFoundException'' - If the node defined by nodePath do not exists.
 +
* ''AccessDeniedException'' - If the token authorization information is not valid.
 +
* ''RepositoryException'' - If there is any error accessing to the repository.
 +
 +
== void notify(String token, String nodePath, StringArray users, String message) ==
 +
Send a notification message to an user list.
 +
 +
'''Parameters'''
 +
* ''token'' - The session authorization token.
 +
* ''nodePath'' - The complete path to the node.
 +
* ''users'' - Array of users to notify.
 +
* ''message'' - An String with the notification message.
 +
 +
'''Returns'''
 +
* None
 +
 +
'''Throws'''
 +
* ''PathNotFoundException'' - If the node defined by nodePath do not exists.
 +
* ''AccessDeniedException'' - If the token authorization information is not valid.
 +
* ''RepositoryException'' - If there is any error accessing to the repository.
  
 
[[Category: Webservices Guide]]
 
[[Category: Webservices Guide]]

Latest revision as of 10:55, 26 October 2010

Methods related to notifications.

void subscribe(String token, String nodePath)

Add user subscription to a node.

Parameters

  • token - The session authorization token.
  • nodePath - The complete path to the node.

Returns

  • None

Throws

  • PathNotFoundException - If the node defined by nodePath do not exists.
  • AccessDeniedException - If the token authorization information is not valid.
  • RepositoryException - If there is any error accessing to the repository.

void unsubscribe(String token, String nodePath)

Remove an user subscription from a node.

Parameters

  • token - The session authorization token.
  • nodePath - The complete path to the node.

Returns

  • None

Throws

  • PathNotFoundException - If the node defined by nodePath do not exists.
  • AccessDeniedException - If the token authorization information is not valid.
  • RepositoryException - If there is any error accessing to the repository.

String[] getSubscriptors(String token, String nodePath)

Get user subscriptions from am item (document or folder).

Parameters

  • token - The session authorization token.
  • nodePath - The complete path to the node.

Returns

  • An array of subscribed users.

Throws

  • PathNotFoundException - If the node defined by nodePath do not exists.
  • AccessDeniedException - If the token authorization information is not valid.
  • RepositoryException - If there is any error accessing to the repository.

void notify(String token, String nodePath, StringArray users, String message)

Send a notification message to an user list.

Parameters

  • token - The session authorization token.
  • nodePath - The complete path to the node.
  • users - Array of users to notify.
  • message - An String with the notification message.

Returns

  • None

Throws

  • PathNotFoundException - If the node defined by nodePath do not exists.
  • AccessDeniedException - If the token authorization information is not valid.
  • RepositoryException - If there is any error accessing to the repository.