OKMPropertyGroup

From OpenKM Documentation
Jump to: navigation, search

Methods related to Property Groups.

void addGroup(String token, String nodePath, String grpName)

Add a property group to a document.

Parameters

  • token The session authorization token.
  • nodePath The path that identifies an unique node.
  • grpName The group name previously registered in the system.

Returns

  • None.

Throws

  • NoSuchGroupException If there is no such registered group name.
  • LockException Can't modify a locked document.
  • PathNotFoundException If there is no document in this repository path.
  • AccessDeniedException If there is any security problem: you can't modify the document because of lack of permissions.
  • RepositoryException If there is any general repository problem.

Since

  • OpenKM 4.1

void removeGroup(String token, String nodePath, String grpName)

Removes a property group from a document.

Parameters

  • token The session authorization token.
  • nodePath The path that identifies an unique node.
  • grpName The group name previously registered in the system.

Returns

  • None.

Throws

  • NoSuchGroupException If there is no such registered group name.
  • LockException Can't modify a locked document.
  • PathNotFoundException If there is no document in this repository path.
  • RepositoryException If there is any general repository problem.

Since

  • OpenKM 4.1

PropertyGroup[] getGroups(String token, String nodePath)

Get groups assigned to a document.

Parameters

  • token The session authorization token.
  • nodePath The path that identifies an unique node.

Returns

  • A list with all groups assigned to the document.

Throws

  • NoSuchGroupException If there is no such registered group name.
  • LockException Can't modify a locked document.
  • PathNotFoundException If there is no document in this repository path.
  • RepositoryException If there is any general repository problem.

Since

  • OpenKM 4.1

PropertyGroup[] getAllGroups(String token)

Get all groups defined in the system.

Parameters

  • token The session authorization token.

Returns

  • A list with all groups registered in the system.

Throws

  • RepositoryException If there is any general repository problem.

Since

  • OpenKM 4.1

FormElement[] getProperties(String token, String nodePath, String grpName)

Get all properties defined in a document by group.

Parameters

  • token The session authorization token.
  • nodePath The path that identifies an unique node.
  • grpName The group name previously registered in the system.

Returns

  • A list with all properties defined in the group and its actual values.

Throws

  • NoSuchGroupException If there is no such registered group name.
  • PathNotFoundException If there is no document in this repository path.
  • RepositoryException If there is any general repository problem.

Since

  • OpenKM 4.1

void setProperties(String token, String nodePath, String grpName, FormElementComplex[] properties)

Set group properties to a document.

Parameters

  • token The session authorization token.
  • nodePath The path that identifies an unique node.
  • grpName The group name previously registered in the system.
  • properties The property values.

Returns

  • None.

Throws

  • NoSuchPropertyException If there is no such registered category property.
  • NoSuchGroupException If there is no such registered group name.
  • LockException Can't modify a locked document.
  • PathNotFoundException If there is no document in this repository path.
  • AccessDeniedException If there is any security problem: you can't modify the document because of lack of permissions.
  • RepositoryException If there is any general repository problem.

Since

  • OpenKM 4.1

boolean hasGroup(String token, String nodePath, String grpName)

Test if a node has a property group assigned

Parameters

  • token The session authorization token.
  • nodePath The path that identifies an unique node.
  • grpName The group name previously registered in the system.

Returns

  • True if the document has the given property group assigned, and false otherwise.

Throws

  • NoSuchGroupException If there is no such registered group name.
  • PathNotFoundException If there is no document in this repository path.
  • RepositoryException If there is any general repository problem.

Since

  • OpenKM 5.0