From 4b72e15dbca9144fe7c1853586903cd25051f5a2 Mon Sep 17 00:00:00 2001
From: meyerd <meyerd@51b7ce9a-3489-0410-86de-dc9a27cf12c7>
Date: Tue, 21 Feb 2012 14:59:59 +0000
Subject: [PATCH] ACT-1068 adding documentation on error start event

---
 userguide/src/en/chapters/ch07-BPMN.xml       |  54 ++++++++++++++++++
 .../src/en/images/bpmn.start.error.event.png  | Bin 0 -> 3630 bytes
 2 files changed, 54 insertions(+)
 create mode 100644 userguide/src/en/images/bpmn.start.error.event.png

diff --git a/userguide/src/en/chapters/ch07-BPMN.xml b/userguide/src/en/chapters/ch07-BPMN.xml
index 8d3cc3aabc..1df18cd782 100644
--- a/userguide/src/en/chapters/ch07-BPMN.xml
+++ b/userguide/src/en/chapters/ch07-BPMN.xml
@@ -1389,6 +1389,60 @@ ProcessInstance startProcessInstanceByMessage(String messageName, String busines
         </para>
          
 
+      </section>
+
+        </section>
+        
+        
+        
+         <!-- //////////////////////////////////////// error start events -->
+        
+        <section id="bpmnErrorStartEvent">
+
+            <title>Error start event</title>
+
+            <section id="errorStartEventDescription">
+
+	        <title>Description</title>
+	
+	        <para>
+	            An <link linkend="bpmnErrorEventDefinition">error</link> start event can be used to trigger an event subprocess. 
+	            <emphasis role="bold">An error start event cannot be used for starting a process instance</emphasis>.
+	        </para>
+	        
+	        <para>
+	           An error start event is always interrupting.
+	        </para>
+	        
+	      </section>
+
+            <section id="errorStartEventGraphicalNotation">
+
+              <title>Graphical notation</title>
+
+              <para>
+                A error start event is visualized as a circle with an error event symbol. The symbol is unfilled, to visualize the catching (receiving) behavior. 
+                <mediaobject><imageobject><imagedata align="center" fileref="images/bpmn.start.error.event.png"/></imageobject></mediaobject>
+              </para>
+
+            </section>
+
+            <section id="errorStartEventXml">
+
+        <title>XML representation</title>
+
+        <para>
+          The XML representation of an error start event is the normal
+          start event declaration with an errorEventDefinition child-element:
+          
+          <programlisting>
+&lt;startEvent id=&quot;messageStart&quot; &gt;
+	&lt;errorEventDefinition errorRef=&quot;someError&quot; /&gt;
+&lt;/startEvent&gt;</programlisting>
+        
+        </para>
+         
+
       </section>
 
         </section>
diff --git a/userguide/src/en/images/bpmn.start.error.event.png b/userguide/src/en/images/bpmn.start.error.event.png
new file mode 100644
index 0000000000000000000000000000000000000000..a8f98b7f18000d0ecda73f4963edded208d3d909
GIT binary patch
literal 3630
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
X@Yn;`o0<Un9}i@pYpg@ma*X{SRaeLI

literal 0
HcmV?d00001

-- 
GitLab