obj objRef release

Available for: Content Management Server

Task: The specified file is released.

Syntax:

obj (withId objId) | (withPath path) | root release {parameter value}

Additional information: If the file has not been committed, it is committed before it is released (this means it is subjected to a commit operation). If signatures are still missing, they will be generated.

Function parameters:

• parameter specifies the name of a parameter of this workflow command. The following values are allowed:
  • comment specifies that value is a comment that appears in the log file (no task is generated for the workflow action release ).
• value contains the value of the respective parameter.

Return value if successful: none

Necessary permissions (CM only):

• Users to whom the permissionRoot permission has been granted for a file may unconditionally release this file at any time.
• If a file to which a workflow is assigned has a committed version, and only the last signature is missing from the workflow, the user requires read permission for this file and needs to be a member of a group authorized to provide the last signature.
• If the file concerned has a draft version, and the release action is the last step in the workflow of this version, the user needs to be its editor and have the permissionWrite permission for the file.
• If the file has a draft version and no released version, and there is no workflow assigned to the file, the user needs to be the editor of the version and have the permissionWrite permission for the file.

Example:

CM>obj withId 2003 release