nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

As we transition to the new Hyland Community, some post links may be temporarily disrupted as we finalize redirects. We apologize for the inconvenience and are working to resolve this as quickly as possible. Details.

activiti-crystalball getting started

gromar

Hello.

as I promised in the following posts:
http://forums.activiti.org/en/viewtopic.php?f=6&t=6081&start=12
http://forums.activiti.org/en/viewtopic.php?f=6&t=5967&start=14

I created the first getting started for activiti-crystalball.

Topics covered:
- The First Simulation Run.
- Use simulation in design phase.
(BPM development cycle integration, development purposes reports, ….)

e.g. you can get report about your current test coverage:
[img]https://raw.github.com/gro-mar/activiti-crystalball/master/examples/src/test/resources/org/activiti/crystalball/examples/mvn/images/mvn-report-2.png[/img]

Topics not covered yet:
- Use simulation in deploy phase.
- :arrow: Use simulation for monitoring. click on the link. I would say this example will be nice one.
Use simulation for optimization.

Find more posts tagged with

Comments

gromar

After some time I've implemented simulation engine (In fact I took activiti process engine and bent it to the simulation engine). Simulation engine in the activiti-crystalball is able to execute simulation runs asynchronously and in parallel. To see the first example of usage please have a look on MonitoringTest. Test uses similar way to start simulation engine ans simulation instance as it is used for activiti process engine and process instances.

<br>&nbsp; SimulationEngine simulationEngine= SimulationEngineConfigurationImpl.createStandaloneSimulationEngineConfiguration().buildSimulationEngine();<br><br>&nbsp; SimulationInstance simulationInstance = simulationEngine.getRuntimeService().startSimulationInstanceByKey("Monitor escalation", &hellip;..);&nbsp; <br>

Simulation experiment tries to answer question:
What is probability of escalation?
Finally answer is:
[img]https://raw.github.com/gro-mar/activiti-crystalball/master/examples/src/test/resources/org/activiti/crystalball/examples/monitoring/images/monitoringTest.png[/img]

Now I can continue in activiti-crystalball getting started. Crystalball is able to answer probability questions.

Questions:
Does anybody have any real use case where simulation can be applied?
How did the discussion about another simulation framework for activiti
http://forums.activiti.org/content/simulation-process-definition
http://sourceforge.net/p/bpm-accelerator/wiki/Home/

finished?

jbarrez

Which input params did you use to get to the 63%? How do you see users input that data?

Regarding the past discussions: no nothing has come out of that, unfortunately.

gromar

To answer questions I have to describe simulation instance more.

Simulation instance start javadoc:

<br>/**<br> * Starts a new simulation instance <br> * <br> * @param name<br> * @param description<br> * @param author<br> * @param start<br> * @param end<br> * @param replication<br> * @param seed - pseudo random number generator seed.<br> * @param simulationConfigUrl - repository service is not copied form activiti engine - claspath resources are used.<br> * @return<br> */<br>SimulationInstance startSimulationInstanceByKey(String name, String description, String author, Date start, Date end, int replication, Long seed, String simulationConfigUrl);<br>

SimulationInstance configuration has two sources:
1. process definition (e.g. MortageDemo-1-monitoring.bpmn)

<br><serviceTask id="rejection_email" name="Send rejection e-mail" activiti:type="mail" sim:behavior="org.activiti.crystalball.simulator.delegate.Noop"><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <extensionElements><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <activiti:field name="to" expression="to@domain"></activiti:field><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <activiti:field name="from" expression="from@domain"></activiti:field><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <activiti:field name="text"><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <activiti:expression><![CDATA[text]]></activiti:expression><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </activiti:field><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </extensionElements><br>&nbsp;&nbsp;&nbsp; </serviceTask><br>

