CRNT-26692 - Reviewed and updated process defintion

git-svn-id: http://emeafrazerg/svn/ipp/product/trunk/stardust/documentation@60217 8100b5e0-4d52-466c-ae9c-bdeccbdeaf6b

16 files changed, 105 insertions, 11 deletions

diff --git a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/add-pro-param.png b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/add-pro-param.png
new file mode 100644
index 0000000..94a3a02
--- a/dev/null
+++ b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/add-pro-param.png
diff --git a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/create-process.png b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/create-process.png
index 2d481db..e9aef08 100644
--- a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/create-process.png
+++ b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/create-process.png
diff --git a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/data-path-icon.png b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/data-path-icon.png
new file mode 100644
index 0000000..7e65a21
--- a/dev/null
+++ b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/data-path-icon.png
diff --git a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/data-path.png b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/data-path.png
new file mode 100644
index 0000000..46b6d23
--- a/dev/null
+++ b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/data-path.png
diff --git a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/del-pro-confirm.png b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/del-pro-confirm.png
index 1ea5320..2799fa8 100644
--- a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/del-pro-confirm.png
+++ b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/del-pro-confirm.png
diff --git a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/delete-pro.png b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/delete-pro.png
index 7980981..481030c 100644
--- a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/delete-pro.png
+++ b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/delete-pro.png
diff --git a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/gen-proc-prop.png b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/gen-proc-prop.png
index 5a77584..306473d 100644
--- a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/gen-proc-prop.png
+++ b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/gen-proc-prop.png
diff --git a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/new-name.png b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/new-name.png
index 3bc9f46..be914c8 100644
--- a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/new-name.png
+++ b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/new-name.png
diff --git a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/proc-attach.png b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/proc-attach.png
index 03780cc..e40436e 100644
--- a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/proc-attach.png
+++ b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/proc-attach.png
diff --git a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/proc-com-icon.png b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/proc-com-icon.png
new file mode 100644
index 0000000..b69072a
--- a/dev/null
+++ b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/proc-com-icon.png
diff --git a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/proc-comm.png b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/proc-comm.png
new file mode 100644
index 0000000..c2f09ef
--- a/dev/null
+++ b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/proc-comm.png
diff --git a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/proc-display-prop.png b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/proc-display-prop.png
index 0517f03..235e134 100644
--- a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/proc-display-prop.png
+++ b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/proc-display-prop.png
diff --git a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/proc-int.png b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/proc-int.png
index acd192a..882ee34 100644
--- a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/proc-int.png
+++ b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/proc-int.png
diff --git a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/provide.png b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/provide.png
new file mode 100644
index 0000000..ab75646
--- a/dev/null
+++ b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/provide.png
diff --git a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/rename-process.png b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/rename-process.png
index 914431b..18e11c1 100644
--- a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/rename-process.png
+++ b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/images/rename-process.png
diff --git a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/pep-process.htm b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/pep-process.htm
index 12210a1..5d502a2 100644
--- a/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/pep-process.htm
+++ b/org.eclipse.stardust.docs.analyst/html/handbooks/modelling_analyst/pep-process.htm
@@ -117,31 +117,110 @@ A typical process definition contains swim lanes, activities and gateways, appli
 		<p class="image"><img src="images/proc-int-type.png" alt=""> <br>
 <strong>Figure:</strong> Process Interface - Type</p>
 	<ul>
-		<li>Provides Process Interface</li>
-		<li>Implements Process Interface</li>
-	
+		<li>No Process Interfaces - By default this option is selected. 
+		It means no process interface is defined for the current process definition.
+		</li>
+		<li><a href="#ppi">Provides Process Interface</a></li>
+		<li><a href="#ip">Implements Process Interface</a></li>
 	</ul>
 </li>
 </ol>
 
-<h4>Provides Process Interface</h4>
-<p></p>
+<p>
+So there are three valid states concerning declared and implemented process interfaces:
+</p>
 
