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.

How to extend Modeler?

m2spring

I want to add my own task type to the Modeler palette.
Is there a good example I can follow?
I was told Modeler accepts the same extensions as Designer, but I'm unclear how to get started on this.
Thanks!
-Max

Find more posts tagged with

Comments

jbarrez

Afaik, the modeler uses 'stencilsets' and it should be easy to add new stuff to. At least that is what Tijs sold us 😉

I'll ping him to answer.

trademak

Hi,

With the stencilset.json file you can create every element and attribute group you want, so in that sense it has all capabilities.
You would need some coding for translating the Modeler JSON of a new element to a Java class and then to BPMN XML (and vice versa if you need that).
I'll see if I can put together a tutorial for that.

Best regards,

m2spring

Hi Tijs,

yes, if you could provide a little example that would be great.

Will this work incrementally, i.e. can I just add another webapp, or do I need to modify the existing webapp?

Thanks!
-Max

trademak

Hi Max,

You can add another webapp and use the activiti-modeler module, that should work.

Best regards,

m2spring

Hi Tijs,

I make some progress in extending the Modeler.

So far I have basically "hacked" my extension into the activiti-webapp-explorer2 module by copying&modifying the script task definitions.
That gives me something in the Modeler editor.
I'm still unclear how I would do this by giving another webapp, but that's a minor problem at the moment.

I'm now trying to do a similar "hack" in the activiti-bpmn-converter and activiti-bpmn-model modules, by copying&modifying what's there for script task.
It doesn't feel right, though, because with Designer my extension ended up as a serviceTask.
So I guess I should also get a serviceTask with a Modeler extension, right?

Can you please give me some word of advice here?

Thanks!
-Max

trademak

Hi,

If you change the activiti-json-converter and the stencilset.json you can create every BPMN element you want for your custom palette element.
So if you want to have a service task then you can transform your custom element to a service task in the activiti-json-converter.

Best regards,

m2spring

I made some progress.
I added a JenkinsTaskJsonConverter which populates a ServiceTask object.

There's a strange problem when I try to deploy this workflow, though.
[img]http://dl.dropbox.com/u/1917727/20130125-131922.png[/img]

(I'm using the user task's SVG for the time being, until I have figured out the proper "art work".)

