Author: jbarrez
Date: 2009-12-20 16:27:27 -0500 (Sun, 20 Dec 2009)
New Revision: 6002
Modified:
jbpm4/trunk/modules/devguide/src/main/docbook/en/modules/ch03-Bpmn2.xml
Log:
Added some doc for the BPMN 2.0 root element
Modified: jbpm4/trunk/modules/devguide/src/main/docbook/en/modules/ch03-Bpmn2.xml
===================================================================
--- jbpm4/trunk/modules/devguide/src/main/docbook/en/modules/ch03-Bpmn2.xml 2009-12-20
12:44:20 UTC (rev 6001)
+++ jbpm4/trunk/modules/devguide/src/main/docbook/en/modules/ch03-Bpmn2.xml 2009-12-20
21:27:27 UTC (rev 6002)
@@ -221,6 +221,36 @@
</para>
</section>
+
+ <section id="definitionsAndProcess">
+
+ <title>Process root element</title>
+
+ <para>
+ The root of an BPMN 2.0 XML process is the <emphasis
role="bold">definitions</emphasis>
+ elements. As the name states, the subelements will contain the actual definitions
of
+ the business process(es). Every <emphasis
role="bold">process</emphasis> child
+ will be able to have an <emphasis role="bold">id</emphasis>
+ <emphasis role="bold">name</emphasis>. An empty business
process in BPMN 2.0
+ looks as follows. Also note that it is handy to have the BPMN2.xsd on the
classpath, to
+ enable XML completion.
+ <programlisting>
+<definitions id="myProcesses"
+
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+
xsi:schemaLocation="http://schema.omg.org/spec/BPMN/2.0 BPMN20.xsd"
+
xmlns="http://schema.omg.org/spec/BPMN/2.0"
+
typeLanguage="http://www.w3.org/2001/XMLSchema"
+
expressionLanguage="http://www.w3.org/1999/XPath"
+
targetNamespace="http://jbpm.org/example/bpmn2">
+
+ <process id="myBusinessProcess" name="My business
processs">
+ </programlisting>
+ If an id is defined for a process element, it will be used as business key for
that
+ process (ie. starting a process can be done by calling
executionService.startProcessInstanceByKey("myBusinessProcess"),
+ otherwise the jBPM engine will create a unique process key (same mechanism as for
JPDL).
+ </para>
+
+ </section>
<section id="basicConstructs">