Bug 779522 (SOA-1904)

Summary: Document how a user can create a plain JBPM web app
Product: [JBoss] JBoss Enterprise SOA Platform 5 Reporter: trev <tkirby>
Component: DocumentationAssignee: David Le Sage <dlesage>
Status: CLOSED NEXTRELEASE QA Contact:
Severity: high Docs Contact:
Priority: high    
Version: 5.0.0 ER7CC: erics
Target Milestone: ---   
Target Release: FUTURE   
Hardware: Unspecified   
OS: Unspecified   
URL: http://jira.jboss.org/jira/browse/SOA-1904
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-07-14 05:26:34 UTC Type: Task
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Attachments:
Description Flags
jBPMProject.war none

Description trev 2010-01-29 15:40:44 UTC
Affects: Documentation (Ref Guide, User Guide, etc.)
Complexity: High
Date of First Response: 2010-01-30 00:42:15
project_key: SOA

create a document on how to use jbpm-jpdl and jbpm.esb for jBPM Standalone users.

Comment 1 Tom Baeyens 2010-01-29 15:47:45 UTC
Link: Added: This issue is related to JBPM-2652


Comment 2 Aaron Pestel 2010-01-30 05:42:15 UTC
This is an example of a very simple WAR for standalone jBPM.  It has a single JSP, and XML file for a default process definition, and a web.xml.

Drop it in the SOA-P deploy directory (tested on SOA-P 5.0 ER7) and access this URL:  http://localhost:8080/jBPMProject

If you already have processes deployed, you will see them.  If not, use the gui to deploy a default process definition, signal the process through various steps of the process, watch as tasks get assigned to users Aaron and Bob, submit tasks (including adding variables).

The "move" button is there in case you're working with a "real" process that you don't want to actually signal since it's expecting certain data to have been set that was not set.  In this case, it will just move the process to the next node.

Comment 3 Aaron Pestel 2010-01-30 05:42:15 UTC
Attachment: Added: jBPMProject.war


Comment 4 Aaron Pestel 2010-01-30 05:54:38 UTC
Comment above is referring to the attached jBPMProject.war file.

Comment 5 Tom Baeyens 2010-02-01 07:55:31 UTC
Thanks, Aaron!

Comment 6 Tom Baeyens 2010-02-01 16:07:29 UTC
added jbpm3.docs.updates.odt that contain a first iteration of how the docs should be updated.

Comment 7 Tom Baeyens 2010-02-01 16:07:29 UTC
Attachment: Added: jbpm3.docs.updates.odt


Comment 8 Tom Baeyens 2010-02-01 16:20:04 UTC
one thing still needs to be investigated: whether users should call the jbpmContext.setRollbaclOnly or not.  I believe that if TX are managed by ejb or something else, then it is sufficient to just throw a runtime exception into the managed environment.  If they are using the jbpm operation from e.g. a webapp outside a JTA transaction scope, then I think it could be possible that users have to call the jbpmContext.setRollbackOnly themselves.  that needs to be investigated and cleared out in the docs.

Comment 9 Tom Baeyens 2010-02-02 10:42:09 UTC
The documentation update are spun off into following separate issues: SOA-1907, SOA-1908 and SOA-1910

Comment 10 Tom Baeyens 2010-02-02 10:42:42 UTC
Attachment: Removed: jbpm3.docs.updates.odt 


Comment 11 Tom Baeyens 2010-02-02 10:47:54 UTC
as for this issue: it should be documented that plain web app deployments don't have to do anything.  they don't have to include libraries, nor jbpm configuration files.  they just can use the jBPM straight into a standalone web app that is deployed on the soa-platform.  As demonstrated by Aaron's attached war file.

Comment 13 Dana Mison 2010-03-03 04:20:47 UTC
For SOA 5.0 Platform documentation should the process deployment be separated from the WAR and be dealt with in two steps; 1 - build and deploy the process using JBDS, and build and deploy the WAR using JBDS ?

Comment 14 Dana Mison 2010-03-16 04:27:00 UTC
I need some idea of what is happening with this JIRA so I can schedule docs work for 5.0.1 

What volume of material? e.g. how many pages, diagrams, etc 

When will draft material be ready ?

Comment 16 Anne-Louise Tangring 2010-09-21 19:36:01 UTC
Candidate for SOA 5.1.0
Alejandro, please provide input for docs. Kevin is willing to help if needed. Turn over to Darrin Mison, when you have the information.

Comment 17 Alejandro Guizar 2010-09-22 09:37:27 UTC
I'll work on this in the next few days.

Comment 18 Alejandro Guizar 2010-10-27 19:20:13 UTC
Here is the first draft of the document. Darrin, would you please take a look at it?
http://community.jboss.org/wiki/jBPM3WebApponSOA-P

In addition to the document, it would be great to have a unit-testable sample application that illustrated the concepts. What do you think?

Comment 19 Anne-Louise Tangring 2010-12-02 16:31:52 UTC
This is a nice to have for SOA 5.1.0. Not a blocker.

Comment 20 Dana Mison 2010-12-17 03:33:41 UTC
Labels: Added: Getting_Started_Guide
Complexity: Added: High
Affects: Added: [Documentation (Ref Guide, User Guide, etc.)]


Comment 21 Dana Mison 2010-12-21 00:09:56 UTC
wikipage has been moved by the looks of it http://community.jboss.org/wiki/jBPM3DeployWebApptoSOA-P



Comment 22 Dana Mison 2010-12-21 00:11:05 UTC
I'm going to move this one back a release (5.2 perhaps) since much of the remaining time will be taken up with EDS

Comment 23 David Le Sage 2011-07-14 05:25:24 UTC
Release Notes Docs Status: Added: Not Required
Writer: Added: dlesage


Comment 24 David Le Sage 2011-07-14 05:25:59 UTC
Labels: Removed: Getting_Started_Guide 


Comment 25 David Le Sage 2011-07-14 05:26:34 UTC
Thanks for drafting the content, Alejandro.  I have added this to the Services Guide for 5.2.