<br><?xml version="1.0" encoding="UTF-8"?><br><definitions xmlns="<a href="http://www.omg.org/spec/BPMN/20100524/MODEL" rel="nofollow noopener noreferrer">http://www.omg.org/spec/BPMN/20100524/MODEL</a>" xmlns:xsi="<a href="http://www.w3.org/2001/XMLSchema-instance" rel="nofollow noopener noreferrer">http://www.w3.org/2001/XMLSchema-instance</a>" xmlns:activiti="<a href="http://activiti.org/bpmn" rel="nofollow noopener noreferrer">http://activiti.org/bpmn</a>" xmlns:bpmndi="<a href="http://www.omg.org/spec/BPMN/20100524/DI" rel="nofollow noopener noreferrer">http://www.omg.org/spec/BPMN/20100524/DI</a>" xmlns:smileysurprised:mgdc="<a href="http://www.omg.org/spec/DD/20100524/DC" rel="nofollow noopener noreferrer">http://www.omg.org/spec/DD/20100524/DC</a>" xmlns:smileysurprised:mgdi="<a href="http://www.omg.org/spec/DD/20100524/DI" rel="nofollow noopener noreferrer">http://www.omg.org/spec/DD/20100524/DI</a>" typeLanguage="<a href="http://www.w3.org/2001/XMLSchema" rel="nofollow noopener noreferrer">http://www.w3.org/2001/XMLSchema</a>" expressionLanguage="<a href="http://www.w3.org/1999/XPath" rel="nofollow noopener noreferrer">http://www.w3.org/1999/XPath</a>" targetNamespace="<a href="http://www.activiti.org/test" rel="nofollow noopener noreferrer">http://www.activiti.org/test</a>"><br>&nbsp; <process id="process" name="process1" isExecutable="true"><br>&nbsp;&nbsp;&nbsp; <startEvent id="sid-2BB933AE-E0AE-48D2-9ACC-B5EC35AD3687"></startEvent><br>&nbsp;&nbsp;&nbsp; <sequenceFlow id="sid-974EF4BD-0E76-4983-B84D-FA92053B98DC" sourceRef="sid-2BB933AE-E0AE-48D2-9ACC-B5EC35AD3687" targetRef="jtID"></sequenceFlow><br>&nbsp;&nbsp;&nbsp; <endEvent id="sid-65043A85-6BAD-4616-AD1E-FF3FA8D64D4B"></endEvent><br>&nbsp;&nbsp;&nbsp; <serviceTask id="jtID" name="jenkins task" activiti:exclusive="false" activiti:class="com.cisco.step.jenkins.plugins.jenkow.JenkinsTaskDelegate"><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <documentation>docs</documentation><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <extensionElements><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <activiti:field name="jobName" stringValue="launchee"></activiti:field><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <activiti:field name="isManualJobLaunchMode" stringValue="true"></activiti:field><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </extensionElements><br>&nbsp;&nbsp;&nbsp; </serviceTask><br>&nbsp;&nbsp;&nbsp; <sequenceFlow id="sid-BDAE7F44-F378-4981-8857-6ADA7C191757" sourceRef="jtID" targetRef="sid-65043A85-6BAD-4616-AD1E-FF3FA8D64D4B"></sequenceFlow><br>&nbsp; </process><br>&nbsp; <bpmndi:BPMNDiagram id="BPMNDiagram_process"><br>&nbsp;&nbsp;&nbsp; <bpmndi:BPMNPlane bpmnElement="process" id="BPMNPlane_process"><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <bpmndi:BPMNShape bpmnElement="sid-2BB933AE-E0AE-48D2-9ACC-B5EC35AD3687" id="BPMNShape_sid-2BB933AE-E0AE-48D2-9ACC-B5EC35AD3687"><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <omgdc:Bounds height="30.0" width="30.0" x="139.5" y="130.0"></omgdc:Bounds><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </bpmndi:BPMNShape><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <bpmndi:BPMNShape bpmnElement="jtID" id="BPMNShape_jtID"><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <omgdc:Bounds height="80.0" width="100.0" x="240.0" y="105.0"></omgdc:Bounds><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </bpmndi:BPMNShape><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <bpmndi:BPMNShape bpmnElement="sid-65043A85-6BAD-4616-AD1E-FF3FA8D64D4B" id="BPMNShape_sid-65043A85-6BAD-4616-AD1E-FF3FA8D64D4B"><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <omgdc:Bounds height="28.0" width="28.0" x="390.0" y="131.0"></omgdc:Bounds><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </bpmndi:BPMNShape><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <bpmndi:BPMNEdge bpmnElement="sid-974EF4BD-0E76-4983-B84D-FA92053B98DC" id="BPMNEdge_sid-974EF4BD-0E76-4983-B84D-FA92053B98DC"><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <omgdi:waypoint x="169.5" y="145.0"></omgdi:waypoint><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </bpmndi:BPMNEdge><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <bpmndi:BPMNEdge bpmnElement="sid-BDAE7F44-F378-4981-8857-6ADA7C191757" id="BPMNEdge_sid-BDAE7F44-F378-4981-8857-6ADA7C191757"><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <omgdi:waypoint x="390.0" y="145.0"></omgdi:waypoint><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </bpmndi:BPMNEdge><br>&nbsp;&nbsp;&nbsp; </bpmndi:BPMNPlane><br>&nbsp; </bpmndi:BPMNDiagram><br></definitions><br>

It gives this exception:

