本家 : http://www.activiti.org/userguide/
db=h2
jdbc.driver=org.h2.Driver
jdbc.url=jdbc:h2:mem:activiti;DB_CLOSE_DELAY=1000
jdbc.username=sa
jdbc.password=
# demo data properties
create.demo.users=true
create.demo.definitions=true
create.demo.models=true
create.demo.reports=true
# engine properties
engine.schema.update=true
engine.activate.jobexecutor=false
engine.asyncexecutor.enabled=true
engine.asyncexecutor.activate=true
engine.history.level=full
# email properties
#engine.email.enabled=true
#engine.email.host=localhost
#engine.email.port=1025
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">
<!-- 3.2.processEngineConfiguration
Stand alone app : org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration
Test (Use in-memory h2) : org.activiti.engine.impl.cfg.StandaloneInMemProcessEngineConfiguration
Spring integration : org.activiti.spring.SpringProcessEngineConfiguration
Stand alone app with JTA : org.activiti.engine.impl.cfg.JtaProcessEngineConfiguration
-->
<bean id="processEngineConfiguration"
class="org.activiti.engine.impl.cfg.StandaloneInMemProcessEngineConfiguration">
<!-- 3.3-3.8.database connection
support h2, musql, oracle, postgres, db2, mssql
-->
<property name="jdbcUrl" value="jdbc:h2:mem:activiti;DB_CLOSE_DELAY=1000" />
<property name="jdbcDriver" value="org.h2.Driver" />
<property name="jdbcUsername" value="sa" />
<property name="jdbcPassword" value="" />
<!-- Optional database connection properties * The unit of XXXTime is millisec *
<property name="jdbcMaxActiveConnections" value="10" />
<property name="jdbcMaxIdleConnections" value="" />
<property name="jdbcMaxCheckoutTime" value="20000" />
<property name="jdbcMaxWaitTime" value="20000" />
-->
<!-- Schema Update
false (default) : If the db schema version != activiti lib version then abend
true : If the db schema version != activiti lib version then update db schema
create-drop : Always create and drop schema
<property name="databaseSchemaUpdate" value="false" />
-->
<!-- 3.9-3.11 Job Executor
By default, the JobExecutor is activated when the process engine boots.
By default, the AsyncExecutor is not enabled and the JobExecutor is used
due to legacy reasons.
It?'s however recommended to use the new AsyncExecutor instead.
-->
<!--
<property name="jobExecutorActivate" value="false" />
<property name="asyncExecutorEnabled" value="true" />
<property name="asyncExecutorActivate" value="true" />
-->
<!-- 3.12. Mail Configuration (for email task)
|======================|=======================|
|property name | Default value |
|======================|=======================|
|mailServerHost | localhost |
|mailServerPort | 25 |
|mailServerDefaultFrom | activiti@activiti.org |
|mailServerUsername | (not set) |
|mailServerPassword | (not set) |
|mailServerUseSSL | (not set) |
|mailServerUseTLS | (not set) |
|======================|=======================|
-->
<property name="mailServerHost" value="localhost" />
<property name="mailServerPort" value="50025" />
<!-- 3.13. History (for logging task execution)
<property name="history" value="audit" />
-->
<!-- 3.15. Cache (default is no limit)
<property name="processDefinitionCacheLimit" value="10" />
-->
</bean>
</beans>
ProcessEngine processEngine = ProcessEngineConfiguration .createProcessEngineConfigurationFromInputStream(inputStream).buildProcessEngine()
ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration(); ProcessEngineConfiguration.createStandaloneInMemProcessEngineConfiguration();
ProcessEngine processEngine
= ProcessEngineConfiguration
.createStandaloneInMemProcessEngineConfiguration()
.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_FALSE)
.setJdbcUrl("jdbc:h2:mem:my-own-db;DB_CLOSE_DELAY=1000")
.setAsyncExecutorEnabled(true)
.setAsyncExecutorActivate(false)
.buildProcessEngine();ProcessEngine.destory(); ProcessEngine.init();を実行する必要あり
pom.xml <dependency> <groupId>ch.qos.logback</groupId> <artifactId>logback-classic</artifactId> </dependency>
pom.xml <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> </dependency>Activiti Explorer、 Activity Rest API はこの方式
pom.xml <dependency> <groupId>org.slf4j</groupId> <artifactId>jcl-over-slf4j</artifactId> </dependency>
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<withJansi>true</withJansi>
<encoder>
<pattern>%date [%thread] %highlight(%-5level) %-20logger{20} %mdc{mdcProcessDefinitionID} %msg %n</pattern>
</encoder>
</appender>
<bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
...
<property name="eventListeners">
<list>
<bean class="org.activiti.engine.example.MyEventListener" />
</list>
</property>
</bean>
<bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
...
<property name="typedEventListeners">
<map>
<entry key="JOB_EXECUTION_SUCCESS,JOB_EXECUTION_FAILURE" >
<list>
<bean class="org.activiti.engine.example.MyJobEventListener" />
</list>
</entry>
</map>
</property>
</bean>
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
| RuntimeService? | processEngine.getRuntimeService?() | プロセス管理 |
| RepositoryService? | processEngine.getRepositoryService?() | BPMN 管理。配備とか |
| TaskService? | processEngine.getTaskService?() | ユーザ操作の実現 (エミュレーション) |
| ManagementService? | processEngine.getManagementService?() | Activiti 自体の管理 |
| IdentityService? | processEngine.getIdentityService?() | 認証 |
| HistoryService? | processEngine.getHistoryService?() | タスク処理の記録をDBに永続化 |
| FormService? | processEngine.getFormService?() | タスク開始・終了時のユーザ確認 |


