Activiti Workflow Design Tool Installation


What tool is being used to design workflow definitions?

Defining a Workflow Definition starts with defining a Process Definition. DGC uses the activiti workflow engine internally for managing its Process Definitions. Activiti provides a free Eclipse plugin called activiti designer that can be used to design Process Definitions. For more information, see

After a Process Definition has been defined, you will have a *.bpmn or *.bpmn20.xml file that is ready to be deployed in the DGC. When a Process Definition is uploaded, a corresponding Workflow Definition will be created that is handled as an Asset by the DGC. This is your starting point for configuring the integration of the uploaded process with the DGC.

How to install the open-source Activity workflow design tool?

Part 1 – Install the Java Runtime Environment (JRE)

1. Download Java from Select “JRE Download”.


2. Follow the installation instructions (click next a lot). You may need to reboot your computer.

Shortcuts to installation instructions:


3. Add JAVA_HOME to your path (only required for Windows systems):

  1. a. Right-click the My Computer icon on your desktop and select Properties.
  2. b. Click the Advanced tab.
  3. c. Click the Environment Variables button.
  4. d. Under System Variables, click New.
  5. e. Enter the variable name as JAVA_HOME.
  6. f. Enter the variable value as the installation path for the Java Development Kit.
  7. If your Java installation directory has a space in its path name, you should use the shortened path name (e.g. C:Progra~1Javajre7) in the environment variable instead.
  8. g. Click OK.
  9. h. Click Apply Changes.


Part 2 – Install and run Eclipse

1. Download Eclipse v4 from, choose your operating system and click to download the package.(e.g., your operating system is Windows 32 Bit)

(note: choose the Eclipse version for your operating system).



2. Extract the zip file to a folder


3. Launch Eclipse by opening the folder and clicking the “eclipse” icon.



4. Eclipse starts and asks for a workspace folder. Pick the default one or click “Browse” to pick your own folder. All workflow project files will be put in this folder in the future.


5. Eclipse start screen.


Part 3 –  Install the Eclipse Activiti Designer plugin

1. In Eclipse, click Help > Install New Software

2. Enter the site “” as location

3. click “OK”, then in the next screen click “select all”.

Click “Next >”.



Click “Ok”.


Click “Yes”.


After it is restarted, click “Window” > “Open Perspective” > “Other…”

Click “Activiti” and then click “OK”.



Activiti Eclipse Designer View. Ready for work.


Go to the “Project Explorer”, right-click in the white pane and select “New” > “Project…”.


Select “Activity Project”, click “Next”, give the project a name and click “Finish”.

Part 4 – Add the Collibra APIs

1. Add a new folder in your project: right-click on the project, “New” > “Folder”. Give it the name “lib”.

2. Drag the Collibra jar (“com.collibra.dgc.core-4.2.x-FINAL”; where x corresponds to the release) into that folder, select “Copy files” as opposed to “Link to files”. Click “Ok”. This jar file is a part of the dgc.war file delivered as part of the software installation package. Contact you administrator to get the file or if you have a login to Compass just go to the Product releases page and go to the folder of the last version to find dgc.war.


3. Right-click on the project, select “Properties”, then “Java Build Path”, next go to the tab “Libraries”

4. Click “Add JARs…”, browse for the Collibra jar you just copied, click “Ok”, then click “Ok” again.



You have to login to comment.