• Creating Workflows

  • OpenKM has many interesting features, but requires some configuration process to show its full potential.
OpenKM has many interesting features, but requires some configuration process to show its full potential.
Forum rules: Please, before asking something see the documentation wiki or use the search feature of the forum. And remember we don't have a crystal ball or mental readers, so if you post about an issue tell us which OpenKM are you using and also the browser and operating system version. For more info read How to Report Bugs Effectively.
 #45481  by omegagr
 
Hello, I have installed OpenKM community in a server that my university gave me, as my thesis is about open source document management systems and I chose OpenKM as my subject.
Though the installation went well, I have dificculties regarding how to create and upload workflows there.
Should I install the OpenKM Portable Development Environment there, or can I have it in my pc and then copy somehow the .par file onto the server and where exactly?
 #45487  by dferguson
 
I have struggled to get workflows working as well. The documentation is somewhat lacking to be completely inclusive. Workflows are pretty advanced and I have had best success by using the portable development environment. It allows you to connect directly to your OpenKM instance and deploy workflows directly from there. You can also export the par file, but my experience is that it is easier to deploy through the portable dev directly to OpenKM.

As for creating workflows start at lesson 1 and work to the end. If I get impatient and skip an exercise it always creates more confusion.

https://www.openkm.com/wiki/index.php/Workflow_Course

search here for "workflow"

https://www.youtube.com/user/openkm/videos
 #45488  by omegagr
 
Thanks so much for your reply, I am still puzzled whether I should stick to the "server" solution by deploying the portable development environment there too, or should I install everything in my laptop for the research purposes I am interested in and avoid all the trouble. :?:
 #45490  by dferguson
 
I have done both. I have settled on installing the portable dev on a virtual machine separate from the machine which only runs OpenKM. That makes backup and maintenance of OpenKM easier and less messier if I have to rebuild and frees up my portable dev environment for me to experiment and try risky solutions before deploying.

Pointing the portable dev environment to your OpenKM on a separate machine and deploying workflows there is super easy...

In the workflow's *.jpdl.xml there is a Deployment tab. Under the Server Settings just type in the Server Name in IP form (XXX.XXX.XXX.XXX), port (usually 8080), and Server Deployer as "/OpenKM/workflow-register". Works every time for me as long as they are on the same subnet.
 #45737  by omegagr
 
dferguson wrote: Mon Mar 19, 2018 5:57 pm
Pointing the portable dev environment to your OpenKM on a separate machine and deploying workflows there is super easy...

In the workflow's *.jpdl.xml there is a Deployment tab. Under the Server Settings just type in the Server Name in IP form (XXX.XXX.XXX.XXX), port (usually 8080), and Server Deployer as "/OpenKM/workflow-register". Works every time for me as long as they are on the same subnet.
Sorry for being ignorant, but I will tell you what I have done and maybe you can help me.
I have installed the portable dev environment in my laptop and created my first workflow according to this https://www.youtube.com/watch?v=Goaej24S3v8
Now how can I transfer that workflow to the community edition that I have on a server?
I have typed the Server IP and all the other details in the xml as you described.
 #45749  by jllort
 
At the end of the workflow, you will generate a .par file ( when workflow diagram is selected in the top menus you have an option to generate it ). You can register this par file to the application from the Administration > Worfklow.
 #46149  by omegagr
 
Ok I have made it so far in deploying workflows on my server from the openkm-dev.
The problem I face now is that when I make a class in my own projects (even copy paste the code to do the exercises) and add it to the classes and resources field in deployment tab, I get the message "There was a problem creating the process to deploy".
When I remove the class - classes the project is deployed.
Any clues out there?
 #46160  by jllort
 
If you can share with us some log might be we can help you. Also some small video will be welcome for understanding where is the class in your project and how are you adding it.
 #46161  by omegagr
 
