WfeArchivingDeveloperGuide

From RunaWFE

Jump to: navigation, search

Archiving business processes instances and definitions module developer guide

Version 4.3.0

© 2015-2018, "Process Technologies" Ltd, this document is available under GNU FDL license. RUNA WFE is an open source system distributed under a LGPL license (http://www.gnu.org/licenses/lgpl.html).

Source code moved from https://sourceforge.net/p/runawfe to https://github.com/processtech.

# Building wfe-archiving module in WFE Server

To turn on archiving feature it's necessary to build WFE Server from source code, but before it it's necessary to do the following:

In wfe-app in pom.xml add archiving module

<module>../wfe-archiving</module>

In wfe-ear in pom.xml add

<dependency>
 <groupId>${project.groupId}</groupId>
  <artifactId>wfe-archiving</artifactId>
  <version>${project.version}</version>
  <type>ejb</type>
</dependency>

In the profile section add

<ejbModule>
 <groupId>${project.groupId}</groupId>
 <artifactId>wfe-archiving</artifactId>
</ejbModule>

Note. To build WFE Server with archiving feature module there's a profile jboss7. In this case module is build without dependencies.


# Building wfe-archiving client

There's 4 classes with main method in wfe-archiving client code:

  • ru.runa.wfe.client.BackupProcesses - for process instances archiving
  • ru.runa.wfe.client.BackupProcessDefinitions - for process definitions archiving
  • ru.runa.wfe.client.RestoreProcess - for process instances restoring
  • ru.runa.wfe.client.RestoreProcessDefinition - for process definitions restoring

By default client project is build with main class BackupProcesses, to build client with another functions in pom.xml file in wfe-archiving project find

<manifestEntries>
 <Main-Class>ru.runa.wfe.client.BackupProcesses</Main-Class>
</manifestEntries>

and change the class name for the corresponding one.

To build client application with all dependencies use client profile. To activate this profile type "client" in Profiles field in run configurations window. Create build configuration for maven as following:

ArchivingClientMvn.png


Note. Putting artifacts in local maven repository


If you use command line for maven build:

  • go to wfe-archiving folder
  • run command
mvn clean package –P client

Note. To put artifacts in local repository use command

mvn clean install -Dappserver=jboss7 -Dmaven.test.skip=true

Client build result jar (wfe-archiving-4.2.0-SNAPSHOT.jar) is in ..\wfe-archiving\target

Personal tools