| Name | Activiti BPMN 2.0 designer |
| Location | http://activiti.org/designer/update/ |
<?xml version="1.0"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.snail.exam</groupId>
<artifactId>ActivitExam</artifactId>
<version>0.0.1-SNAPSHOT</version>
<dependencies>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-engine</artifactId>
<version>5.19.0</version>
</dependency>
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.1.3</version>
</dependency>
<dependency>
<groupId>com.h2database</groupId>
<artifactId>h2</artifactId>
<version>1.4.190</version>
</dependency>
</dependencies>
<build>
<plugins>
<!-- Make JAR OSGi Bundle Ready -->
<plugin>
<groupId>org.apache.felix</groupId>
<artifactId>maven-bundle-plugin</artifactId>
<version>2.3.7</version>
<extensions>true</extensions>
</plugin>
<!-- Compile -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.3</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>
</plugins>
</build>
<repositories>
<repository>
<!-- http://www.activiti.org/community.html -->
<id>Alfresco Maven Repository</id>
<url>https://maven.alfresco.com/nexus/content/groups/public/</url>
</repository>
</repositories>
</project>
ここでは、テスト用の Table をロードする設定(StandaloneInMemProcessEngineConfiguration?)を使う
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">
<!-- 3.2.processEngineConfiguration
Stand alone app : org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration
Test (Use in-memory h2) : org.activiti.engine.impl.cfg.StandaloneInMemProcessEngineConfiguration
Spring integration : org.activiti.spring.SpringProcessEngineConfiguration
Stand alone app with JTA : org.activiti.engine.impl.cfg.JtaProcessEngineConfiguration
-->
<bean id="processEngineConfiguration"
class="org.activiti.engine.impl.cfg.StandaloneInMemProcessEngineConfiguration">
<!-- 3.3-3.8.database connection
support h2, musql, oracle, postgres, db2, mssql
-->
<property name="jdbcUrl" value="jdbc:h2:mem:activiti;DB_CLOSE_DELAY=1000" />
<property name="jdbcDriver" value="org.h2.Driver" />
<property name="jdbcUsername" value="sa" />
<property name="jdbcPassword" value="" />
<!-- Optional database connection properties * The unit of XXXTime is millisec *
<property name="jdbcMaxActiveConnections" value="10" />
<property name="jdbcMaxIdleConnections" value="" />
<property name="jdbcMaxCheckoutTime" value="20000" />
<property name="jdbcMaxWaitTime" value="20000" />
-->
<!-- Schema Update
false (default) : If the db schema version != activiti lib version then abend
true : If the db schema version != activiti lib version then update db schema
create-drop : Always create and drop schema
<property name="databaseSchemaUpdate" value="false" />
-->
<!-- 3.9-3.11 Job Executor
By default, the JobExecutor is activated when the process engine boots.
By default, the AsyncExecutor is not enabled and the JobExecutor is used
due to legacy reasons.
It?'s however recommended to use the new AsyncExecutor instead.
-->
<!--
<property name="jobExecutorActivate" value="false" />
<property name="asyncExecutorEnabled" value="true" />
<property name="asyncExecutorActivate" value="true" />
-->
<!-- 3.12. Mail Configuration (for email task)
|======================|=======================|
|property name | Default value |
|======================|=======================|
|mailServerHost | localhost |
|mailServerPort | 25 |
|mailServerDefaultFrom | activiti@activiti.org |
|mailServerUsername | (not set) |
|mailServerPassword | (not set) |
|mailServerUseSSL | (not set) |
|mailServerUseTLS | (not set) |
|======================|=======================|
-->
<property name="mailServerHost" value="localhost" />
<property name="mailServerPort" value="50025" />
<!-- 3.13. History (for logging task execution)
<property name="history" value="audit" />
-->
<!-- 3.15. Cache (default is no limit)
<property name="processDefinitionCacheLimit" value="10" />
-->
</bean>
</beans>
ActivitiExplorerのデモアプリ で使った休暇申請のワークフローを /src/main/resources/org/activiti/test に配置
BMMNの配備(DB格納) → プロセス開始 (休暇申請) → 否決 → 再申請
の流れをやってみる
package com.snail.exam;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.RepositoryService;
import org.activiti.engine.RuntimeService;
import org.activiti.engine.TaskService;
import org.activiti.engine.repository.ProcessDefinition;
import org.activiti.engine.runtime.ProcessInstance;
import org.activiti.engine.task.Task;
import org.apache.commons.lang3.time.DateUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class MyProcess {
private static final Logger log = LoggerFactory.getLogger(MyProcess.class);
public static void main(String[] args) {
try {
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
// ----- 4.3.1. Deploying the process
log.info("--- #1. Deploying the process");
RepositoryService repositoryService = processEngine.getRepositoryService();
repositoryService.createDeployment()
.addClasspathResource("org/activiti/test/VacationRequest.bpmn20.xml")
.deploy();
log.info("Number of process definitions {}", repositoryService.createProcessDefinitionQuery().count());
for (ProcessDefinition p : repositoryService.createProcessDefinitionQuery().list()) {
log.info("PROCESS DEF [id={},name={},key={}]", p.getId(), p.getName(), p.getKey());
}
// ----- 4.3.2. Starting a process instance
log.info("--- #2. Starting a process instance");
// VacationRequest.bpmn20.xml L3-10
// --------------------------------------------------------------------------
// <process id="vacationRequest" name="Vacation request" isExecutable="true">
// ^^^^^^^^^^^^^^^
// <startEvent id="request" activiti:initiator="employeeName">
// ^^^^^^^*1 ^^^^^^^^^^^^ $employeeName = the user name
// <extensionElements>
// <activiti:formProperty id="numberOfDays" name="Number of days" type="long" required="true">
// ^^^^^^^^^^^^ ^^^^
// </activiti:formProperty>
// <activiti:formProperty id="startDate" name="First day of holiday (dd-MM-yyy)" type="date"
// ^^^^^^^^^ ^^^^
// datePattern="dd-MM-yyyy hh:mm" required="true"></activiti:formProperty>
// <activiti:formProperty id="vacationMotivation" name="Motivation" type="string">
// ^^^^^^^^^^^^^^^^^^ ^^^^^^
// </activiti:formProperty>
// </extensionElements>
// </startEvent>
// <activiti:formProperty>
Map<String, Object> variables = new HashMap<String, Object>();
variables.put("employeeName", "Kermit");
variables.put("numberOfDays", new Integer(4));
variables.put("startDate", DateUtils.parseDate("1999-12-31", "yyyy-MM-dd"));
variables.put("vacationMotivation", "I'm really tired!");
// the process to run
// id : <process id="vacationRequest">
// arguments : <activiti:formProperty>
RuntimeService runtimeService = processEngine.getRuntimeService();
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("vacationRequest", variables);
log.info("Number of process instances: " + runtimeService.createProcessInstanceQuery().count());
for (ProcessInstance p : runtimeService.createProcessInstanceQuery().list()) {
log.info("PROCESS INSTANCE [id={},pid={},pname={},pkey={}]"
, p.getId()
, p.getProcessDefinitionId()
, p.getProcessDefinitionName()
, p.getProcessDefinitionKey());
}
// ----- 4.3.3. Completing tasks (Reject Request)
// VacationRequest.bpmn20.xml L11-21
// --------------------------------------------------------------------------
// <sequenceFlow id="flow1" sourceRef="request" targetRef="handleRequest"></sequenceFlow>
// ^^^^^^^*1 ^^^^^^^^^^^^^*2
// <userTask id="handleRequest" name="Handle vacation request" activiti:candidateGroups="management">
// ^^^^^^^^^^^^^*2 ^^^^^^^^^^
// <documentation>${employeeName} would like to take ${numberOfDays} day(s) of vacation
// (Motivation: ${vacationMotivation}).</documentation>
// <extensionElements>
// <activiti:formProperty id="vacationApproved" name="Do you approve this vacation" type="enum"
// ^^^^^^^^^^^^^^^^
// required="true">
// <activiti:value id="true" name="Approve"></activiti:value>
// <activiti:value id="false" name="Reject"></activiti:value>
// </activiti:formProperty>
// <activiti:formProperty id="managerMotivation" name="Motivation" type="string"></activiti:formProperty>
// ^^^^^^^^^^^^^^^^^
// </extensionElements>
// </userTask>
log.info("--- #3. Completing tasks (Reject Request)");
// Fetch all tasks for the management group
TaskService taskService = processEngine.getTaskService();
List<Task> tasks = taskService.createTaskQuery().taskCandidateGroup("management").list();
for (Task task : tasks) {
if (task.getProcessDefinitionId().startsWith("vacationRequest")){
if (task.getTaskDefinitionKey().equals("handleRequest")) {
// Description is <documentation>.
log.info("TASK REJECT REQ [{}]", task.getDescription());
// Do task (reject application)
Map<String, Object> taskVariables = new HashMap<String, Object>();
taskVariables.put("vacationApproved", "false");
taskVariables.put("managerMotivation", "We have a tight deadline!");
taskService.complete(task.getId(), taskVariables);
}
}
}
// ----- 4.3.3. Completing tasks (Adjust rejected request)
// VacationRequest.bpmn20.xml L22-23
// --------------------------------------------------------------------------
// <sequenceFlow id="flow2" sourceRef="handleRequest" targetRef="requestApprovedDecision"></sequenceFlow>
// ^^^^^^^^^^^^^*2 ^^^^^^^^^^^^^^^^^^^^^^^*3
// <exclusiveGateway id="requestApprovedDecision" name="Request approved?"></exclusiveGateway>
// ^^^^^^^^^^^^^^^^^^^^^^^*3
//
// VacationRequest.bpmn20.xml L30-35
// --------------------------------------------------------------------------
// <sequenceFlow id="flow5" name="denied" sourceRef="requestApprovedDecision" targetRef="adjustVacationRequestTask">
// ^^^^^^^^^^^^^^^^^^^^^^^*3 ^^^^^^^^^^^^^^^^^^^^^^^^^*4
// <conditionExpression xsi:type="tFormalExpression"><![CDATA[${vacationApproved == 'false'}]]>
// ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
// </conditionExpression>
// </sequenceFlow>
// <userTask id="adjustVacationRequestTask" name="Adjust vacation request" activiti:assignee="${employeeName}">
// ^^^^^^^^^^^^^^^^^^^^^^^^^*4
// <documentation>Your manager has disapproved your vacation request for ${numberOfDays} days.
// Reason: ${managerMotivation}</documentation>
log.info("--- #4. Completing tasks (Adjust rejected request)");
taskService = processEngine.getTaskService();
tasks = taskService.createTaskQuery().active().list();
for (Task task : tasks) {
if (task.getProcessDefinitionId().startsWith("vacationRequest")){
if (task.getTaskDefinitionKey().equals("adjustVacationRequestTask")) {
// Description is <documentation>.
log.info("ADJUST REJECT REQ [{}]", task.getDescription());
}
}
}
} catch (Throwable th) {
log.error("ERROR", th);
}
}
}
16-03-24 00:24:21 [INFO ] Initializing process engine using configuration 'file:/Users/atsushi/EclipseWorkspace/ActivitExam/target/classes/activiti.cfg.xml'
16-03-24 00:24:21 [INFO ] initializing process engine for resource file:/Users/atsushi/EclipseWorkspace/ActivitExam/target/classes/activiti.cfg.xml
16-03-24 00:24:21 [INFO ] Loading XML bean definitions from resource loaded through InputStream
16-03-24 00:24:22 [INFO ] performing create on engine with resource org/activiti/db/create/activiti.h2.create.engine.sql
16-03-24 00:24:22 [INFO ] performing create on history with resource org/activiti/db/create/activiti.h2.create.history.sql
16-03-24 00:24:22 [INFO ] performing create on identity with resource org/activiti/db/create/activiti.h2.create.identity.sql
16-03-24 00:24:22 [INFO ] ProcessEngine default created
16-03-24 00:24:22 [INFO ] initialised process engine default
16-03-24 00:24:22 [INFO ] --- #1. Deploying the process
16-03-24 00:24:22 [INFO ] Processing resource org/activiti/test/VacationRequest.bpmn20.xml
16-03-24 00:24:23 [INFO ] Number of process definitions 1
16-03-24 00:24:23 [INFO ] PROCESS DEF [id=vacationRequest:1:4,name=Vacation request,key=vacationRequest]
16-03-24 00:24:23 [INFO ] --- #2. Starting a process instance
16-03-24 00:24:23 [INFO ] Number of process instances: 1
16-03-24 00:24:23 [INFO ] PROCESS INSTANCE [id=5,pid=vacationRequest:1:4,pname=Vacation request,pkey=vacationRequest]
16-03-24 00:24:23 [INFO ] --- #3. Completing tasks (Reject Request)
16-03-24 00:24:23 [INFO ] TASK REJECT REQ [Kermit would like to take 4 day(s) of vacation (Motivation: I'm really tired!).]
16-03-24 00:24:23 [INFO ] --- #4. Completing tasks (Adjust rejected request)
16-03-24 00:24:23 [INFO ] ADJUST REJECT REQ [Your manager has disapproved your vacation request for 4 days.
Reason: We have a tight deadline!]
I got it.log.info("--- #1. Deploying the process");
RepositoryService repositoryService = processEngine.getRepositoryService();
repositoryService.createDeployment()
.addClasspathResource("org/activiti/test/VacationRequest.bpmn20.xml")
.deploy()
Map<String, Object> variables = new HashMap<String, Object>();
variables.put("employeeName", "Kermit");
variables.put("numberOfDays", new Integer(4));
variables.put("startDate", DateUtils.parseDate("1999-12-31", "yyyy-MM-dd"));
variables.put("vacationMotivation", "I'm really tired!");
RuntimeService runtimeService = processEngine.getRuntimeService();
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("vacationRequest", variables);
<process id="vacationRequest" name="Vacation request" isExecutable="true">
<startEvent id="request" activiti:initiator="employeeName">
<extensionElements>
<activiti:formProperty id="numberOfDays" name="Number of days" type="long" required="true"></activiti:formProperty>
<activiti:formProperty id="startDate" name="First day of holiday (dd-MM-yyy)" type="date"
datePattern="dd-MM-yyyy hh:mm" required="true"></activiti:formProperty>
<activiti:formProperty id="vacationMotivation" name="Motivation" type="string"></activiti:formProperty>
</extensionElements>
</startEvent>TaskService taskService = processEngine.getTaskService();
List<Task> tasks = taskService.createTaskQuery().taskCandidateGroup("management").list();
for (Task task : tasks) {
if (task.getProcessDefinitionId().startsWith("vacationRequest")){
if (task.getTaskDefinitionKey().equals("handleRequest")) {
// Description is <documentation>.
log.info("TASK REJECT REQ [{}]", task.getDescription());
// Do task (reject application)
Map<String, Object> taskVariables = new HashMap<String, Object>();
taskVariables.put("vacationApproved", "false");
taskVariables.put("managerMotivation", "We have a tight deadline!");
taskService.complete(task.getId(), taskVariables);
}
}
}
<userTask id="handleRequest" name="Handle vacation request" activiti:candidateGroups="management">
<documentation>${employeeName} would like to take ${numberOfDays} day(s) of vacation
(Motivation: ${vacationMotivation}).</documentation>
<extensionElements>
<activiti:formProperty id="vacationApproved" name="Do you approve this vacation" type="enum" required="true">
<activiti:value id="true" name="Approve"></activiti:value>
<activiti:value id="false" name="Reject"></activiti:value>
</activiti:formProperty>
<activiti:formProperty id="managerMotivation" name="Motivation" type="string"></activiti:formProperty>
</extensionElements>
</userTask>log.info("TASK REJECT REQ [{}]", task.getDescription());package com.snail.exam;
import java.util.HashMap;
import java.util.Map;
import org.activiti.engine.ActivitiException;
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.RepositoryService;
import org.activiti.engine.RuntimeService;
import org.activiti.engine.runtime.ProcessInstance;
import org.apache.commons.lang3.time.DateUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class MyProcess2 {
private static final Logger log = LoggerFactory.getLogger(MyProcess2.class);
public static void main(String[] args) {
try {
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
// ----- 4.3.1. Deploying the process
log.info("--- #1. Deploying the process");
RepositoryService repositoryService = processEngine.getRepositoryService();
repositoryService.createDeployment()
.addClasspathResource("org/activiti/test/VacationRequest.bpmn20.xml")
.deploy();
// ----- 4.3.4. Suspending and activating a process
log.info("--- #2. Suspend Process");
repositoryService.suspendProcessDefinitionByKey("vacationRequest");
// ----- 4.3.2. Starting a process instance
log.info("--- #3. Starting a process instance (will fail)");
Map<String, Object> variables = new HashMap<String, Object>();
variables.put("employeeName", "Kermit");
variables.put("numberOfDays", new Integer(4));
variables.put("startDate", DateUtils.parseDate("1999-12-31", "yyyy-MM-dd"));
variables.put("vacationMotivation", "I'm really tired!");
// the process to run
// id : <process id="vacationRequest">
// arguments : <activiti:formProperty>
RuntimeService runtimeService = processEngine.getRuntimeService();
try {
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("vacationRequest", variables);
} catch (ActivitiException e) {
log.error("ERROR", e);
}
// ----- 4.3.4. Suspending and activating a process
log.info("--- #5. Activate Process");
repositoryService.activateProcessDefinitionByKey("vacationRequest");
log.info("--- #6. Starting a process instance (will success)");
try {
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("vacationRequest", variables);
log.info("{} was started", processInstance.getProcessDefinitionId());
} catch (ActivitiException e) {
log.error("ERROR", e);
}
} catch (Throwable th) {
log.error("ERROR", th);
}
}
}
16-03-25 01:12:03 [INFO ] Initializing process engine using configuration 'file:/Users/atsushi/EclipseWorkspace/ActivitExam/target/classes/activiti.cfg.xml'
16-03-25 01:12:03 [INFO ] initializing process engine for resource file:/Users/atsushi/EclipseWorkspace/ActivitExam/target/classes/activiti.cfg.xml
16-03-25 01:12:03 [INFO ] Loading XML bean definitions from resource loaded through InputStream
16-03-25 01:12:04 [INFO ] performing create on engine with resource org/activiti/db/create/activiti.h2.create.engine.sql
16-03-25 01:12:04 [INFO ] performing create on history with resource org/activiti/db/create/activiti.h2.create.history.sql
16-03-25 01:12:05 [INFO ] performing create on identity with resource org/activiti/db/create/activiti.h2.create.identity.sql
16-03-25 01:12:05 [INFO ] ProcessEngine default created
16-03-25 01:12:05 [INFO ] initialised process engine default
16-03-25 01:12:05 [INFO ] --- #1. Deploying the process
16-03-25 01:12:05 [INFO ] Processing resource org/activiti/test/VacationRequest.bpmn20.xml
16-03-25 01:12:06 [INFO ] --- #2. Suspend Process
16-03-25 01:12:06 [INFO ] --- #3. Starting a process instance (will fail)
16-03-25 01:12:06 [INFO ] Processing resource org/activiti/test/VacationRequest.vacationRequest.png
16-03-25 01:12:06 [INFO ] Processing resource org/activiti/test/VacationRequest.bpmn20.xml
16-03-25 01:12:06 [ERROR] ERROR
org.activiti.engine.ActivitiException: Cannot start process instance. Process definition Vacation request (id = vacationRequest:1:4) is suspended
at org.activiti.engine.impl.cmd.StartProcessInstanceCmd.execute(StartProcessInstanceCmd.java:94) ~[activiti-engine-5.19.0.jar:5.19.0]
at org.activiti.engine.impl.cmd.StartProcessInstanceCmd.execute(StartProcessInstanceCmd.java:37) ~[activiti-engine-5.19.0.jar:5.19.0]
at org.activiti.engine.impl.interceptor.CommandInvoker.execute(CommandInvoker.java:24) ~[activiti-engine-5.19.0.jar:5.19.0]
at org.activiti.engine.impl.interceptor.CommandContextInterceptor.execute(CommandContextInterceptor.java:57) ~[activiti-engine-5.19.0.jar:5.19.0]
at org.activiti.engine.impl.interceptor.LogInterceptor.execute(LogInterceptor.java:31) ~[activiti-engine-5.19.0.jar:5.19.0]
at org.activiti.engine.impl.cfg.CommandExecutorImpl.execute(CommandExecutorImpl.java:40) ~[activiti-engine-5.19.0.jar:5.19.0]
at org.activiti.engine.impl.cfg.CommandExecutorImpl.execute(CommandExecutorImpl.java:35) ~[activiti-engine-5.19.0.jar:5.19.0]
at org.activiti.engine.impl.RuntimeServiceImpl.startProcessInstanceByKey(RuntimeServiceImpl.java:77) ~[activiti-engine-5.19.0.jar:5.19.0]
at com.snail.exam.MyProcess2.main(MyProcess2.java:49) ~[classes/:na]
16-03-25 01:12:06 [INFO ] --- #5. Activate Process
16-03-25 01:12:06 [INFO ] --- #6. Starting a process instance (will success)
16-03-25 01:12:06 [INFO ] Processing resource org/activiti/test/VacationRequest.vacationRequest.png
16-03-25 01:12:06 [INFO ] Processing resource org/activiti/test/VacationRequest.bpmn20.xml
16-03-25 01:12:06 [INFO ] vacationRequest:1:4 was started
List<Task> tasks = taskService.createTaskQuery()
.taskAssignee("kermit")
.processVariableValueEquals("orderId", "0815")
.orderByDueDate().asc()
.list();
List<Task> tasks = taskService.createNativeTaskQuery()
.sql("SELECT count(*) FROM " + managementService.getTableName(Task.class) + " T WHERE T.NAME_ = #{taskName}")
.parameter("taskName", "gonzoTask")
.list();
long count = taskService.createNativeTaskQuery()
.sql("SELECT count(*) FROM " + managementService.getTableName(Task.class) + " T1, "
+ managementService.getTableName(VariableInstanceEntity.class) + " V1 WHERE V1.TASK_ID_ = T1.ID_")
.count();


package com.snail.exam;
import java.util.ArrayList;
import java.util.List;
import org.activiti.engine.delegate.DelegateExecution;
import org.activiti.engine.delegate.JavaDelegate;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class VariableTask implements JavaDelegate {
private static final Logger log = LoggerFactory.getLogger(VariableTask.class);
@Override
public void execute(DelegateExecution execution) throws Exception {
String id = execution.getCurrentActivityName();
log.info(id);
// Dump variables
List<String> keys = new ArrayList<String>(execution.getVariableNames());
keys.sort((o1,o2)->{return o1.compareTo(o2);});
keys.forEach((key)->{
log.info("@{} EXEC SCOPE {} = {}", id, key, execution.getVariable(key));
});
List<String> keysLocal = new ArrayList<String>(execution.getVariableNamesLocal());
keysLocal.sort((o1,o2)->{return o1.compareTo(o2);});
keysLocal.forEach((key)->{
log.info("@{} LOCAL SCOPE {} = {}", id, key, execution.getVariableLocal(key));
});
// Update variables
execution.getVariableNames().forEach((name)->{
execution.setVariable(name, id);
});
execution.getVariableNamesLocal().forEach((name)->{
execution.setVariableLocal(name, id);
});
execution.setVariable(id + "_EXEC", id);
execution.setVariable(id + "_LOCAL", id);
}
}
16-05-21 23:38:30 [INFO ] Initializing process engine using configuration 'file:/Users/atsushi/EclipseWorkspace/ActivitExam/target/classes/activiti.cfg.xml'
16-05-21 23:38:30 [INFO ] initializing process engine for resource file:/Users/atsushi/EclipseWorkspace/ActivitExam/target/classes/activiti.cfg.xml
16-05-21 23:38:30 [INFO ] Loading XML bean definitions from resource loaded through InputStream
16-05-21 23:38:31 [INFO ] performing create on engine with resource org/activiti/db/create/activiti.h2.create.engine.sql
16-05-21 23:38:31 [INFO ] performing create on history with resource org/activiti/db/create/activiti.h2.create.history.sql
16-05-21 23:38:31 [INFO ] performing create on identity with resource org/activiti/db/create/activiti.h2.create.identity.sql
16-05-21 23:38:31 [INFO ] ProcessEngine default created
16-05-21 23:38:31 [INFO ] initialised process engine default
16-05-21 23:38:31 [INFO ] --- #1. Deploying the process
16-05-21 23:38:31 [INFO ] Processing resource org/activiti/test/VariableProcess.bpmn
16-05-21 23:38:32 [INFO ] TaskA
16-05-21 23:38:32 [INFO ] @TaskA EXEC SCOPE start = Start
16-05-21 23:38:32 [INFO ] @TaskA LOCAL SCOPE start = Start
16-05-21 23:38:32 [INFO ] TaskB
16-05-21 23:38:32 [INFO ] @TaskB EXEC SCOPE TaskA_EXEC = TaskA
16-05-21 23:38:32 [INFO ] @TaskB EXEC SCOPE TaskA_LOCAL = TaskA
16-05-21 23:38:32 [INFO ] @TaskB EXEC SCOPE start = TaskA
16-05-21 23:38:32 [INFO ] TaskC
16-05-21 23:38:32 [INFO ] @TaskC EXEC SCOPE TaskA_EXEC = TaskB
16-05-21 23:38:32 [INFO ] @TaskC EXEC SCOPE TaskA_LOCAL = TaskB
16-05-21 23:38:32 [INFO ] @TaskC EXEC SCOPE TaskB_EXEC = TaskB
16-05-21 23:38:32 [INFO ] @TaskC EXEC SCOPE TaskB_LOCAL = TaskB
16-05-21 23:38:32 [INFO ] @TaskC EXEC SCOPE start = TaskB
16-05-21 23:38:32 [INFO ] TaskD
16-05-21 23:38:32 [INFO ] @TaskD EXEC SCOPE TaskA_EXEC = TaskC
16-05-21 23:38:32 [INFO ] @TaskD EXEC SCOPE TaskA_LOCAL = TaskC
16-05-21 23:38:32 [INFO ] @TaskD EXEC SCOPE TaskB_EXEC = TaskC
16-05-21 23:38:32 [INFO ] @TaskD EXEC SCOPE TaskB_LOCAL = TaskC
16-05-21 23:38:32 [INFO ] @TaskD EXEC SCOPE TaskC_EXEC = TaskC
16-05-21 23:38:32 [INFO ] @TaskD EXEC SCOPE TaskC_LOCAL = TaskC
16-05-21 23:38:32 [INFO ] @TaskD EXEC SCOPE start = TaskC
16-05-21 23:38:32 [INFO ] TaskE
16-05-21 23:38:32 [INFO ] @TaskE EXEC SCOPE TaskA_EXEC = TaskD
16-05-21 23:38:32 [INFO ] @TaskE EXEC SCOPE TaskA_LOCAL = TaskD
16-05-21 23:38:32 [INFO ] @TaskE EXEC SCOPE TaskB_EXEC = TaskD
16-05-21 23:38:32 [INFO ] @TaskE EXEC SCOPE TaskB_LOCAL = TaskD
16-05-21 23:38:32 [INFO ] @TaskE EXEC SCOPE TaskC_EXEC = TaskD
16-05-21 23:38:32 [INFO ] @TaskE EXEC SCOPE TaskC_LOCAL = TaskD
16-05-21 23:38:32 [INFO ] @TaskE EXEC SCOPE TaskD_EXEC = TaskD
16-05-21 23:38:32 [INFO ] @TaskE EXEC SCOPE TaskD_LOCAL = TaskD
16-05-21 23:38:32 [INFO ] @TaskE EXEC SCOPE start = TaskD
16-05-21 23:38:32 [INFO ] TaskF
16-05-21 23:38:32 [INFO ] @TaskF EXEC SCOPE TaskA_EXEC = TaskE
16-05-21 23:38:32 [INFO ] @TaskF EXEC SCOPE TaskA_LOCAL = TaskE
16-05-21 23:38:32 [INFO ] @TaskF EXEC SCOPE TaskB_EXEC = TaskE
16-05-21 23:38:32 [INFO ] @TaskF EXEC SCOPE TaskB_LOCAL = TaskE
16-05-21 23:38:32 [INFO ] @TaskF EXEC SCOPE TaskC_EXEC = TaskE
16-05-21 23:38:32 [INFO ] @TaskF EXEC SCOPE TaskC_LOCAL = TaskE
16-05-21 23:38:32 [INFO ] @TaskF EXEC SCOPE TaskD_EXEC = TaskE
16-05-21 23:38:32 [INFO ] @TaskF EXEC SCOPE TaskD_LOCAL = TaskE
16-05-21 23:38:32 [INFO ] @TaskF EXEC SCOPE TaskE_EXEC = TaskE
16-05-21 23:38:32 [INFO ] @TaskF EXEC SCOPE TaskE_LOCAL = TaskE
16-05-21 23:38:32 [INFO ] @TaskF EXEC SCOPE start = TaskE
16-05-21 23:38:32 [INFO ] @TaskF LOCAL SCOPE TaskA_EXEC = TaskE
16-05-21 23:38:32 [INFO ] @TaskF LOCAL SCOPE TaskA_LOCAL = TaskE
16-05-21 23:38:32 [INFO ] @TaskF LOCAL SCOPE TaskB_EXEC = TaskE
16-05-21 23:38:32 [INFO ] @TaskF LOCAL SCOPE TaskB_LOCAL = TaskE
16-05-21 23:38:32 [INFO ] @TaskF LOCAL SCOPE TaskC_EXEC = TaskE
16-05-21 23:38:32 [INFO ] @TaskF LOCAL SCOPE TaskC_LOCAL = TaskE
16-05-21 23:38:32 [INFO ] @TaskF LOCAL SCOPE TaskD_EXEC = TaskE
16-05-21 23:38:32 [INFO ] @TaskF LOCAL SCOPE TaskD_LOCAL = TaskE
16-05-21 23:38:32 [INFO ] @TaskF LOCAL SCOPE TaskE_EXEC = TaskE
16-05-21 23:38:32 [INFO ] @TaskF LOCAL SCOPE TaskE_LOCAL = TaskE
16-05-21 23:38:32 [INFO ] @TaskF LOCAL SCOPE start = TaskE
public class MyBusinessProcessTest {
@Rule
public ActivitiRule activitiRule = new ActivitiRule();
@Test
@Deployment
public void ruleUsageExample() {
RuntimeService runtimeService = activitiRule.getRuntimeService();
runtimeService.startProcessInstanceByKey("ruleUsage");
TaskService taskService = activitiRule.getTaskService();
Task task = taskService.createTaskQuery().singleResult();
assertEquals("My Task", task.getName());
taskService.complete(task.getId());
assertEquals(0, runtimeService.createProcessInstanceQuery().count());
}
}
@Deployment で BPMN を配備することもできる
@Deplpyment(resources = {"org/activiti/examples/bpmn/executionListener/ExecutionListenersFieldInjectionProcess.bpmn20.xml"})
@WebServletContextListener
public class ProcessEnginesServletContextListener implements ServletContextListener {
public void contextInitialized(ServletContextEvent servletContextEvent) {
ProcessEngines.init();
}
public void contextDestroyed(ServletContextEvent servletContextEvent) {
ProcessEngines.destroy();
}
}
コンソールアプリと同じように ProcessEngines?.getDefaultProcessEngine?() で ProcessEngine? を取得するが、アプリ再起動で確実に設定ファイルが反映されるように ServletContextListener? で ProcessEngine?.init(), ProcessEngine?.destroy() を実行する
{processDefinitionKey}:{processDefinitionVersion}:{generated-id}
<definitions id="definitions"
targetNamespace="http://activiti.org/bpmn20"
xmlns:activiti="http://activiti.org/bpmn"
xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL">
<process id="financialReport" name="Monthly financial report reminder process">
<startEvent id="theStart" />
<sequenceFlow id='flow1' sourceRef='theStart' targetRef='writeReportTask' />
<userTask id="writeReportTask" name="Write monthly financial report" >
<documentation>
Write monthly financial report for publication to shareholders.
</documentation>
<potentialOwner>
<resourceAssignmentExpression>
<formalExpression>accountancy</formalExpression>
</resourceAssignmentExpression>
</potentialOwner>
</userTask>
<sequenceFlow id='flow2' sourceRef='writeReportTask' targetRef='verifyReportTask' />
<userTask id="verifyReportTask" name="Verify monthly financial report" >
<documentation>
Verify monthly financial report composed by the accountancy department.
This financial report is going to be sent to all the company shareholders.
</documentation>
<potentialOwner>
<resourceAssignmentExpression>
<formalExpression>management</formalExpression>
</resourceAssignmentExpression>
</potentialOwner>
</userTask>
<sequenceFlow id='flow3' sourceRef='verifyReportTask' targetRef='theEnd' />
<endEvent id="theEnd" />
</process>
</definitions>

ProcessInstance processInstance
= runtimeService.startProcessInstanceByKey("financialReport");
でプロセスを開始すると、<startEvent> からプロセスが始まるpotentialOwner> で、実行可能なユーザ(または ロール)を指定できる。
実行権限ロールの人がタスクを個人指定で処理要求したいときにはList<Task> tasks = taskService.createTaskQuery().taskAssignee("fozzie").list(); for (Task task : tasks) { if (....) { taskService.claim(task.getId(), "fozzie"); } }プログラムでタスクを終わらせたい場合には
List<Task> tasks = taskService.createTaskQuery().taskAssignee("fozzie").list(); for (Task task : tasks) { if (....) { taskService.complete(task.getId()); } }

RuntimeService.signalEventReceived(String signalName); RuntimeService.signalEventReceived(String signalName, String executionId);
RuntimeService.messageEventReceived(String messageName, String executionId); RuntimeService.messageEventReceived(String messageName, String executionId, HashMap<String, Object> processVariables);
ProcessInstance.startProcessInstanceByMessage(String messageName); ProcessInstance.startProcessInstanceByMessage(String messageName, Map<String, Object> processVariables); ProcessInstance.startProcessInstanceByMessage(String messageName, String businessKey, Map<String, Object> processVariables);
ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery()
.messageEventSubscription("newCallCenterBooking")
.singleResult();Execution execution = runtimeService.createExecutionQuery()
.messageEventSubscriptionName("paymentReceived")
.variableValueEquals("orderId", message.getOrderId())
.singleResult();
<sequenceFlow id="flow1" sourceRef="theStart" targetRef="theTask" />

<exclusiveGateway id="exclusiveGw" name="Exclusive Gateway" />
<sequenceFlow id="flow2" sourceRef="exclusiveGw" targetRef="theTask1">
<conditionExpression xsi:type="tFormalExpression">${input == 1}</conditionExpression>
</sequenceFlow>
<sequenceFlow id="flow3" sourceRef="exclusiveGw" targetRef="theTask2">
<conditionExpression xsi:type="tFormalExpression">${input == 2}</conditionExpression>
</sequenceFlow>
<sequenceFlow id="flow4" sourceRef="exclusiveGw" targetRef="theTask3">
<conditionExpression xsi:type="tFormalExpression">${input == 3}</conditionExpression>
</sequenceFlow>
<sequenceFlow id="flow7" sourceRef="exclusivegateway1" targetRef="usertask3">
<conditionExpression xsi:type="tFormalExpression"><![CDATA[${val > 100}]]></conditionExpression>
</sequenceFlow><startEvent id="theStart" />
<sequenceFlow id="flow1" sourceRef="theStart" targetRef="fork" />
<parallelGateway id="fork" />
<sequenceFlow sourceRef="fork" targetRef="receivePayment" />
<sequenceFlow sourceRef="fork" targetRef="shipOrder" />
<userTask id="receivePayment" name="Receive Payment" />
<sequenceFlow sourceRef="receivePayment" targetRef="join" />
<userTask id="shipOrder" name="Ship Order" />
<sequenceFlow sourceRef="shipOrder" targetRef="join" />
<parallelGateway id="join" />
<sequenceFlow sourceRef="join" targetRef="archiveOrder" />
<userTask id="archiveOrder" name="Archive Order" />
<sequenceFlow sourceRef="archiveOrder" targetRef="theEnd" />
<endEvent id="theEnd" />
<startEvent id="theStart" />
<sequenceFlow id="flow1" sourceRef="theStart" targetRef="fork" />
<inclusiveGateway id="fork" />
<sequenceFlow sourceRef="fork" targetRef="receivePayment" >
<conditionExpression xsi:type="tFormalExpression">${paymentReceived == false}</conditionExpression>
</sequenceFlow>
<sequenceFlow sourceRef="fork" targetRef="shipOrder" >
<conditionExpression xsi:type="tFormalExpression">${shipOrder == true}</conditionExpression>
</sequenceFlow>
<userTask id="receivePayment" name="Receive Payment" />
<sequenceFlow sourceRef="receivePayment" targetRef="join" />
<userTask id="shipOrder" name="Ship Order" />
<sequenceFlow sourceRef="shipOrder" targetRef="join" />
<inclusiveGateway id="join" />
<sequenceFlow sourceRef="join" targetRef="archiveOrder" />
<userTask id="archiveOrder" name="Archive Order" />
<sequenceFlow sourceRef="archiveOrder" targetRef="theEnd" />
<endEvent id="theEnd" />
<definitions id="definitions"
xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL"
xmlns:activiti="http://activiti.org/bpmn"
targetNamespace="Examples">
<signal id="alertSignal" name="alert" />
<process id="catchSignal">
<startEvent id="start" />
<sequenceFlow sourceRef="start" targetRef="gw1" />
<eventBasedGateway id="gw1" />
<sequenceFlow sourceRef="gw1" targetRef="signalEvent" />
<sequenceFlow sourceRef="gw1" targetRef="timerEvent" />
<intermediateCatchEvent id="signalEvent" name="Alert">
<signalEventDefinition signalRef="alertSignal" />
</intermediateCatchEvent>
<intermediateCatchEvent id="timerEvent" name="Alert">
<timerEventDefinition>
<timeDuration>PT10M</timeDuration>
</timerEventDefinition>
</intermediateCatchEvent>
<sequenceFlow sourceRef="timerEvent" targetRef="exGw1" />
<sequenceFlow sourceRef="signalEvent" targetRef="task" />
<userTask id="task" name="Handle alert"/>
<exclusiveGateway id="exGw1" />
<sequenceFlow sourceRef="task" targetRef="exGw1" />
<sequenceFlow sourceRef="exGw1" targetRef="end" />
<endEvent id="end" />
</process>
</definitions>

<userTask id="theTask" name="Important task" />
<scriptTask id="theScriptTask" name="Execute script" scriptFormat="groovy">
<script>
sum = 0
for ( i in inputArray ) {
sum += i
}
</script>
</scriptTask>
<script>
def scriptVar = "test123"
execution.setVariable("myVar", scriptVar)
</script>
<dependency>
<groupId>org.codehaus.groovy</groupId>
<artifactId>groovy-all</artifactId>
<version>2.x.x<version>
</dependency>
を追記する必要あり <serviceTask id="javaService"
name="My Java Service Task"
activiti:class="org.activiti.MyJavaDelegate" />
(Activiti が Spring コンテナ上で動いている場合には、Spring が管理している Bean を lookup したり、その任意のメソッドを実行できる。public class MyJavaDelegate implements JavaDelegate {
public void execute(DelegateExecution execution) throws Exception {
String var = (String) execution.getVariable("input");
var = var.toUpperCase();
execution.setVariable("input", var);
}
}
<serviceTask id="javaService" name="Java service invocation"
activiti:class="org.activiti.examples.bpmn.servicetask.ReverseStringsFieldInjected">
<extensionElements>
<activiti:field name="text1">
<activiti:expression>${genderBean.getGenderString(gender)}</activiti:expression>
</activiti:field>
<activiti:field name="text2">
<activiti:expression>Hello ${gender == 'male' ? 'Mr.' : 'Mrs.'} ${name}</activiti:expression>
</activiti:field>
</ extensionElements>
</ serviceTask>
フィールド変数 text1、text2 に BPMN で指定した値を設定できる<serviceTask id="servicetask1" name="Service Task" activiti:class="...">
<extensionElements>
<activiti:mapException errorCode="myErrorCode1"/>
</extensionElements>
</serviceTask>
例外が発生したら、エラーコード myErrorCode1 で終了
<serviceTask id="servicetask1" name="Service Task" activiti:class="...">
<extensionElements>
<activiti:mapException
errorCode="myErrorCode1">org.activiti.SomeException</activiti:mapException>
</extensionElements>
</serviceTask>
<serviceTask id="servicetask1" name="Service Task" activiti:class="...">
<extensionElements>
<activiti:mapException errorCode="myErrorCode1"
includeChildExceptions="true">org.activiti.SomeException</activiti:mapException>
</extensionElements>
</serviceTask>
<serviceTask id="mailtask1" name="Mail Task" activiti:type="mail">
<extensionElements>
<activiti:field name="from">
<activiti:string><![CDATA[order-shipping@thecompany.com]]></activiti:string>
</activiti:field>
<activiti:field name="to">
<activiti:expression><![CDATA[foo@example.com]]></activiti:expression>
</activiti:field>
<activiti:field name="subject">
<activiti:string><![CDATA[ENGLISH SUBJECT 日本語の件名]]></activiti:string>
</activiti:field>
<activiti:field name="charset">
<activiti:string><![CDATA[iso-2022-jp]]></activiti:string>
</activiti:field>
<activiti:field name="text">
<activiti:string><![CDATA[ENGLISH MESSAGE
日本語の本文]]></activiti:string>
</activiti:field>
</extensionElements>
</serviceTask>
| activiti:field name="" | 設定内容 |
| to | TO |
| from | FROM |
| subject | SUBJECT |
| cc | CC |
| bcc | BCC |
| charset | 日本語なら iso-2022-jp やね |
| html | HTML Mail 平文+EL式 で指定 |
| text | Text Mail 平文+EL式 で指定 |
| htmlVar | HTML Mail の全文が格納されているプロセス変数名 |
| textVar | Text Mail の全文が格納されているプロセス変数名 |
| ignoreException | 例外を無視 |
| exceptionVariableName? | ignoreException=true のとき、発生した Exception を格納するプロセス変数名 |
<serviceTask id="i hope it" activiti:type="camel" >
<extensionElements>
<activiti:field name="from" stringValue="file:/a/b" />
<activiti:field name="to" stringValue=""log:edi_send" />
<activiti:field name="to" stringValue="ftp:/edi" />
</extensionElements>
</serviceTask>
<manualTask id="myManualTask" name="Call client for more information" />
<receiveTask id="waitState" name="wait" />
ProcessInstance pi = runtimeService.startProcessInstanceByKey("receiveTask");
Execution execution = runtimeService.createExecutionQuery()
.processInstanceId(pi.getId())
.activityId("waitState")
.singleResult();
assertNotNull(execution);
runtimeService.signal(execution.getId());
<serviceTask id="shellEcho" activiti:type="shell" >
<extensionElements>
<activiti:field name="command" stringValue="cmd" />
<activiti:field name="arg1" stringValue="/c" />
<activiti:field name="arg2" stringValue="echo" />
<activiti:field name="arg3" stringValue="EchoTest" />
<activiti:field name="wait" stringValue="true" />
<activiti:field name="outputVariable" stringValue="resultVar" />
</extensionElements>
</serviceTask>
<process id="executionListenersProcess">
...
<extensionElements>
<activiti:executionListener class="com.foo.ExecutionListenerOne" event="start" />
</extensionElements>
...
<startEvent id="theStart">
<sequenceFlow sourceRef="theStart" ...
...
</process>
import org.activiti.engine.delegate.ExecutionListener;
import org.activiti.engine.delegate.ExecutionListenerExecution;
public class ExecutionListenerOne implements ExecutionListener {
public void notify(ExecutionListenerExecution execution) throws Exception {
execution.setVariable("variableSetInExecutionListener", "firstValue");
execution.setVariable("eventReceived", execution.getEventName());
}
}
旧バージョン (< 5.3) との互換性のため、org.activiti.engine.impl.pvm.delegate.ExecutionListener? もあるが、そちらは使わない<process id="executionListenersProcess">
...
<userTask id="firstTask" />
<sequenceFlow sourceRef="firstTask" targetRef="secondTask">
<extensionElements>
<activiti:executionListener class="com.foo.ExecutionListenerTwo" />
</extensionElements>
</sequenceFlow>
...
</process>
<process id="executionListenersProcess">
...
<userTask id="secondTask" >
<extensionElements>
<activiti:executionListener expression="com.foo.ExecutionListenerThree" event="end" />
</extensionElements>
</userTask>
<sequenceFlow sourceRef="secondTask" targetRef="thirdTask" />
...
</process>
<process id="executionListenersProcess">
<extensionElements>
<activiti:executionListener class="com.foo.FieldInjectedExecutionListener" event="start">
<activiti:field name="fixedValue" stringValue="Yes, I am " />
<activiti:field name="dynamicValue" expression="${myVar}" />
</activiti:executionListener>
</extensionElements>
...
</process>
import org.activiti.engine.delegate.ExecutionListener;
import org.activiti.engine.delegate.ExecutionListenerExecution;
import org.activiti.engine.delegate.Expression;
public class FieldInjectedExecutionListener implements ExecutionListener {
private Expression fixedValue;
private Expression dynamicValue;
public void notify(ExecutionListenerExecution execution) throws Exception {
execution.setVariable("var", fixedValue.getValue(execution).toString() + dynamicValue.getValue(execution).toString());
}
}
旧バージョン (< 5.3) との互換性のため、org.activiti.engine.impl.pvm.delegate.Expression もあるが、そちらは使わない@Deployment(resources = {"org/activiti/examples/bpmn/executionListener/ExecutionListenersFieldInjectionProcess.bpmn20.xml"})
public void testExecutionListenerFieldInjection() {
Map<String, Object> variables = new HashMap<String, Object>();
variables.put("myVar", "listening!");
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("executionListenersProcess", variables);
Object varSetByListener = runtimeService.getVariable(processInstance.getId(), "var");
assertNotNull(varSetByListener);
assertTrue(varSetByListener instanceof String);
// Result is a concatenation of fixed injected field and injected expression
assertEquals("Yes, I am listening!", varSetByListener);
}
<process id="executionListenersProcess">
...
<userTask id="myTask" name="My Task" >
<extensionElements>
<activiti:taskListener class="com.foo.MyTaskCreateListener" event="create"/>
</extensionElements>
</userTask>
...
</process>
import org.activiti.engine.delegate.DelegateTask;
import org.activiti.engine.delegate.TaskListener;
public class MyTaskCreateListener implements TaskListener {
public void notify(DelegateTask delegateTask) {
// Custom logic goes here
}
}
<process id="MultiExam" name="Multi Exam" isExecutable="true">
<startEvent id="startevent1" name="Start"></startEvent>
<endEvent id="endevent1" name="End"></endEvent>
<serviceTask id="servicetask1" name="Service Task" activiti:class="com.snail.exam.MyJavaTask">
<multiInstanceLoopCharacteristics isSequential="false">
<loopCardinality>10</loopCardinality>
</multiInstanceLoopCharacteristics>
</serviceTask>
<sequenceFlow id="flow1" sourceRef="startevent1" targetRef="servicetask1"></sequenceFlow>
<sequenceFlow id="flow2" sourceRef="servicetask1" targetRef="endevent1"></sequenceFlow>
</process>
| property | note |
| isSequential | true(並列実行可) / false(逐次実行) |
| loopCardinality | 繰り返し数 (${}でプロセス変数の参照も可能) |
| completionCondition | 終了条件 ${EL式} でプロセス変数を評価する |
package com.snail.exam;
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.RepositoryService;
import org.activiti.engine.RuntimeService;
import org.activiti.engine.runtime.ProcessInstance;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class MultiInstanceProcess {
private static final Logger log = LoggerFactory.getLogger(MyProcess.class);
public static void main(String[] args) {
try {
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
RepositoryService repositoryService = processEngine.getRepositoryService();
repositoryService.createDeployment()
.addClasspathResource("org/activiti/test/MultiInstance.bpmn")
.deploy();
log.info("Deployed");
RuntimeService runtimeService = processEngine.getRuntimeService();
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("MultiExam");
log.info("Complete");
} catch (RuntimeException th) {
log.error("ERROR", th);
}
}
}
package com.snail.exam;
import java.util.Map;
import org.activiti.engine.delegate.DelegateExecution;
import org.activiti.engine.delegate.JavaDelegate;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class MyJavaTask implements JavaDelegate {
private static final Logger log = LoggerFactory.getLogger(MyJavaTask.class);
public void execute(DelegateExecution execution) throws Exception {
log.info("This is MyJavaTask");
for(Map.Entry entry : execution.getVariables().entrySet()) {
log.info("{}={}", entry.getKey(), entry.getValue());
}
}
}
実行結果 (10回実行された)
16-05-18 23:49:36 [INFO ] Initializing process engine using configuration 'file:/Users/atsushi/EclipseWorkspace/ActivitExam/target/classes/activiti.cfg.xml'
16-05-18 23:49:36 [INFO ] initializing process engine for resource file:/Users/atsushi/EclipseWorkspace/ActivitExam/target/classes/activiti.cfg.xml
16-05-18 23:49:36 [INFO ] Loading XML bean definitions from resource loaded through InputStream
16-05-18 23:49:37 [INFO ] performing create on engine with resource org/activiti/db/create/activiti.h2.create.engine.sql
16-05-18 23:49:37 [INFO ] performing create on history with resource org/activiti/db/create/activiti.h2.create.history.sql
16-05-18 23:49:37 [INFO ] performing create on identity with resource org/activiti/db/create/activiti.h2.create.identity.sql
16-05-18 23:49:37 [INFO ] ProcessEngine default created
16-05-18 23:49:37 [INFO ] initialised process engine default
16-05-18 23:49:37 [INFO ] Processing resource org/activiti/test/MultiInstance.bpmn
16-05-18 23:49:37 [INFO ] Deployed
16-05-18 23:49:37 [INFO ] This is MyJavaTask
16-05-18 23:49:37 [INFO ] nrOfActiveInstances=10
16-05-18 23:49:37 [INFO ] loopCounter=0
16-05-18 23:49:37 [INFO ] nrOfInstances=10
16-05-18 23:49:37 [INFO ] nrOfCompletedInstances=0
16-05-18 23:49:38 [INFO ] This is MyJavaTask
16-05-18 23:49:38 [INFO ] nrOfActiveInstances=9
16-05-18 23:49:38 [INFO ] loopCounter=1
16-05-18 23:49:38 [INFO ] nrOfInstances=10
16-05-18 23:49:38 [INFO ] nrOfCompletedInstances=1
16-05-18 23:49:38 [INFO ] This is MyJavaTask
16-05-18 23:49:38 [INFO ] nrOfActiveInstances=8
16-05-18 23:49:38 [INFO ] loopCounter=2
16-05-18 23:49:38 [INFO ] nrOfInstances=10
16-05-18 23:49:38 [INFO ] nrOfCompletedInstances=2
16-05-18 23:49:38 [INFO ] This is MyJavaTask
16-05-18 23:49:38 [INFO ] nrOfActiveInstances=7
16-05-18 23:49:38 [INFO ] loopCounter=3
16-05-18 23:49:38 [INFO ] nrOfInstances=10
16-05-18 23:49:38 [INFO ] nrOfCompletedInstances=3
16-05-18 23:49:38 [INFO ] This is MyJavaTask
16-05-18 23:49:38 [INFO ] nrOfActiveInstances=6
16-05-18 23:49:38 [INFO ] loopCounter=4
16-05-18 23:49:38 [INFO ] nrOfInstances=10
16-05-18 23:49:38 [INFO ] nrOfCompletedInstances=4
16-05-18 23:49:38 [INFO ] This is MyJavaTask
16-05-18 23:49:38 [INFO ] nrOfActiveInstances=5
16-05-18 23:49:38 [INFO ] loopCounter=5
16-05-18 23:49:38 [INFO ] nrOfInstances=10
16-05-18 23:49:38 [INFO ] nrOfCompletedInstances=5
16-05-18 23:49:38 [INFO ] This is MyJavaTask
16-05-18 23:49:38 [INFO ] nrOfActiveInstances=4
16-05-18 23:49:38 [INFO ] loopCounter=6
16-05-18 23:49:38 [INFO ] nrOfInstances=10
16-05-18 23:49:38 [INFO ] nrOfCompletedInstances=6
16-05-18 23:49:38 [INFO ] This is MyJavaTask
16-05-18 23:49:38 [INFO ] nrOfActiveInstances=3
16-05-18 23:49:38 [INFO ] loopCounter=7
16-05-18 23:49:38 [INFO ] nrOfInstances=10
16-05-18 23:49:38 [INFO ] nrOfCompletedInstances=7
16-05-18 23:49:38 [INFO ] This is MyJavaTask
16-05-18 23:49:38 [INFO ] nrOfActiveInstances=2
16-05-18 23:49:38 [INFO ] loopCounter=8
16-05-18 23:49:38 [INFO ] nrOfInstances=10
16-05-18 23:49:38 [INFO ] nrOfCompletedInstances=8
16-05-18 23:49:38 [INFO ] This is MyJavaTask
16-05-18 23:49:38 [INFO ] nrOfActiveInstances=1
16-05-18 23:49:38 [INFO ] loopCounter=9
16-05-18 23:49:38 [INFO ] nrOfInstances=10
16-05-18 23:49:38 [INFO ] nrOfCompletedInstances=9
16-05-18 23:49:38 [INFO ] Complete
<startEvent>
<extensionElements>
<activiti:formProperty id="numberOfDays" name="Number of days"
value="${numberOfDays}" type="long" required="true"/>
<activiti:formProperty id="startDate" name="First day of holiday (dd-MM-yyy)"
value="${startDate}" datePattern="dd-MM-yyyy hh:mm" type="date" required="true" />
<activiti:formProperty id="vacationMotivation" name="Motivation"
value="${vacationMotivation}" type="string" />
</extensionElements>
</userTask>
| property | note |
| id | key項目。入力値は id をキーにしてプロセススコープの変数として保持される ((ACT_RU_VARIABLE テーブルに格納される) |
| name | 表示するラベル |
| type | "string","long","enum","date","boolean" |
| value | 初期値。プロセススコープの変数 (ACT_RU_VARIABLE テーブルに格納されているプロセス固有の変数) を EL式で参照可能 |
| readable | "true"/"false" |
| writable | "true"/"false" |
| required | "true"/"false" |
<userTask id="usertask1" name="User Task">
<extensionElements>
<activiti:formProperty id="sex" name="YOUR SEX" type="enum">
<activiti:value id="male" name="Male" />
<activiti:value id="female" name="Female" />
</activiti:formProperty>
</extensionElements>
</userTask>
GUI は Activiti Explorer 前提なら From の話はここまでで OKStartFormData FormService.getStartFormData(String processDefinitionId) TaskFormdata FormService.getTaskFormData(String taskId)
public interface FormProperty {
FormService#submitStartFormData(String, java.util.Map)}
String getId();
String getName();
FormType getType();
String getValue();
boolean isReadable();
boolean isWritable();
boolean isRequired();
}
package com.snail.exam;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.RepositoryService;
import org.activiti.engine.RuntimeService;
import org.activiti.engine.TaskService;
import org.activiti.engine.form.FormProperty;
import org.activiti.engine.form.StartFormData;
import org.activiti.engine.form.TaskFormData;
import org.activiti.engine.repository.ProcessDefinition;
import org.activiti.engine.runtime.ProcessInstance;
import org.activiti.engine.task.Task;
import org.apache.commons.lang3.time.DateUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class FormProcess {
private static final Logger log = LoggerFactory.getLogger(FormProcess.class);
public static void main(String[] args) {
try {
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
// ----- 4.3.1. Deploying the process
log.info("--- #1. Deploying the process");
RepositoryService repositoryService = processEngine.getRepositoryService();
repositoryService.createDeployment()
.addClasspathResource("org/activiti/test/VacationRequest.bpmn20.xml")
.deploy();
// ----- 9. Forms (Read Start Form)
ProcessDefinition processDef = processEngine.getRepositoryService().createProcessDefinitionQuery()
.processDefinitionKey("vacationRequest").singleResult();
log.info("Vaction Request PID={}", processDef.getId());
StartFormData startForm = processEngine.getFormService().getStartFormData(processDef.getId());
for (FormProperty prop : startForm.getFormProperties()) {
log.info("id={}, name={}, type={}, value={}, readable={}, required={}, writable={}, "
, prop.getId(), prop.getName(), prop.getType(), prop.getValue()
, prop.isReadable(), prop.isRequired(), prop.isWritable());
}
// ----- 4.3.2. Starting a process instance
log.info("--- #3. Starting a process instance");
Map<String, Object> variables = new HashMap<String, Object>();
variables.put("employeeName", "Kermit");
variables.put("numberOfDays", new Integer(4));
variables.put("startDate", DateUtils.parseDate("1999-12-31", "yyyy-MM-dd"));
variables.put("vacationMotivation", "I'm really tired!");
// the process to run
// id : <process id="vacationRequest">
// arguments : <activiti:formProperty>
RuntimeService runtimeService = processEngine.getRuntimeService();
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("vacationRequest", variables);
// Fetch all tasks for the management group
TaskService taskService = processEngine.getTaskService();
List<Task> tasks = taskService.createTaskQuery().processDefinitionKeyLike("vacationRequest%").list();
for (Task task : tasks) {
TaskFormData taskForm = processEngine.getFormService().getTaskFormData(task.getId());
for (FormProperty prop : taskForm.getFormProperties()) {
log.info("id={}, name={}, type={}, value={}, readable={}, required={}, writable={}, "
, prop.getId(), prop.getName(), prop.getType(), prop.getValue()
, prop.isReadable(), prop.isRequired(), prop.isWritable());
}
// Do task (reject application)
Map<String, Object> taskVariables = new HashMap<String, Object>();
taskVariables.put("vacationApproved", "false");
taskVariables.put("managerMotivation", "We have a tight deadline!");
taskService.complete(task.getId(), taskVariables);
}
} catch (Throwable th) {
log.error("ERROR", th);
}
}
}
16-05-19 01:22:08 [INFO ] Initializing process engine using configuration 'file:/Users/atsushi/EclipseWorkspace/ActivitExam/target/classes/activiti.cfg.xml'
16-05-19 01:22:08 [INFO ] initializing process engine for resource file:/Users/atsushi/EclipseWorkspace/ActivitExam/target/classes/activiti.cfg.xml
16-05-19 01:22:08 [INFO ] Loading XML bean definitions from resource loaded through InputStream
16-05-19 01:22:09 [INFO ] performing create on engine with resource org/activiti/db/create/activiti.h2.create.engine.sql
16-05-19 01:22:09 [INFO ] performing create on history with resource org/activiti/db/create/activiti.h2.create.history.sql
16-05-19 01:22:09 [INFO ] performing create on identity with resource org/activiti/db/create/activiti.h2.create.identity.sql
16-05-19 01:22:09 [INFO ] ProcessEngine default created
16-05-19 01:22:09 [INFO ] initialised process engine default
16-05-19 01:22:09 [INFO ] --- #1. Deploying the process
16-05-19 01:22:09 [INFO ] Processing resource org/activiti/test/VacationRequest.bpmn20.xml
16-05-19 01:22:10 [INFO ] Vaction Request PID=vacationRequest:1:4
16-05-19 01:22:10 [INFO ] id=numberOfDays, name=Number of days, type=org.activiti.engine.impl.form.LongFormType@6bb75258,
value=null, readable=true, required=true, writable=true,
16-05-19 01:22:10 [INFO ] id=startDate, name=First day of holiday (dd-MM-yyy), type=org.activiti.engine.impl.form.DateFormType@c260bdc,
value=null, readable=true, required=true, writable=true,
16-05-19 01:22:10 [INFO ] id=vacationMotivation, name=Motivation, type=org.activiti.engine.impl.form.StringFormType@75e01201, value=null,
readable=true, required=false, writable=true,
16-05-19 01:22:10 [INFO ] --- #3. Starting a process instance
16-05-19 01:22:10 [INFO ] id=vacationApproved, name=Do you approve this vacation, type=org.activiti.engine.impl.form.EnumFormType@47dbb1e2,
value=null, readable=true, required=true, writable=true,
16-05-19 01:22:10 [INFO ] id=managerMotivation, name=Motivation, type=org.activiti.engine.impl.form.StringFormType@75e01201,
value=null, readable=true, required=false, writable=true,
<bean id="processEngineConfiguration"
class="org.activiti.engine.impl.cfg.StandaloneInMemProcessEngineConfiguration">
<property name="history" value="audit" />
...
</bean>
| String | getBusinessKey?() | The user provided unique reference to this process instance. |
| String | getDeleteReason?() | Obtains the reason for the process instance's deletion. |
| Long | getDurationInMillis?() | The difference between?getEndTime?()?and?getStartTime?()?. |
| Date | getEndTime?() | The time the process was ended. |
| String | getId() | The process instance id (== as the id for the run21:28:09process instance). |
| String | getName() | The name for the process instance. |
| String | getProcessDefinitionId?() | The process definition reference. |
| Map<String,Object> | getProcessVariables?() | Returns the process variables if requested in the process instance query. ※ なんか何にも入っていない Map が返される。プロセス変数は HistoricVariableInstance? からとればいいだろう |
| String | getStartActivitId?() | The start activit. |
| Date | getStartTime?() | The time the process was started. |
| String | getStartUserId?() | The authenticated user that started this process instance. |
| String | getSuperProcessInstanceId?() | The process instance id of a potential super process instance or null if no super process instance exists. |
| String | getTenantId?() | The tenant identifier for the process instance. |
| Date | getCreateTime?() | Returns the time when the variable was created. |
| String | getId() | The unique DB id |
| Date | getLastUpdatedTime?() | Returns the time when the value of the variable was last updated. |
| String | getProcessInstanceId?() | The process instance reference. |
| String | getTaskId?() | |
| Object | getValue() | |
| String | getVariableName?() | |
| String | getVariableTypeName?() |
| String | getActivityId?() | The unique identifier of the activity in the process |
| String | getActivityName?() | The display name for the activity |
| String | getActivityType?() | The XML tag of the activity as in the process file |
| String | getAssignee() | Assignee in case of user task activity |
| String | getCalledProcessInstanceId?() | The called process instance in case of call activity |
| Long | getDurationInMillis?() | Difference between?getEndTime?()?and?getStartTime?(). |
| Date | getEndTime?() | Time when the activity instance ended |
| String | getExecutionId?() | Execution reference |
| String | getId() | The unique identifier of this historic activity instance. |
| String | getProcessDefinitionId?() | Process definition reference |
| String | getProcessInstanceId?() | Process instance reference |
| Date | getStartTime?() | Time when the activity instance started |
| String | getTaskId?() | The corresponding task in case of task activity |
| String | getTenantId?() | Returns the tenant identifier for the historic activity |
| String | getActivityInstanceId?() | The activity reference in case this detail is related to an activity instance. |
| String | getExecutionId?() | The identifier for the path of execution. |
| String | getId() | The unique DB id for this historic detail |
| String | getProcessInstanceId?() | The process instance reference. |
| String | getTaskId?() | The identifier for the task. |
| Date | getTime() | The time when this detail occurred |
| int | getRevision()? | (Query の検索結果が HistoricVariableUpdate? extends HistoricDetail? 型のとき)the revision of Process variable |
| Object | getValue()? | (Query の検索結果が HistoricVariableUpdate? extends HistoricDetail? 型のとき)Process variable |
| String | getVariableName?()? | (Query の検索結果が HistoricVariableUpdate? extends HistoricDetail? 型のとき) |
| String | getVariableTypeName?()? | (Query の検索結果が HistoricVariableUpdate? extends HistoricDetail? 型のとき) |
| String | getPropertyId?() | (Query の検索結果が HistoricFormProperty? extends HistoricDetail? 型のとき) the id or key of the Form property |
| String | getPropertyValue?() | (Query の検索結果が HistoricFormProperty? extends HistoricDetail? 型のとき)the Formsubmitted value |
| Date | getClaimTime?() | Time when the task was claimed. |
| String | getDeleteReason?() | The reason why this task was deleted {'completed', 'deleted', any other user defined string }. |
| Long | getDurationInMillis?() | Difference between getEndTime?() and getStartTime?() in milliseconds. |
| Date | getEndTime?() | Time when the task was deleted or completed. |
| Date | getStartTime?() | Time when the task started. |
| Long | getWorkTimeInMillis?() | Difference between getEndTime?() and getClaimTime?() in milliseconds. |
package com.snail.exam;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import org.activiti.engine.HistoryService;
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.RepositoryService;
import org.activiti.engine.RuntimeService;
import org.activiti.engine.TaskService;
import org.activiti.engine.history.HistoricActivityInstance;
import org.activiti.engine.history.HistoricDetail;
import org.activiti.engine.history.HistoricFormProperty;
import org.activiti.engine.history.HistoricProcessInstance;
import org.activiti.engine.history.HistoricTaskInstance;
import org.activiti.engine.history.HistoricVariableInstance;
import org.activiti.engine.history.HistoricVariableUpdate;
import org.activiti.engine.repository.ProcessDefinition;
import org.activiti.engine.runtime.ProcessInstance;
import org.activiti.engine.task.Task;
import org.apache.commons.lang3.time.DateUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class HistoryProcess {
private static final Logger log = LoggerFactory.getLogger(HistoryProcess.class);
public static void main(String[] args) {
try {
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
// ----- 4.3.1. Deploying the process
log.info("--- #1. Deploying the process");
RepositoryService repositoryService = processEngine.getRepositoryService();
repositoryService.createDeployment().addClasspathResource("org/activiti/test/VacationRequest.bpmn20.xml")
.deploy();
log.info("Number of process definitions {}", repositoryService.createProcessDefinitionQuery().count());
for (ProcessDefinition p : repositoryService.createProcessDefinitionQuery().list()) {
log.info("PROCESS DEF [id={},name={},key={}]", p.getId(), p.getName(), p.getKey());
}
// ----- 4.3.2. Starting a process instance
log.info("--- #2. Starting a process instance");
Map<String, Object> variables = new HashMap<String, Object>();
variables.put("employeeName", "Kermit");
variables.put("numberOfDays", new Integer(4));
variables.put("startDate", DateUtils.parseDate("1999-12-31", "yyyy-MM-dd"));
variables.put("vacationMotivation", "I'm really tired!");
RuntimeService runtimeService = processEngine.getRuntimeService();
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("vacationRequest", variables);
log.info("Number of process instances: " + runtimeService.createProcessInstanceQuery().count());
for (ProcessInstance p : runtimeService.createProcessInstanceQuery().list()) {
log.info("PROCESS INSTANCE [id={},pid={},pname={},pkey={}]", p.getId(), p.getProcessDefinitionId(),
p.getProcessDefinitionName(), p.getProcessDefinitionKey());
}
log.info("--- #3. Completing tasks (Accept Request)");
// Fetch all tasks for the management group
TaskService taskService = processEngine.getTaskService();
List<Task> tasks = taskService.createTaskQuery().taskCandidateGroup("management")
.processDefinitionKey("vacationRequest").list();
for (Task task : tasks) {
if (task.getTaskDefinitionKey().equals("handleRequest")) {
// Description is <documentation>.
log.info("TASK ACCEPT REQ [{}]", task.getDescription());
// Do task (reject application)
Map<String, Object> taskVariables = new HashMap<String, Object>();
taskVariables.put("vacationApproved", "true");
taskVariables.put("managerMotivation", "Okay, refresh yourself!");
taskService.complete(task.getId(), taskVariables);
}
}
// ----- 11. History
log.info("--- #4. History");
HistoryService historyService = processEngine.getHistoryService();
// 11.1.1. HistoricProcessInstanceQuery
List<HistoricProcessInstance> historicPorcessInstances = historyService.createHistoricProcessInstanceQuery()
.finished().orderByProcessInstanceDuration().desc().listPage(0, 10);
log.info("TERMINATED PROCESS = {}", historicPorcessInstances.size());
historicPorcessInstances.forEach(p -> {
log.info("PROCESS INSTANCE [id={},pid={},name={},variables_size={}]"
, p.getId()
, p.getProcessDefinitionId()
, p.getName()
, p.getProcessVariables().size());
p.getProcessVariables().forEach((k,v) -> {
log.info("{} = {}", k, v);
});
});
// 11.1.2. HistoricVariableInstanceQuery
List<HistoricVariableInstance> historicVariableInstances = historyService.createHistoricVariableInstanceQuery()
.orderByVariableName().asc().list();
log.info("VARIABLE SIZE = {}", historicVariableInstances.size());
historicVariableInstances.forEach(p -> {
log.info("VARIABLE [id={},pid={},task={},type={},name={},value={}]"
, p.getId()
, p.getProcessInstanceId()
, p.getTaskId()
, p.getVariableTypeName()
, p.getVariableName()
, p.getValue());
});
// 11.1.3. HistoricActivityInstanceQuery
List<HistoricActivityInstance> historicActivityInstances =historyService.createHistoricActivityInstanceQuery()
.finished()
.orderByHistoricActivityInstanceEndTime().desc().list();
log.info("ACTIVITY SIZE = {}", historicActivityInstances.size());
historicActivityInstances.forEach(p -> {
log.info("ACTIVITY [id={},name={},task={},asignee={}]"
, p.getActivityId()
, p.getActivityName()
, p.getTaskId()
, p.getAssignee()
);
});
// 11.1.4. HistoricDetailQuery
List<HistoricDetail> historicDetails = historyService.createHistoricDetailQuery().list();
log.info("DETAIL SIZE = {}", historicDetails.size());
historicDetails.forEach(p -> {
if (p instanceof HistoricFormProperty) {
log.info("FORM [pid={},taskid={},property_id={},value={}]"
, p.getProcessInstanceId()
, p.getTaskId()
, ((HistoricFormProperty)p).getPropertyId()
, ((HistoricFormProperty)p).getPropertyValue()
);
} else if (p instanceof HistoricVariableUpdate) {
log.info("VARIABLE [pid={},taskid={},revision={},name={},value={}]"
, p.getProcessInstanceId()
, p.getTaskId()
, ((HistoricVariableUpdate)p).getRevision()
, ((HistoricVariableUpdate)p).getVariableName()
, ((HistoricVariableUpdate)p).getValue()
);
}
});
// 11.1.5. HistoricTaskInstanceQuery
List<HistoricTaskInstance> historicTaskInstances = historyService.createHistoricTaskInstanceQuery()
.finished()
.orderByHistoricTaskInstanceDuration().desc()
.listPage(0, 10);
log.info("TASK SIZE = {}", historicTaskInstances.size());
historicTaskInstances.forEach(p -> {
log.info("TASK [id={},name={},time={},asignee={}]"
, p.getId()
, p.getName()
, p.getCreateTime()
, p.getAssignee()
);
});
} catch (Throwable th) {
log.error("ERROR", th);
}
}
}16-05-23 21:34:18 [INFO ] Initializing process engine using configuration 'file:/Users/atsushi/EclipseWorkspace/ActivitExam/target/classes/activiti.cfg.xml'
16-05-23 21:34:18 [INFO ] initializing process engine for resource file:/Users/atsushi/EclipseWorkspace/ActivitExam/target/classes/activiti.cfg.xml
16-05-23 21:34:18 [INFO ] Loading XML bean definitions from resource loaded through InputStream
16-05-23 21:34:19 [INFO ] performing create on engine with resource org/activiti/db/create/activiti.h2.create.engine.sql
16-05-23 21:34:19 [INFO ] performing create on history with resource org/activiti/db/create/activiti.h2.create.history.sql
16-05-23 21:34:19 [INFO ] performing create on identity with resource org/activiti/db/create/activiti.h2.create.identity.sql
16-05-23 21:34:19 [INFO ] ProcessEngine default created
16-05-23 21:34:19 [INFO ] initialised process engine default
16-05-23 21:34:19 [INFO ] --- #1. Deploying the process
16-05-23 21:34:19 [INFO ] Processing resource org/activiti/test/VacationRequest.bpmn20.xml
16-05-23 21:34:21 [INFO ] Number of process definitions 1
16-05-23 21:34:21 [INFO ] PROCESS DEF [id=vacationRequest:1:4,name=Vacation request,key=vacationRequest]
16-05-23 21:34:21 [INFO ] --- #2. Starting a process instance
16-05-23 21:34:21 [INFO ] Number of process instances: 1
16-05-23 21:34:21 [INFO ] PROCESS INSTANCE [id=5,pid=vacationRequest:1:4,pname=Vacation request,pkey=vacationRequest]
16-05-23 21:34:21 [INFO ] --- #3. Completing tasks (Accept Request)
16-05-23 21:34:21 [INFO ] TASK ACCEPT REQ [Kermit would like to take 4 day(s) of vacation (Motivation: I'm really tired!).]
16-05-23 21:34:21 [INFO ] --- #4. History
16-05-23 21:34:21 [INFO ] TERMINATED PROCESS = 1
16-05-23 21:34:21 [INFO ] PROCESS INSTANCE [id=5,pid=vacationRequest:1:4,name=null,variables_size=0]
16-05-23 21:34:21 [INFO ] VARIABLE SIZE = 6
16-05-23 21:34:21 [INFO ] VARIABLE [id=6,pid=5,task=null,type=string,name=employeeName,value=Kermit]
16-05-23 21:34:21 [INFO ] VARIABLE [id=15,pid=5,task=null,type=string,name=managerMotivation,value=Okay, refresh yourself!]
16-05-23 21:34:21 [INFO ] VARIABLE [id=9,pid=5,task=null,type=integer,name=numberOfDays,value=4]
16-05-23 21:34:21 [INFO ] VARIABLE [id=10,pid=5,task=null,type=date,name=startDate,value=Fri Dec 31 00:00:00 JST 1999]
16-05-23 21:34:21 [INFO ] VARIABLE [id=14,pid=5,task=null,type=string,name=vacationApproved,value=true]
16-05-23 21:34:21 [INFO ] VARIABLE [id=8,pid=5,task=null,type=string,name=vacationMotivation,value=I'm really tired!]
16-05-23 21:34:21 [INFO ] ACTIVITY SIZE = 5
16-05-23 21:34:21 [INFO ] ACTIVITY [id=theEnd1,name=null,task=null,asignee=null]
16-05-23 21:34:21 [INFO ] ACTIVITY [id=sendApprovalMail,name=Send confirmation e-mail,task=null,asignee=null]
16-05-23 21:34:21 [INFO ] ACTIVITY [id=requestApprovedDecision,name=Request approved?,task=null,asignee=null]
16-05-23 21:34:21 [INFO ] ACTIVITY [id=handleRequest,name=Handle vacation request,task=12,asignee=null]
16-05-23 21:34:21 [INFO ] ACTIVITY [id=request,name=null,task=null,asignee=null]
16-05-23 21:34:21 [INFO ] DETAIL SIZE = 0
16-05-23 21:34:21 [INFO ] TASK SIZE = 1
16-05-23 21:34:21 [INFO ] TASK [id=12,name=Handle vacation request,time=Mon May 23 21:34:21 JST 2016,asignee=null]
HistoricProcessInstance? から Variable が取れないとか、謎仕様になっているけどまぁいいか 16-05-23 22:06:05 [INFO ] DETAIL SIZE = 7
16-05-23 22:06:05 [INFO ] VARIABLE [pid=5,taskid=null,revision=0,name=vacationMotivation,value=I'm really tired!]
16-05-23 22:06:05 [INFO ] VARIABLE [pid=5,taskid=null,revision=0,name=numberOfDays,value=4]
16-05-23 22:06:05 [INFO ] VARIABLE [pid=5,taskid=null,revision=0,name=startDate,value=Fri Dec 31 00:00:00 JST 1999]
16-05-23 22:06:05 [INFO ] VARIABLE [pid=5,taskid=null,revision=0,name=vacationApproved,value=true]
16-05-23 22:06:05 [INFO ] VARIABLE [pid=5,taskid=null,revision=0,name=managerMotivation,value=Okay, refresh yourself!]
16-05-23 22:06:05 [INFO ] VARIABLE [pid=5,taskid=null,revision=0,name=employeeName,value=null]
16-05-23 22:06:05 [INFO ] VARIABLE [pid=5,taskid=null,revision=0,name=employeeName,value=Kermit]
プロセス変数周りは、細かい所色々と謎仕様が多いけどまぁいいか。一通りのことはできるし、必要になったら(プロセス監視画面をつくろうとか思い立ったら)もうちょっと細かい所検証する必要あり。まぁその時は REST API 使うだろうけど