Case Folder Configuration

Case folders can be configured:

  • when installing the ActiveMatrix BPM system, using the TIBCO Configuration Tool (TCT) Create TIBCO ActiveMatrix BPM Server wizard.
  • after installation, by either:
    • using the TIBCO Configuration Tool (TCT) Edit TIBCO ActiveMatrix BPM Instance wizard, or
    • editing the bds.properties or cm.properties properties files.

The following table describes the configuration properties available for case folder functionality, as well as where each property is configurable.

Note: Both the bds.properties and cm.properties files are located in the following directory on the machine in which ActiveMatrix BPM is installed:

CONFIG_HOME/bpm/bpm_app_name/configuration

Property Configured In Description
useCMISRepository TCT

bds.properties

Enables the Document Service used for case folders. This property must be set to true to use any of the Document Service API calls. It also enables calling of the Document Service by core BDS (Business Data Services). If set to true, case folders are automatically created upon deployment.

Default = false

deleteFolderOnUndeploymentOrCaseObjectDeletion bds.properties If true, folders for a particular case are automatically deleted when the case is deleted, as well as when a model is undeployed. If this property is set to false, folders must be deleted using the deleteOrphanedFolders API call.

Default = true

repoConnectionURL TCT

cm.properties

The URL used to connect to the CMS. This must be in the form:

http://CMSMachine:Port/cmsPath

where:
  • CMSMachine is the machine on which the CMS is running.
  • Port is the port using by the CMS.
  • cmsPath is the connection path used by your CMS.

For example:

http://localhost:9080/alfresco/api/-default-/public/cmis/versions/1.0/atom

repoBindingType TCT

cm.properties

The binding type used by the CMS.

Currently, this must be set to "atompub".

repoID TCT

cm.properties

The repository ID used by the CMS.
repoRootFolderPath TCT

cm.properties

The folder under which all sub-folders will be created in the CMS.

If you are using an external CMS, you must ensure that this folder exists. Unlike the folders beneath it, this folder is not created on demand.

repoConnectionTimeout cm.properties The number of milliseconds after which a timeout will occur if a connection cannot be made with the CMS. This value can be increased if a "connection timed out" message appears in the BPM.log file.

Default = 10000

repoReadTimeout cm.properties The number of milliseconds after which a timeout will occur if a read operation cannot be completed. This value can be increased if a "read timed out" message appears in the BPM.log file.

Default = 60000

trustStoreLocation TCT

cm.properties

The TrustStore file used when connecting to an HTTPS-enabled CMS. This is needed only if using HTTPS-based communications.
trustStoreType TCT

cm.properties

The TrustStore type. For example, JCEKS, JKS, etc. This is needed only if using HTTPS-based communications.
monitor.enable cm.properties Specifies whether or not the ActiveMatrix server will automatically detect and load changes made to this file at runtime.

This should normally be set to true.

CMS Administrative username and password TCT These values are stored in the ECMCredentialsKeystore shared resource for security purposes. They can only be configured using TCT.