[jbpm-commits] JBoss JBPM SVN: r6002 - jbpm4/trunk/modules/devguide/src/main/docbook/en/modules.

[do-not-reply at jboss.org]

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>
+&lt;definitions id=&quot;myProcesses&quot;
+  xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot;
+  xsi:schemaLocation=&quot;http://schema.omg.org/spec/BPMN/2.0 BPMN20.xsd&quot;
+  xmlns=&quot;http://schema.omg.org/spec/BPMN/2.0&quot; 
+  typeLanguage=&quot;http://www.w3.org/2001/XMLSchema&quot;
+  expressionLanguage=&quot;http://www.w3.org/1999/XPath&quot; 
+  targetNamespace=&quot;http://jbpm.org/example/bpmn2&quot;&gt;
+
+  &lt;process id=&quot;myBusinessProcess&quot; name=&quot;My business processs&quot;&gt;      
+      </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">