Here is the log I got from my server Tomcat 7.0.61>logs regarding the time I made the video to show you the problem:
Code: Select all
2018-06-20 21:30:00,016 [Thread-46309] [] INFO  com.openkm.core.UserMailImporter - *** User mail importer activated ***
2018-06-20 21:30:26,797 [http-apr-0.0.0.0-8080-exec-232] [] INFO  c.o.servlet.WorkflowRegisterServlet - Deploying process archive: dummy.par
2018-06-20 21:30:26,906 [http-apr-0.0.0.0-8080-exec-232] [] INFO  c.o.util.FormUtils$LocalResolver - resolveEntity(publicId=-//OpenKM//DTD Workflow Forms 2.4//EN, systemId=http://www.openkm.com/dtd/workflow-forms-2.4.dtd) => C:\tomcat-7.0.61\webapps\OpenKM\WEB-INF\classes\dtd\workflow-forms-2.4.dtd
2018-06-20 21:30:26,922 [http-apr-0.0.0.0-8080-exec-232] [] INFO  c.o.servlet.WorkflowRegisterServlet - Status: Process formWorkflow deployed successfully
2018-06-20 21:34:48,906 [http-apr-0.0.0.0-8080-exec-205] [] INFO  c.o.servlet.WorkflowRegisterServlet - Deploying process archive: dummy.par
2018-06-20 21:34:49,125 [http-apr-0.0.0.0-8080-exec-205] [] INFO  c.o.util.FormUtils$LocalResolver - resolveEntity(publicId=-//OpenKM//DTD Workflow Forms 2.4//EN, systemId=http://www.openkm.com/dtd/workflow-forms-2.4.dtd) => C:\tomcat-7.0.61\webapps\OpenKM\WEB-INF\classes\dtd\workflow-forms-2.4.dtd
2018-06-20 21:34:49,203 [http-apr-0.0.0.0-8080-exec-205] [] INFO  c.o.servlet.WorkflowRegisterServlet - Status: Process formWorkflow deployed successfully
2018-06-20 21:37:29,516 [http-apr-0.0.0.0-8080-exec-158] [] INFO  c.o.servlet.WorkflowRegisterServlet - Deploying process archive: dummy.par
2018-06-20 21:37:29,797 [http-apr-0.0.0.0-8080-exec-158] [] INFO  c.o.util.FormUtils$LocalResolver - resolveEntity(publicId=-//OpenKM//DTD Workflow Forms 2.4//EN, systemId=http://www.openkm.com/dtd/workflow-forms-2.4.dtd) => C:\tomcat-7.0.61\webapps\OpenKM\WEB-INF\classes\dtd\workflow-forms-2.4.dtd
2018-06-20 21:37:29,812 [http-apr-0.0.0.0-8080-exec-158] [] INFO  c.o.servlet.WorkflowRegisterServlet - Status: Process formWorflow deployed successfully
2018-06-20 21:39:18,453 [http-apr-0.0.0.0-8080-exec-214] [] INFO  com.openkm.spring.LoggerListener - Authentication ERROR: okmAdmin
2018-06-20 21:40:16,984 [http-apr-0.0.0.0-8080-exec-206] [] INFO  c.o.servlet.WorkflowRegisterServlet - Deploying process archive: dummy.par
2018-06-20 21:40:17,187 [http-apr-0.0.0.0-8080-exec-206] [] INFO  c.o.util.FormUtils$LocalResolver - resolveEntity(publicId=-//OpenKM//DTD Workflow Forms 2.4//EN, systemId=http://www.openkm.com/dtd/workflow-forms-2.4.dtd) => C:\tomcat-7.0.61\webapps\OpenKM\WEB-INF\classes\dtd\workflow-forms-2.4.dtd
2018-06-20 21:40:17,234 [http-apr-0.0.0.0-8080-exec-206] [] INFO  c.o.servlet.WorkflowRegisterServlet - Status: Process formWorflow deployed successfully
I really think there is no problem with the deploying to the server, because I cannot even save the process archive (the .par file)
I noticed that the problem is the Decision node, when I remove the Decision Java class from the Deployment tab the process is deployed.
I have made a small video here: https://1drv.ms/v/s!Athg02pkRHfJk3Lj-Uud29EbWFzU where I deploy the wf1 project from the workflow-course and then I try to do it with a identical one from my workflows projects.
The Java built path of my folder is set to openkm-6.3-community just like the workflow-course.
Thanks in advance.
 #46175  by jllort
 
In the eclipse console is not shown any error. Basically if you remove Decision1.java class then it works, but if you add this one it fails. Seems there are not compilation errors. Sometimes eclipse goes crazy ( I suggest remove decision node and add again to be sure nothing hidden wrong is there )

Try to show the eclipse "Error log" tab might be there will show you more information.

About Us

OpenKM is part of the management software. A management software is a program that facilitates the accomplishment of administrative tasks. OpenKM is a document management system that allows you to manage business content and workflow in a more efficient way. Document managers guarantee data protection by establishing information security for business content.