summaryrefslogtreecommitdiffstats
blob: eba8835bbe3d9eb8a2be42ada62a14c4bc430858 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<meta http-equiv="Content-Style-Type" content="text/css">
<link rel="STYLESHEET" href="../../../styles/carnot.css"
	charset="ISO-8859-1" type="text/css">
<title>Aborting and Starting Processes</title>
<script language="JavaScript" src="../../../styles/naviLine.js"
	type="text/javascript"></script>
</head>
<body>
<script language="JavaScript" type="text/javascript">
<!--
writeNavigation("Aborting and Joining Processes","../../../toc.html",
        "extracting-pages.html","abort-and-join-process.html",
		"../../handbooks.htm","Developer Handbooks",
		"../tut-preface.htm","Tutorial",
		"derive-procs-preface.html","Managing Unstructured Workflows");
-->
</script>

<h1>Aborting and Starting Processes</h1>
<p>This tutorial describes how to abort existing process instance and start another process instance. 
Also, check whether the documents attached to the source process instance are copied in the target process instance. </p>
<p>In an organization, process instances are started in the incorrect process definitions.
This resulted into manual download and upload of the documents. So, the organization has requested
an enhancement to the existing functionality.
For detail scenario refer to the <a href="PLUGINS_ROOT/org.eclipse.stardust.docs.dev/html/handbooks/concepts/
executing-workflow/abort-and-start-usage.html#usage">Common Usage Pattern</a>
section of the <a href="PLUGINS_ROOT/org.eclipse.stardust.docs.dev/html/handbooks/concepts/
executing-workflow/abort-and-start-usage.html">Aborting and Starting Processes
</a> 
chapter of the <a href="PLUGINS_ROOT/org.eclipse.stardust.docs.dev/html/handbooks/concepts/
key-concepts.html"> Concepts</a> handbook. 
</p>
<p>For details on the abort and start functionality, refer to 
<a href="PLUGINS_ROOT/org.eclipse.stardust.docs.enduser/html/handbooks/execution-clients/detail-views/switch-process-dialog.html">
 The Abort Process and Start Dialog
</a> chapter of the
<a href="PLUGINS_ROOT/org.eclipse.stardust.docs.enduser/html/toc.html">End User Handbooks</a>.</p>

<p>This tutorial covers the following:</p>
<ul>
	<li><a href="#import">Importing the Example Model</a></li>
	<li><a href="#deploy">Deploying and Running the Model</a></li>
	<li><a href="#execute">Executing the Workflow</a></li>
	<ul><li><a href="#asp">Aborting and Starting Processes</a></li>
		<ul><li><a href="#link">Viewing the Linking between Processes</a></li>
	<li><a href="#data">Viewing the Data</a></li>
	<li><a href="#his">Viewing the Process History</a></li></ul></ul>
</ul>
<p>So, let's abort the IRA process instance and start the Loan process instance. Also, we need to check that after the 
abort and start operation; the document attached with the IRA process is copied to the Loan process.</p>
<h2 id="import">Importing the Example Model</h2>
<p>Use the provided <strong>AbortStart</strong> example model which contains 
appropriate declarative security.</p> 
<ol>	
	<li>Download the following ZIP file which contains the example model:</li>
	<p class="ind"><a
	href="../../../examples/tutorials/derive-procs/derive-procs.zip">
	derive-procs.zip</a><br></br></p>

	<li>Create a dynamic Web project designed to deploy @productname@
	 models to run in the @productname@ Portal.
	For detailed information on creating dynamic Web projects for usage with
	the @productname@ Portal, please refer to the <a
	href="PLUGINS_ROOT/org.eclipse.stardust.docs.wst/html/wst-integration/toc.html">
	Rapid Application Development</a> guide.</li>

	<li>Right-click the project and select 
	<strong>Import &gt; @productname@ &gt; @productnameonly@ Process Model</strong>.
	Click <strong>Next</strong> and browse to the location of the example
	model extracted from the zip file.</li>
	<li>Make sure that the Bank Executive role has the <strong>Abort Process Instance</strong>
	permission granted for the IRA process.</li>
	<p class="image"><img src="images/tut-ira.png" alt="IRA - Abort Process Instance"> <br>
	<strong>Figure:</strong> IRA - Abort Process Instance</p>
	<li>Also, make sure that IRA and Loan process support attachments.</li>
	
	<p class="image"><img src="images/process-attachment.png" alt="Process Supports Attachments"> <br>
	<strong>Figure:</strong> Process Supports Attachments - IRA</p>