sim:behavior="org.activiti.crystalball.simulator.delegate.Noop" (behavior can be set for user task too).
2. simulationConfigUrl - describes simulation engine behavior. (e.g. mortages-monitoring-h2-context.xml. Simulation configuration sets up simulation engine and simulation process engine - more description below.

MonitoringTest starts simulation instance with 11 simulation runs. Seed 7L takes care about getting always the same results from pseudo random number generator. RuntimeService.startSimulationInstanceByKey persists new SimulationInstance and its SimulationRuns(similar to ProcessInstance - in fact I took activiti process engine and I bent it to the simulation engine with different entities). Each simulation run is Job which is executed asynchronously in parallel (similar to the Job in the process engine).
Simulation run prepares environment (in this case makes copy of live process engine DB to the DB used by process engine (activiti 5.11) used for simulation. Done by simulationRunHelper in mortages-monitoring-h2-context.xml. Following simulationRunHelper is used in BasicSimulationTest config Simulator-context.xml

<br> <bean id="simulationRunHelper" class="org.activiti.crystalball.simulator.impl.CopySimulationRunHelper"><br>&nbsp; <constructor-arg index ="0" value="${tempDir:target}/basicSimulation.h2.db"/><br>&nbsp; <constructor-arg index ="1" value="${tempDir:target}/${simulationRunId:default}.h2.db"/><br> </bean><br>

SimulationRun starts activiti process engine to simulate process instances execution. Process engine configuration:

<br> <bean id="simProcessEngineConfiguration" class="org.activiti.spring.SpringProcessEngineConfiguration"><br>&nbsp; <property name="dataSource" ref="simDataSource" /><br>&nbsp; <property name="transactionManager" ref="simTransactionManager" /><br>&nbsp; <property name="databaseSchemaUpdate" value="true" /><br>&nbsp; <property name="jobExecutorActivate" value="false" /><br>&nbsp; <property name="jobExecutor" ref="simDefaultJobExecutor"/><br>&nbsp; <property name="preParseListeners"><br>&nbsp;&nbsp; <list><br>&nbsp;&nbsp;&nbsp; <bean class="org.activiti.crystalball.simulator.parse.SimulationBpmnParseListener"/><br>&nbsp;&nbsp; </list><br>&nbsp; </property><br>&nbsp; <property name="processEngineName" value="${simulationRunId:default}"/><br>&nbsp; <property name="deploymentResources"><br>&nbsp;&nbsp; <list><br>&nbsp;&nbsp;&nbsp; <value>org/activiti/crystalball/examples/mortages/MortageDemo-1-monitoring.bpmn</value><br>&nbsp;&nbsp; </list><br>&nbsp; </property><br> </bean><br>&nbsp;&nbsp;&nbsp; <br> <bean id="simDefaultJobExecutor" class="org.activiti.crystalball.simulator.processengine.jobexecutor.SimulationDefaultJobExecutor"><br>&nbsp; <property name="waitTimeInMillis" value="300000"/><br> </bean><br>

Simulation process engine has to use simDefaultJobExecutor which runs process jobs in the virtual simulation time - ability to simulate timers.

Answer:
In MonitoringTest case user behavior is described in mortages-monitoring-h2-context.xml. It is possible to describe it in process definition too sim:behavior=.

<br> <!&ndash;&nbsp; User tasks executors&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &ndash;>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br>&nbsp;&nbsp;&nbsp; <bean id="userTaskExecutor" class="org.activiti.crystalball.simulator.executor.impl.RandomUserMapTaskExecutor"><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <constructor-arg index="0" value="300000"/> <!&ndash; from 5mins to 1100 sec&nbsp; &ndash;><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <constructor-arg index="1" value="1100000"/><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <property name="taskVariablesMap"><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <map><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <!&ndash; TASK preliminary_judgement possibilities &ndash;><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <entry key="preliminary_judgement"><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <list><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <map><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <entry key="approved"><value type="java.lang.Boolean">True</value></entry><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </map><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <map><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <entry key="approved"><value type="java.lang.Boolean">True</value></entry><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </map><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </list><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </entry><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <entry key="final_evaluation"><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <list><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <map><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <entry key="ok"><value type="java.lang.Boolean">True</value></entry><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </map><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <map><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <entry key="ok"><value type="java.lang.Boolean">False</value></entry><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </map><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </list><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </entry><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </map><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </property><br>&nbsp;&nbsp;&nbsp; </bean><br>

RandomUserMapTaskExecutor executes user task in uniform probability distribution from 5mins to 18min 20sec. in case of preliminary_judgement or final_evaluation we can set process variable change. User behavior can be played back from the process engine history too.

When 11 simulation runs are finished and SimulationRun results are stored in the DB, ProbabilityGraphGenerator generates process diagram

<br>&nbsp; ProbabilityGraphGenerator generator = new ProbabilityGraphGenerator();<br>&nbsp; generator.generateGraph(simulationEngine.getRuntimeService(), simulationInstance, "mortagedemo-0:1:4", "mortagedemo-0", "activity_exists", System.getProperty("tempDir", "target") + "/monitoringTest.jpg");<br>

Question:
Do you see any issues in this approach?
I would like to know your opinion.

jbarrez

Looks good. I do like the custom job executor which runs in virtual time, good idea.

One thing I think can be improved: do you mandate the Noop ServiceTask? It would be more useful if you allow to upload any process xml. BUT before you hand them to the simulation engine you swap all the classes with the Noop's (and similar for listeners on execution/task of course).

Another cool thing which every simulation effort must have is of course nice charts 😉

gromar

do you mandate the Noop ServiceTask?

org.activiti.crystalball.simulator.delegate.Noop is not mandatory for service tasks. Usage of simulation behavior depends on the simulation experiment. How realistic simulation experiment should be to reality? Do we want to use real serviceTasks in simulation - we do not need to use Noop. Do we want to play back execution - use org.activiti.crystalball.simulator.delegate.PlaybackCopyActivityBehavior. It really depends on the simulation experiment how far and realistic simulation should look like.

It would be more useful if you allow to upload any process xml. BUT before you hand them to the simulation engine you swap all the classes with the Noop's (and similar for listeners on execution/task of course)

Yes, it would be one possibility and can be used in the real application. On the other hand we can loose possibility to simulate some nodes in the process as real nodes (e.g. we can simulate load on mail server, or service calls).

I have the similar issue as swiderski.maciej in
http://forums.activiti.org/content/simulation-process-definition
http://sourceforge.net/p/bpm-accelerator/wiki/

practical application is missing.

In my opinion simulation can dramatically affect BPM.

You already helped me with the way how to show benefits of simulation.
Could you imagine way how to present contribution of simulation to the BPM solutions development?

jbarrez

I think the general way simulation is 'sold' is through cost analysis.

Meaning: you have process X and process Y. Both of them do the same thing, but they're modeled differently.
Simulation is then the tool you'd use to 'prove' that X is more efficient than Y.

That is why it is important to have charts, to see in a 1-1 fight which process is 'the best' 🙂

gromar

It makes sense.
I will try to prepare cost analysis example.

gromar

I prepared costs analysis example (visit https://github.com/gro-mar/activiti-crystalball/wiki/Getting-started#costs-analysis). Report is not so nice as the previous one, but can be processed further.

I hope that somebody will find it useful.

trademak

Thanks, that's looking already really useful. Looking forward to do some testing with it.

Best regards,

jbarrez

Do you have plans to setup some easy to use demo app? I think that will be crucial to get more people to try it out.

gromar

demo app

You are right jUnit tests are not sufficient. I will try to prepare demo app.

jbarrez

Great! Especially with simulation people just want to see it. looking forward to it. Keep us posted!

gromar

I was thinking about demo app (1 month - mean time I have copied support for variables from process engine to simulation engine 🙂 ).

I started already with demo app.
Please visit:
Getting started
there are several examples (and use cases):
The first simulation run
Use simulation for monitoring.
Costs analysis.

I would appreciate any comment.
Is getting started understandable?

jbarrez

Yes, in my opinion it's getting really understandable and usable!

As I said,if you combine what you have now with a visual demo (with a nice UI, people like nice UI's) it would be cool.
But this is certainly going nice!

b_schnarr

Hi,

this project sounds very cool and more than useful. Is there any progress on a visual demo app?

Best regards
Ben

martin_grofcik

Hi Ben,

There are some news. If you are interested you can propose demo which you would like to see. 🙂

Regards
Martin

bellal

Hi,

I need to integrate crystalball to my own activiti application.

but when i download Crystalball and runing "mvn clean install", this command generate errors.

I have attached the screenshot of errors.

can someone help me to run crystalball?