<br>SEVERE: Error while closing command context<br>org.activiti.engine.ActivitiException: cvc-complex-type.2.4.b: The content of element 'bpmndi:BPMNEdge' is not complete. One of '{"<a href="http://www.omg.org/spec/DD/20100524/DI%22:waypoint" rel="nofollow noopener noreferrer">http://www.omg.org/spec/DD/20100524/DI':waypoint</a>}' is expected. | Demo model.bpmn20.xml | line 29 | column 25<br>cvc-complex-type.2.4.b: The content of element 'bpmndi:BPMNEdge' is not complete. One of '{"<a href="http://www.omg.org/spec/DD/20100524/DI%22:waypoint" rel="nofollow noopener noreferrer">http://www.omg.org/spec/DD/20100524/DI':waypoint</a>}' is expected. | Demo model.bpmn20.xml | line 32 | column 25<br>Minimum 2 waypoint elements must be definted for a 'BPMNEdge' | Demo model.bpmn20.xml | line 27 | column 134<br>Minimum 2 waypoint elements must be definted for a 'BPMNEdge' | Demo model.bpmn20.xml | line 30 | column 134<br><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.activiti.engine.impl.util.xml.Parse.throwActivitiExceptionForErrors(Parse.java:186)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.activiti.engine.impl.bpmn.parser.BpmnParse.execute(BpmnParse.java:242)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.activiti.engine.impl.bpmn.deployer.BpmnDeployer.deploy(BpmnDeployer.java:92)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.activiti.engine.impl.persistence.deploy.DeploymentCache.deploy(DeploymentCache.java:38)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.activiti.engine.impl.persistence.entity.DeploymentManager.insertDeployment(DeploymentManager.java:44)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.activiti.engine.impl.cmd.DeployCmd.execute(DeployCmd.java:61)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.activiti.engine.impl.cmd.DeployCmd.execute(DeployCmd.java:33)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.activiti.engine.impl.interceptor.CommandExecutorImpl.execute(CommandExecutorImpl.java:24)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.activiti.engine.impl.interceptor.CommandContextInterceptor.execute(CommandContextInterceptor.java:60)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.activiti.spring.SpringTransactionInterceptor$1.doInTransaction(SpringTransactionInterceptor.java:42)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.springframework.transaction.support.TransactionTemplate.execute(TransactionTemplate.java:130)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.activiti.spring.SpringTransactionInterceptor.execute(SpringTransactionInterceptor.java:40)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.activiti.engine.impl.interceptor.LogInterceptor.execute(LogInterceptor.java:32)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.activiti.engine.impl.RepositoryServiceImpl.deploy(RepositoryServiceImpl.java:68)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.activiti.engine.impl.repository.DeploymentBuilderImpl.deploy(DeploymentBuilderImpl.java:119)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.activiti.editor.ui.EditorProcessDefinitionDetailPanel.deployModel(EditorProcessDefinitionDetailPanel.java:256)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.activiti.editor.ui.EditorProcessDefinitionDetailPanel$1.valueChange(EditorProcessDefinitionDetailPanel.java:153)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at java.lang.reflect.Method.invoke(Method.java:597)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at com.vaadin.event.ListenerMethod.receiveEvent(ListenerMethod.java:490)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at com.vaadin.event.EventRouter.fireEvent(EventRouter.java:164)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at com.vaadin.ui.AbstractComponent.fireEvent(AbstractComponent.java:1193)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at com.vaadin.ui.AbstractField.fireValueChange(AbstractField.java:891)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at com.vaadin.ui.AbstractField.setValue(AbstractField.java:529)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at com.vaadin.ui.AbstractSelect.setValue(AbstractSelect.java:666)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at com.vaadin.ui.Select.changeVariables(Select.java:658)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at com.vaadin.terminal.gwt.server.AbstractCommunicationManager.handleVariableBurst(AbstractCommunicationManager.java:1299)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at com.vaadin.terminal.gwt.server.AbstractCommunicationManager.handleVariables(AbstractCommunicationManager.java:1219)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at com.vaadin.terminal.gwt.server.AbstractCommunicationManager.doHandleUidlRequest(AbstractCommunicationManager.java:735)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at com.vaadin.terminal.gwt.server.CommunicationManager.handleUidlRequest(CommunicationManager.java:296)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at com.vaadin.terminal.gwt.server.AbstractApplicationServlet.service(AbstractApplicationServlet.java:501)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at javax.servlet.http.HttpServlet.service(HttpServlet.java:820)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.mortbay.jetty.servlet.ServletHolder.handle(ServletHolder.java:511)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.mortbay.jetty.servlet.ServletHandler.handle(ServletHandler.java:390)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.mortbay.jetty.security.SecurityHandler.handle(SecurityHandler.java:216)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.mortbay.jetty.servlet.SessionHandler.handle(SessionHandler.java:182)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.mortbay.jetty.handler.ContextHandler.handle(ContextHandler.java:765)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.mortbay.jetty.webapp.WebAppContext.handle(WebAppContext.java:418)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.mortbay.jetty.handler.ContextHandlerCollection.handle(ContextHandlerCollection.java:230)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.mortbay.jetty.handler.HandlerCollection.handle(HandlerCollection.java:114)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.mortbay.jetty.handler.HandlerWrapper.handle(HandlerWrapper.java:152)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.mortbay.jetty.Server.handle(Server.java:326)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.mortbay.jetty.HttpConnection.handleRequest(HttpConnection.java:542)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.mortbay.jetty.HttpConnection$RequestHandler.content(HttpConnection.java:943)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.mortbay.jetty.HttpParser.parseNext(HttpParser.java:756)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.mortbay.jetty.HttpParser.parseAvailable(HttpParser.java:218)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.mortbay.jetty.HttpConnection.handle(HttpConnection.java:404)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.mortbay.io.nio.SelectChannelEndPoint.run(SelectChannelEndPoint.java:410)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; at org.mortbay.thread.QueuedThreadPool$PoolThread.run(QueuedThreadPool.java:582)<br>

What could be the cause?

-Max

trademak

Hi Max,

Are you using the current Github master version of the Modeler?
Can you sent me your source code so I can give it a try?

Best regards,

m2spring

Hi Tijs,
I forked Activiti on Github and put my changes on a new branch "jenkow-0.3.0" from off branch "activiti-511":
https://github.com/m2spring/Activiti/commits/jenkow-0.3.0
Regards,
-Max

m2spring

Hi Tijs,
Another data point: When I create the edge with an additional waypoint, I am able to deploy.
[img]http://dl.dropbox.com/u/1917727/20130201-102532.png[/img]
Here, the corresponding BPMNEdge elements have two waypoints.
They should have three, of course.
For some reason, the waypoint at the Jenkins task box is missing.
I haven't figured out what my code is missing.
Maybe you have a word of advice?
-Max

m2spring

Finally figured out this problem myself.

I missed this in BpmnJsonConverter:
DI_RECTANGLES.add(STENCIL_TASK_JENKINS);

I recommend to have some default logic, which applies when a stencil is none of these shapes.
This would avoid the problem I had.

-Max

trademak

Hi Max,

Good to read that it's working now.
As I said earlier, the support for adding custom elements is not yet there.
Maybe you could write a blog post about this? Then we'll add it to the Activiti article list.

Best regards,

m2spring

Can I add it to the Wiki?
http://docs.codehaus.org/display/ACT/Home
-Max

trademak

Hi Max,

Yes adding it to the Wiki would be great.
Let me know if you don't have permission to do this.

Best regards,

m2spring

Hi Tijs,
yes, I would need the necessary permissions to edit the Wiki.
Can you please configure this?
I'm signed-up also as "m2spring" at Codehaus & Wiki.
Thanks!
-Max

trademak

Hi Max,

I added you to the list of developers and I'm expecting this also gives you confluence permissions.
Let me know if it works for you.

Best regards,

m2spring

Hi Tijs,

thanks for giving me access to the Wiki.
I added this page:
http://docs.codehaus.org/display/ACT/Extending+Modeler+with+new+task+type

Regards,
-Max

jbarrez

Thanks for writing that down, Max!

m2spring

Hi Tijs,

I just added support for the process import feature to handle my Jenkins task.
https://github.com/m2spring/Activiti/commit/317383d963eb94df89f439258c600b6a9a8104c1
I'd appreciate your feedback on this.

It's clear that because I map Jenkins task onto Service task, the mapping back is more ugly, having to inspect the delegate class name.

How would you approach a general-purpose extension mechanism which could handle this too?

Regards,
-Max

trademak

Hi Max,

Right. For the Designer we had the same issue so we introduced a (more elegant) identifier attribute for that.
You can use activiti:extensionId on a serviceTask element to identify your Jenkins task.

Best regards,

rohitsingh

Hi

Is there a tutorial which I can follow to create a custom task? I have added a new task in stencilset.json and need to figure out steps to follow further to make this work. I don't need to use ActivitiDesigner for this. Is there an example I can follow? Trying to figure this out since a couple of days without any luck