</ol>
<h2 id="deploy">Deploying and Running the Model</h2>
<p>Perform the following steps to deploy the model and run
the project in the @productname@ Portal:</p>
<ol>
	<li>Start the server and deploy the model. For details on how to
	deploy a model, please refer to the chapter <a
		href="../tut-main-12.htm">Deploying a Workflow Model</a> of the <a
		href="../support-case-preface.htm">Support Case Example</a>.</li>
	<li>Start the @productname@ Portal as described in the chapter <a
		href="PLUGINS_ROOT/org.eclipse.stardust.docs.enduser/html/handbooks/execution-clients/portal-login.html">
	Login to the @productname@ Portal</a> of the <a
		href="PLUGINS_ROOT/org.eclipse.stardust.docs.enduser/html/toc.html">End User
	Handbooks</a>. Login as administrator (<tt>motu/motu</tt>). You can use the
	Shift-F8 shortcut key.</li>
	
	
</ol>

<h2 id="execute">Executing the Workflow</h2>
<ol>
	<li>Switch to the <a
		href="PLUGINS_ROOT/org.eclipse.stardust.docs.enduser/html/handbooks/execution-clients/admin-portal/views/admin-portal-participant.html">
	Participant Management View</a> of the <a
		href="PLUGINS_ROOT/org.eclipse.stardust.docs.enduser/html/handbooks/execution-clients/admin-portal/admin-portal.html">
	Administration Perspective</a>.</li>
	<li>Create a user and assign him the role <strong>Bank Executive</strong>. 
	For details on how to create a new user, please refer to the section <a
		href="PLUGINS_ROOT/org.eclipse.stardust.docs.enduser/html/handbooks/execution-clients/admin-portal/views/admin-portal-participant.html#createUser">
	Creating a new User</a> of the chapter <a
		href="PLUGINS_ROOT/org.eclipse.stardust.docs.enduser/html/handbooks/execution-clients/admin-portal/views/admin-portal-participant.html">
	Participant Management View</a> of the <a
		href="PLUGINS_ROOT/org.eclipse.stardust.docs.enduser/html/handbooks/execution-clients/admin-portal/admin-portal.html">
	Administration Perspective</a> guide.</li>
	</li>
	<p class="image"><img src="images/tut-ira-role.png" alt="Participant - Role 1"> <br>
	<strong>Figure:</strong> Participant - Role 1</p>
	<li>Logout and login again as the new user.</li>
	
</ol>
<h3 id="asp">Aborting and Starting Processes</h3>
<ol>
	<li>In the <a
		href="PLUGINS_ROOT/org.eclipse.stardust.docs.enduser/html/handbooks/execution-clients/pp_renovated/process-portal.html">
	Workflow Perspective</a>, start the process <strong>IRA</strong></li>
	<li>In the toolbar, click <strong>Process Documents</strong> icon and choose <strong>Upload Document</strong></li>
	<p class="image"><img src="images/tut-upload-doc.png" alt="Upload Document"> <br>
	<strong>Figure:</strong> Upload Document</p>
	<li>In the <strong>Upload File</strong> dialog, browse to the location of 
	the document and click <strong>Upload</strong>. You can upload document of your choice.</li>
	<li>Now open the <strong>Process Details</strong> view for the 
	<strong>IRA</strong> process instance.</li>
	<li>Expand the <strong>Process Documents</strong> panel.
	The uploaded document is displayed under <strong>Process Attachments</strong>.</li>
	
	<p class="image"><img src="images/ira-pd.png" alt="IRA - Process Attachment"> <br>
	<strong>Figure:</strong> IRA - Process Attachment</p>
	<li>In the Activity Instance view, click the down-arrow displayed next to the Abort icon and 
	choose <strong>Abort Process and Start</strong> option.</li>
	
	<p class="image"><img src="images/abort-start-button.png" alt="IRA - Abort Process and Start"> <br>
	<strong>Figure:</strong> IRA - Abort Process and Start</p>
	<p>The <strong>Abort Process and Start</strong> dialog is displayed.</p>
	
	<li>Select the Loan process from the <strong>Start Process</strong> drop-down list. It contains processes the logged in user is able to start.</li>
	<li>Enter appropriate comment in the <strong>Link Comment</strong> text box.</li>
	<p class="image"><img src="images/abort-start.png" alt="Abort Process and Start"> <br>
	<strong>Figure:</strong> Abort Process and Start</p>
	<li>Click <strong>Ok</strong></li>
	<li>In the <strong>Abort Process and Start</strong> confirmation dialog, click <strong>Yes</strong> 
	to view the process details of the newly started Loan process instance.</li>
		<p class="image"><img src="images/abortstart-confirm.png" alt="Abort Process and Start Confirmation"> <br>
	<strong>Figure:</strong> Abort Process and Start Confirmation</p>
	