-<h4>Implements Process Interface</h4>
-<p></p>
+<ul>
+	<li>The process definition neither implements nor declares a process interface</li>
+	<li>The process definition provides process interface and it is by default implementer of declared interface.
+	</li>
+	<li>The process definition implements a process interface.
+	</li>
+</ul>
+<h4 id="ppi">Provides Process Interface</h4>
+<p>This property defines the process interface. A model that wants to expose its process to 
+other consumer model should choose this option. When a process interface property 
+of a process definition is set to Provides Process Interface, 
+it can be referenced from the consumer model.
+When you select the Provides Process Interface, the following options are displayed:
+<p class="image"><img src="images/provide.png" alt=""> <br>
+<strong>Figure:</strong> Provides Process Interface</p>
+</p>
+
+<ul>
+	
+
+	<li>Web Service - If you select this check box then the process interface is invokable remotely via web service endpoint.</li>
+	<li>Rest Service - If you select this check box then the process interface is invokable remotely via rest endpoint.</li>
+	<li>Add Parameters -Click the <strong>Add</strong> icon to specify the process interface parameters. </li>
+	
+	<p class="image"><img src="images/add-pro-param.png" alt=""> <br>
+<strong>Figure:</strong> Add Parameters</p>
+	
+	
+	<li>Name - Specify the name of the formal parameter</li>
+	<li>Direction - Parameters for the process interface invocation. 
+	The list allows to select global data of the model to be selected as: 
+		<ul>
+		<li>IN - for read access</li>
+		<li>OUT - for write access</li>
+		<li>INOUT - for read and write access</li></ul>
+	</li>
+	<li>Data Type - Select data from the drop-down list. You can select following data types:
+		<ul>
+			<li>Primitive -If you select this option, you need to specify <strong>Primitive Type</strong> of the data. </li>
+			<li>Data Structure - If you select this option, you need to specify <strong>Data Structure</strong> of the data.</li>
+			<li>Document - If you select this option, you need to specify <strong>Document Type</strong> of the data.</li>
+		
+		</ul>
+		
+	</li>
+	<li>Data - Select data from the drop-down list.</li>
+
+</ul>
+<h4 id="ip">Implements Process Interface</h4>
+<p>A model that wants to provide an alternate implementation of its process definition should opt for 
+Implements Process Interface option. It provides an implementation 
+for a process interface defined in a provider model file.
+</p>
 
 <h3>Data Path</h3>
-<p>TO DO</p>
+<p>If defined as descriptors, data paths can be also used to visualize process data in the
+ @productname@ Portals. Note that only data paths defined as 
+ descriptors are visible in the @productname@ Portals. 
+
+Perform the following steps to modify the Data Path properties:</p>
+<ol>
+	<li>Make sure that property panel of the process definition is open </li>
+	<li>Click the <strong>Data Path</strong> icon displayed at top-right corner of the swim lane
+	
+	<p class="image"><img src="images/data-path-icon.png" alt=""> <br>
+<strong>Figure:</strong> Process Properties - Data Path Icon</p></li>
+
+	<li>Click the <strong>Add</strong> icon to specify the data path properties.
+	
+	
+	<p class="image"><img src="images/data-path.png" alt=""> <br>
+<strong>Figure:</strong> Process Properties - Data Path</p></li>
+	<li>Name -  Specify name for the data path</li>
+	<li>Direction - Select In, Out or In/Out direction from the drop-down list</li>
+	<li>Descriptor - Select this check box to define a descriptor for a process definition. </li>
+	<li>Key Descriptor - Select this check box to define a key descriptor for a process definition.
+	For more information, please refer to the chapter 
+<a href="PLUGINS_ROOT/org.eclipse.stardust.docs.dev/html/handbooks/maodeling/mg-defdesk-9.htm">Working with Data Paths</a> 
+of the 
+<a href="PLUGINS_ROOT/org.eclipse.stardust.docs.dev/html/handbooks/maodeling/mg-preface.htm">Modeling Handbook</a>.	</li>
+</ol>
 
 <h3>Display</h3>
-<p>Perform the following steps to modify the Display properties</p>
+<p>Perform the following steps to modify the Display properties:</p>
 
 <ol>
 	<li>Make sure that property panel of the process definition is open </li>
-	<li>Click the <strong>Display</strong> icon displayed at top right corner of the swim lane
+	<li>Click the <strong>Display</strong> icon displayed at top-right corner of the swim lane
 	
 	<p class="image"><img src="images/proc-display-prop.png" alt=""> <br>
-<strong>Figure:</strong> Process  - Display Icon</p></li>
+<strong>Figure:</strong> Process Properties- Display Icon</p></li>
 	<li>Select a check box <strong>Is Auxiliary Process</strong> to mark a process as auxiliary from a 
 	business perspective. Thus, non-business relevant process instances can be hidden in 
 	the @productname@ Portal. This check box is not selected, by default. 
@@ -151,6 +230,21 @@ A typical process definition contains swim lanes, activities and gateways, appli
 	
 </ol>
 
+<h3>Comments</h3>
+
+<p>Perform the following steps to specify comment:</p>
+
+<ol>
+	<li>Make sure that property panel of the process definition is open </li>
+	<li>Click the <strong>Process Attachments</strong> icon displayed at top right corner of the swim lane
+		<p class="image"><img src="images/proc-com-icon.png" alt=""> <br>
+<strong>Figure:</strong> Process Properties -Comments Icon</p></li>
+<li>Specfiy the comment in the text box and click <strong>Submit</strong></li>
+<p class="image"><img src="images/proc-comm.png" alt=""> <br>
+<strong>Figure:</strong> Process Properties -Comments</p>
+
+</ol>
+
 <h3>Process Attachments</h3>
 
 <p>Perform the following steps to specify process attachments:</p>