topic Re: External process definition version in Alfresco Archive

External process definition version

mmaker1234 — Fri, 15 Jun 2012 16:12:47 GMT

Hello,We need to track the execution of process instances and often we need to relate the track to the process definition. As we have no access to the Activiti (production) DB we need to relate these tracks (execution history) to the source file of the process definition. Unfortunately one and the s

Re: External process definition version

frederikherema1 — Mon, 18 Jun 2012 08:28:59 GMT

About ACT-1020, see comment + current workaround. Seems to me that bending the "description" to store your process-versioning is a valid solution. Another thing that is available is the "category" of the process-definition, this is also exposed in the API.

You could leverage that, set the value in the BPMN using the targetNameSpace attribute on root element:


<?xml version="1.0" encoding="UTF-8"?>
<definitions id="definition" 
  xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:activiti="http://activiti.org/bpmn"
  targetNamespace="myProcDef/v3">

Re: External process definition version

mmaker1234 — Mon, 18 Jun 2012 11:58:13 GMT

Hello Frederik,

Thank you for your answer - I will try the workaround.

I'm afraid that targetNamespace is not appropriate because our version contains spaces (I suppose you could recognize the following "version": $Revision: 1.4 $ 🙂 ) That is why we are still interested in a dedicated field/tag in the .BPMN file for such a piece of information.

Re: External process definition version

mmaker1234 — Mon, 18 Jun 2012 13:06:36 GMT

Hello again,

Probably I'm doing something wrong or there's a bug in Activiti.

Here is (part of) my process definition:

<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:activiti="http://activiti.org/bpmn" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:smileysurprised:mgdc="http://www.omg.org/spec/DD/20100524/DC" xmlns:smileysurprised:mgdi="http://www.omg.org/spec/DD/20100524/DI" typeLanguage="http://www.w3.org/2001/XMLSchema" expressionLanguage="http://www.w3.org/1999/XPath" targetNamespace="RunReportRequests">
  <process id="RunReportRequests_ImmediateExecution" name="RunReportRequests_ImmediateExecution">
    <documentation>$Revision: 1.4 $</documentation>
    <startEvent id="startevent1" name="Start"></startEvent>
…

I'm trying to retrieve the process definition (and its "external" version):


      ProcessEngine processEngine = WfEngineManager.getProcessEngineConnection("MyWFengine);
      HistoricProcessInstance processInfo = processEngine.getHistoryService().createHistoricDetailQuery().processInstanceId( processInstanceId ).singleResult();
      ReadOnlyProcessDefinition processDefinition = (ReadOnlyProcessDefinition ) processEngine.getRepositoryService().createProcessDefinitionQuery().processDefinitionId( processInfo.getProcessDefinitionId() ).singleResult();
      LOG.info( "ProcessDefinition ID = " + processDefinition.getId() + "; Name = " + processDefinition.getName() + "; Description (version) = " + "; Description (version) = " );

And the result is
ProcessDefinition ID = RunReportRequests_ImmediateExecution:16:12604; Name = RunReportRequests_ImmediateExecution; Description (version) = null
instead of
ProcessDefinition ID = RunReportRequests_ImmediateExecution:16:12604; Name = RunReportRequests_ImmediateExecution; Description (version) = $Revision: 1.4 $

What I'm doing wrong?

Re: External process definition version

frederikherema1 — Mon, 18 Jun 2012 13:15:24 GMT

Try debugging your code and see what "properties" are present in the ReadonlyProcessDefinition you obtain (contains a map with all parsed properties). Check what the value for key "documentation" is… Sometimes it helps actually looking into our source code, than you see how the documentation is parsed and ends up in the ProcessDefinition.

Re: External process definition version

mmaker1234 — Tue, 19 Jun 2012 05:45:19 GMT

Debugging my application together with Activiti, I reached the point
org.activiti.engine.impl.db.DbSqlSession.selectList(String statement, Object parameter, Page page)
where the call to
loadedObjects = sqlSession.selectList(statement, parameter); //Call to org.apache.ibatis.session.SqlSessionreturned my process definition with null properties collection, which explains why the "documentation" property is also null.

Any advice how to make Activiti to load the process definition properties?

Re: External process definition version

frederikherema1 — Fri, 22 Jun 2012 11:14:26 GMT

Did you get the ReadonlyProcessDefinition using RepositoryServiceIMPL.getDeployedProcessDefinition()? the properties are NOT in the DB, but are parsed. So by looking at your previous post (and the selectList) I presume you're just using the ProcessDefinitionQuery…

Re: External process definition version

mmaker1234 — Fri, 22 Jun 2012 12:39:26 GMT

Hello Frederik,

Thank you for the feedback!

The replacement of

      ReadOnlyProcessDefinition processDefinition = (ReadOnlyProcessDefinition ) processEngine.getRepositoryService().createProcessDefinitionQuery().processDefinitionId( processInfo.getProcessDefinitionId() ).singleResult();

with

      ReadOnlyProcessDefinition processDefinition = ((RepositoryServiceImpl)repositoryService).getDeployedProcessDefinition( processInfo.getProcessDefinitionId() );

did the work! 🙂