Configure the Task Management App

This article explains the available configuration options for the Activiti task management in the CMS.

To configure the task management app create a gentics-activiti.properties file in the /Node/etc/ directory on the CMS-server (or on the server where the task management app is running). Make sure the Java-Process under which the app runs is allowed to read the file.

1 Database

To configure the database access for the task management please add the following properties

gentics-activiti.properties

db=mysql
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://<URL_TO_ACTIVITI_DB>
jdbc.username=<DB_USERNAME>
jdbc.password=<DB_PASSWORD>

We currently only support MySQL-Databases for the activiti task management app.

2 CMS connection

To configure access to the CMS REST API the following properties need to be set

gentics-activiti.properties

cms.rest.url=http://<HOSTNAME>/CNPortletapp/rest/
cms.rest.username=<USERNAME>
cms.rest.password=<PASSWORD>

The CMS user used by the engine to access the CMS REST API must have the Administration priviledge on Task Management and must be member of a sufficiently high CMS group. Users that can not be managed by this user will not be able to properly use the Task Management.

2.1 Other configuration properties

gentics-activiti.properties

activiti.app.available-processes.keys=onetaskprocess,dummyprocess
activiti.task.enable.comments=langselectTask
activiti.task.enable.files=langselectTask
  • activiti.app.available-processes.keys may contain a comma separated list of process definition keys of processes, that may be started directly from the UI
  • activiti.task.enable.comments may contain a comma separated list of task ids of tasks, for which comments should be available
  • activiti.task.enable.files may contain a comma separated list of task ids of tasks, for which file attachments should be available

2.2 Configuring access to the activiti server

Node/etc/conf.d/*.conf

$ACTIVITI_BASEURL = "/activiti"; ## /activiti is the default value

3 Custom Translations

See Configuration of Custom Translations

4 Permission settings

The permission settings for the CMS groups on the “Task Management” will be mapped to group types in activiti:

  • Groups with the Show and Administration setting will have the group type admin in activiti and will be able to see and manage process instances.
  • Groups with the Show setting will have the group type user in activiti and will be able to use the task management as users.
  • Groups without the Show setting will have the group type guest in activiti. Users in those groups will not be able to use the task management, but may still be assignee of open tasks.