Difference between revisions of "OKMRepository"

From OpenKM Documentation
Jump to: navigation, search
(boolean hasNode(String token, String path))
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{TOCright}} __TOC__
+
__TOC__
  
 
Methods related to repository management.
 
Methods related to repository management.
Line 57: Line 57:
 
== Folder getMailFolder(String token) ==
 
== Folder getMailFolder(String token) ==
 
Obtain the personal mails folder of the repository.
 
Obtain the personal mails folder of the repository.
 +
 
'''Parameters'''
 
'''Parameters'''
 +
* ''token'' - The session authorization token.
 +
 
'''Returns'''
 
'''Returns'''
 +
* A folder object with the user mails folder node properties.
 +
 
'''Throws'''
 
'''Throws'''
 +
* ''PathNotFoundException'' - If there is no user documents folder node in the repository.
 +
* ''RepositoryException'' - If there is any general repository problem.
 +
 +
'''Since'''
 +
* OpenKM 4.0
  
 
== Folder getThesaurusFolder(String token) ==
 
== Folder getThesaurusFolder(String token) ==
Line 95: Line 105:
 
== void purgeTrash(String token) ==
 
== void purgeTrash(String token) ==
 
Remove all the items in the user trash folder for ever. You can't recover this items any more.
 
Remove all the items in the user trash folder for ever. You can't recover this items any more.
 +
 
'''Parameters'''
 
'''Parameters'''
 +
* token - The session authorization token.
 +
 
'''Returns'''
 
'''Returns'''
 +
* None
 +
 
'''Throws'''
 
'''Throws'''
 +
* ''AccessDeniedException'' - If there is any security problem: you can't modify the user deleted folders and documents because of lack of permissions.
 +
* ''RepositoryException'' - If there is any general repository problem.
  
 
== boolean hasNode(String token, String path) ==
 
== boolean hasNode(String token, String path) ==
Line 103: Line 120:
  
 
'''Parameters'''
 
'''Parameters'''
* ''token'' - The session authorization token
+
* ''token'' - The session authorization token.
 
* ''path'' - The node path to test.
 
* ''path'' - The node path to test.
  
 
'''Returns'''
 
'''Returns'''
* True if the node exist or false if not
+
* True if the node exist or false if not.
  
 
'''Throws'''
 
'''Throws'''
Line 115: Line 132:
 
* OpenKM 4.0
 
* OpenKM 4.0
  
== String getNodePath(String token, String uuid) ==
+
== String getPath(String token, String uuid) ==
 
Obtain the node path with a given uuid.
 
Obtain the node path with a given uuid.
  
 
'''Parameters'''
 
'''Parameters'''
* ''token'' - The session authorization token
+
* ''token'' - The session authorization token.
* ''uuid'' - An unique node identifier
+
* ''uuid'' - An unique node identifier.
  
 
'''Returns'''
 
'''Returns'''

Latest revision as of 17:13, 15 September 2010

Methods related to repository management.

Folder getRootFolder(String token)

Obtain the root folder of the repository.

Parameters

  • token - The session authorization token.

Returns

  • A folder object with the repository root node properties.

Throws

  • PathNotFoundException - If there is no root folder node in the repository.
  • RepositoryException - If there is any general repository problem.

Folder getTrashFolder(String token)

Obtains the user trash folder.

Parameters

  • token - The session authorization token.

Returns

  • A folder object with the user trash node properties.

Throws

  • PathNotFoundException - If there is no user trash folder node in the repository.
  • RepositoryException - If there is any general repository problem.

Folder getTemplatesFolder(String token)

Obtain the template folder of the repository.

Parameters

  • token - The session authorization token.

Returns

  • A folder object with the templates node properties.

Throws

  • PathNotFoundException - If there is no templates folder node in the repository.
  • RepositoryException - If there is any general repository problem.

Folder getPersonalFolder(String token)

Obtain the personal documents folder of the repository.

Parameters

  • token - The session authorization token.

Returns

  • A folder object with the user documents folder node properties.

Throws

  • PathNotFoundException - If there is no user documents folder node in the repository.
  • RepositoryException - If there is any general repository problem.

Folder getMailFolder(String token)

Obtain the personal mails folder of the repository.

Parameters

  • token - The session authorization token.

Returns

  • A folder object with the user mails folder node properties.

Throws

  • PathNotFoundException - If there is no user documents folder node in the repository.
  • RepositoryException - If there is any general repository problem.

Since

  • OpenKM 4.0

Folder getThesaurusFolder(String token)

Obtain the thesaurus folder of the repository.

Parameters

  • token - The session authorization token.

Returns

  • A folder object with the thesaurus folder node properties.

Throws

  • PathNotFoundException - If there is no user documents folder node in the repository.
  • RepositoryException - If there is any general repository problem.

Since

  • OpenKM 5.0

Folder getCategoriesFolder(String token)

Obtain the categories folder of the repository.

Parameters

  • token - The session authorization token.

Returns

  • A folder object with the categories folder node properties.

Throws

  • PathNotFoundException - If there is no user documents folder node in the repository.
  • RepositoryException - If there is any general repository problem.

Since

  • OpenKM 5.0

void purgeTrash(String token)

Remove all the items in the user trash folder for ever. You can't recover this items any more.

Parameters

  • token - The session authorization token.

Returns

  • None

Throws

  • AccessDeniedException - If there is any security problem: you can't modify the user deleted folders and documents because of lack of permissions.
  • RepositoryException - If there is any general repository problem.

boolean hasNode(String token, String path)

Test if a node path exists

Parameters

  • token - The session authorization token.
  • path - The node path to test.

Returns

  • True if the node exist or false if not.

Throws

  • RepositoryException - If there is any general repository problem.

Since

  • OpenKM 4.0

String getPath(String token, String uuid)

Obtain the node path with a given uuid.

Parameters

  • token - The session authorization token.
  • uuid - An unique node identifier.

Returns

  • The path of the node with the given uuid.

Throws

  • PathNotFoundException - If there is no user node in the repository with this uuid.
  • RepositoryException - If there is any general repository problem.