</ol>
<h4 id="link">Viewing the Linking between Processes</h4>
<p>In the Worklist view, the newly started process Loan gets displayed. </p>
<ol>
	
	<li>In the <strong>Actions</strong> column of the activity, click the <strong>Process Details</strong> icon.</li>
	<p class="image"><img src="images/actions.png" alt="Process Details - Loan"> <br>
	<strong>Figure:</strong> Process Details - Loan</p>
	
	<li>Expand the <strong>Linked Processes</strong> panel for the target process - Loan </li>
	<p class="image"><img src="images/linked-pro.png" alt="Linked Processes"> <br>
	<strong>Figure:</strong> Linked Process with Target Process</p>
	<p>The link to the source process instance is displayed.</p>
	<p class="image"><img src="images/linkp.png" alt="Linked Process - IRA"> <br>
	<strong>Figure:</strong> Linked Process with Target Process - IRA</p>
	<li>In the <strong>Linked Processes</strong> panel of the target process Loan, 
	click the IRA process in the <strong>Process</strong> column.</li>
	<p class="image"><img src="images/linkedIRA.png" alt="Linked Process - Loan"> <br>
	<strong>Figure:</strong> Linked Process - IRA</p>
	<p>The process details of the source process IRA get displayed.</p>
	<li>Expand the <strong>Linked Processes</strong> panel of the source process IRA. 
	The link to target process Loan is displayed.</li>
	<p class="image"><img src="images/ira-details.png" alt="Linked Process - Loan"> <br>
	<strong>Figure:</strong> Linked Process with Source Process - Loan</p>
	
</ol>
<h4 id="data">Viewing the Data</h4>
<p>Expand the <strong>Process Documents</strong> panel for the target process - Loan</p>
<p class="image"><img src="images/pd.png" alt="Process Documents"> <br>
<strong>Figure:</strong> Process Documents</p>
<p>The document from the source process instance IRA gets copied to the target process instance Loan. 
For more information, please refer to
 the <a href="PLUGINS_ROOT/org.eclipse.stardust.docs.dev/html/handbooks/modelling/mg-subprocesses.html#semantics">
 Data Copy/Mapping Semantics</a> section of the 
 <a href="PLUGINS_ROOT/org.eclipse.stardust.docs.dev/html/handbooks/modelling/mg-subprocesses.html">Configuring Sub-process Activities
 </a> chapter of the of the <a href="PLUGINS_ROOT/org.eclipse.stardust.docs.dev/html/handbooks/modelling/mg-preface.htm">Modeling Guide</a>.</p>
<p class="image"><img src="images/loan-attach.png" alt="Loan - Process Attachment"> <br>
	<strong>Figure:</strong> Attached Document to Target Process - Loan</p>
<h4 id="his">Viewing the Process History</h4>
<p>Expand the <strong>Process History</strong> panel for target process - Loan</p>
<p class="image"><img src="images/loan-history.png" alt="Process History - Loan"> <br>
	<strong>Figure:</strong> Process History - Loan</p>
<p>Note that in the process history of the target process Loan, details of the source process are not displayed.</p>	

<p class="image"><img src="images/process-history.png" alt="Process History - Loan"> <br>
	<strong>Figure:</strong> Process History - Loan - Target Process</p>
<p>Similarly, if you open the process history of the source process IRA, the process history of the target process is not shown.</p>

<script language="JavaScript" type="text/javascript">
<!-- 
writeFooter(); 
-->
</script>
</body>
</html>