OKMMail

Methods related to mail management.

Mail create(String token, Mail mail)

Create a new mail in the repository.

Parameters

• token - The session authorization token.
• mail - A mail object with the new mail properties.

Returns

• A mail object with the new created mail properties.

Throws

• PathNotFoundException - If the parent folder doesn't exist.
• ItemExistsException - If there is already a mail in the repository with the same name in the same path.
• AccessDeniedException - If there is any security problem: you can't modify the parent folder because of lack of permissions.
• RepositoryException - If there is any general repository problem.

Since

• OpenKM 4.1

Mail getProperties(String token, String mailPath)

Obtains properties from a previously created mail.

Parameters

• token -The session authorization token .
• mailPath - The path that identifies an unique mail.

Returns

• A mail object with the selected mail properties.

Throws

• ItemNotFoundException - If the indicated mail doesn't exist.
• RepositoryException - If there is any general repository problem.

Since

• OpenKM 4.1

void delete(String token, String mailPath)

Delete a mail the repository. It is a logical delete, so really is moved to the user trash and can be restored.

Parameters

• token - The session authorization token.
• mailPath - The path that identifies an unique mail.

Returns

• None

Throws

• LockException - Can't delete a mail with locked documents.
• PathNotFoundException - If there is no mail in the repository in this path.
• AccessDeniedException - If there is any security problem: you can't modify the mail because of lack of permissions.
• RepositoryException - If there is any general repository problem.

Since

• OpenKM 4.1

Mail rename(String token, String mailPath, String newName)

Rename a mail in the repository.

Parameters

• token - The session authorization token.
• mailPath - The path that identifies a mail node.
• newName - The new mail name.

Returns

• A mail object with the new mail properties.

Throws

• PathNotFoundException - If there is no mail in the repository in this path
• ItemExistsException - If there is already a mail in the repository with the same name in the same path.
• AccessDeniedException - If there is any security problem: you can't modify the mail because of lack of permissions.
• RepositoryException - If there is any general repository problem.

Since

• OpenKM 4.1

void move(String token, String mailPath, String dstPath)

Move a mail to another location in the repository.

Parameters

• token - The session authorization token.
• mailPath - The path that identifies an unique mail.
• dstPath - The path of the destination folder.

Returns

• A mail object with the new mail properties.

Throws

• PathNotFoundException - If the dstPath does not exists.
• ItemExistsException - If there is already a mail in the destination folder with the same name.
• AccessDeniedException - If there is any security problem: you can't modify the parent folder or the destination folder because of lack of permissions.
• RepositoryException - If there is any general repository problem.

Since

• OpenKM 4.1

MailArray getChilds(String token, String fldPath)

Retrieve a list of child mails from an existing folder.

Parameters

• token - The session authorization token.
• fldPath - The path that identifies an unique folder.

Returns

• A Collection with the child mails.

Throws

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

Since

• OpenKM 4.1

boolean isValid(String token, String mailPath)

Test if a mail path is valid.

Parameters

• token - String with user authorization info.
• mailPath - The path that identifies an unique mail.

Returns

• True if is a valid mail path, otherwise false.

Throws

• AccessDeniedException - If there is any security problem: you can't access this mail because of lack of permissions.
• RepositoryException - If there is any general repository problem.
• PathNotFoundException - If there is no mail in the repository with this path.

Since

• OpenKM 5.0

String getPath(String token, String uuid)

The the mail path from a UUID.

Parameters

• token - The session authorization token.
• uuid - The unique mail identifier.

Returns

• The mail path or null if this UUID does not correspond to a mail node.

Throws

• AccessDeniedException - If there is any security problem: you can't access this folder because of lack of permissions.
• RepositoryException If there is any general repository problem.

Since

• OpenKM 5.0