summaryrefslogtreecommitdiffstats
blob: b1138164eb52d9b9792e653e30f8e2ae271e9448 (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
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>The Abort Process and Start Dialog</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" type="text/css"
	href="../../../styles/carnot.css" title="Style">
<script language="JavaScript" src="../../../styles/naviLine.js"
	type="text/javascript"></script>
</head>
<body>
<script language="JavaScript" type="text/javascript">
<!--
	writeNavigation("The Abort Process and Join Dialog","PLUGINS_ROOT/org.eclipse.stardust.docs.dev/html/toc.html",
		"spawn-process-dialog.html","abort-and-join-dialog.html",
		"../../../toc.html","End User Handbooks",
		"../carnot-clients.html","@productname@ Portal",
		"detail-views.html","Common Tables, Detail Views and Dialogs");
 -->
</script>

<h1>The Abort Process and Start Dialog</h1>

<p>The <strong>Abort Process and Start</strong> dialog allows you to effectively switch the in-scope process instance to a different process definition.
 When you abort an existing process instance and start another, the data associated with the aborted process
 is passed by copy to the newly created process. For more information, refer to
 section
<span class="hideReference"><strong>Data Copy/Mapping Semantic</strong>
of chapter <strong>Configuring Subprocess Activities</strong> in the
<strong>@productname@ Documentation - Modeling Guide</strong>.</span>
<span class="showReference"> 
<a href="PLUGINS_ROOT/org.eclipse.stardust.docs.dev/html/handbooks/modelling/mg-subprocesses.html#semantics">
Data Copy/Mapping Semantics</a> of chapter 
<a href="PLUGINS_ROOT/org.eclipse.stardust.docs.dev/html/handbooks/modelling/mg-subprocesses.html">
Configuring Subprocess Activities</a> in the 
<a href="PLUGINS_ROOT/org.eclipse.stardust.docs.dev/html/handbooks/modelling/mg-preface.htm">
Modeling Guide</a>.</span></p>
 <p>So, the Abort Process and Start option:</p>
<ul>
	<li>Starts a new process instance in the selected process definition</li>
	<li>Copies data from the source (in scope) Process Instance to the newly started process instance</li>
	<li>Aborts the in-scope process instance</li>

</ul>
<p>Note that the <strong>Abort Process Instances</strong> and the <strong>Abort and Start</strong> permissions are required.  
If these permissions are not granted to the logged in user then the <strong>Abort and Start</strong> option is disabled. 
For more information, please refer to the chapter <a href="../admin-portal/views/admin-portal-authorization-mgr.html">
Authorization Manager</a> of <a href="../admin-portal/admin-portal.html">Administration Perspective</a>.

<span class="hideReference">Also, refer to the chapter
 <strong>Authorization</strong> in the
<strong>@productname@ Documentation - Modeling Guide</strong>.</span>
<span class="showReference"> 
 Also, refer to the chapter 
<a href="PLUGINS_ROOT/org.eclipse.stardust.docs.dev/html/handbooks/modelling/property-page-authorization.html">
Authorization</a> of the 
<a href="PLUGINS_ROOT/org.eclipse.stardust.docs.dev/html/handbooks/modelling/mg-preface.htm">
Modeling Guide</a>.</span>

</p>
<ol>

	<li>To abort an existing process instance and start another process, click the
 down-arrow icon displayed next to the Abort icon and choose <strong>Abort Process and Start</strong> option from the toolbar.</li> 

<p class="image"><img src="images/switch-option.png" alt="Abort ans Start Process">
<br><strong>Figure:</strong> Abort Process and Start</p>

	<li>In the <strong>Abort Process and Start</strong> dialog, select the new process from the drop-down list. 
The <strong>Select Process</strong> drop-down lists only the startable processes as defined by manual triggers.
Note that the current in-scope process definitions are never listed for the selection.
 Also, you can specify a reason for aborting and starting the new process
  in the Link Comment box and click <strong>OK</strong>.</li>
<p class="image"><img src="images/switch-dialog.png" alt="Abort and Start Process dialog">
<br><strong>Figure:</strong> Abort Process and Start dialog</p>

<p>The <strong>Information</strong> dialog box displays the aborted process and started process details.</p>

<p class="image"><img src="images/switch-dialog-success.png" alt="Abort ans Start Process dialog">
<br><strong>Figure:</strong> Abort Process and Start dialog</p>
<li>Click <strong>Yes</strong> if you want to view the newly started process. The Worklist view displays the 
newly started process.</li>

<p class="image"><img src="images/switch-worklist.png" alt="Worklist View - Started Process">
<br><strong>Figure:</strong> Worklist View - Started Process</p>
</ol>
<p>You can view the root process from which the new process has started using the 
<strong>Linked Processes</strong> panel.</p>
<p class="image"><img src="images/switch-link.png" alt="Linked Processes">
<br><strong>Figure:</strong> Linked Processes</p>
<p>When any process is aborted and started the:</p>
<ul>
	<li>Source process instance is Switched To target process instance</li>
	<li>Target process instance is Switched From source process instance</li>
</ul>
<p>
The linked processes get displayed under the <strong>Linked Processes</strong> panel. 
Notice that the status is displayed as Active of the target process.
The link type of the target process instance is displayed as
<strong>Switched From</strong>. The term Switch stands for Abort and Start operation.
If you want to view the source process details then click on the process 
name displayed in the <strong>Process</strong> column
of the target process.
</p>
<p>Please note that the links are established between root process of the source process instance and the 
target process instance, which can be a sub-process.</p>

<h2>Aborting and Starting Multiple Processes</h2>
<p>You can abort and start multiple processes at a time. But before aborting and starting multiple processes,
the following conditions should be fulfilled.</p>
	<p class="image"><img src="images/multiple-abort.png" alt=" Aborting and Starting Multiple Processes">
<br><strong>Figure:</strong> Aborting and Starting Multiple Processes</p>
<ul>
	<li>All the selected processes should be from same model and model version. If the selected
	processes are not from same model version following validation message is displayed.</li>
	<p class="image"><img src="images/multiple-abort-validation1.png" alt=" Validation Message">
<br><strong>Figure:</strong> Abort and Start Confirmation Dialog - Validation</p>
	<li>In case you select one process with Active state and another process with Abort state, the following message is 
	displayed.
	</li>
<p class="image"><img src="images/multiple-abort-active.png" alt=" Validation Message">
<br><strong>Figure:</strong> Processes with Active and Abort State</p>
<p>If you click <strong>Yes</strong>, the Abort Process and Start dialog is displayed for active processes. Already 
aborted processes are not displayed.</p>
	<li>If you are not authorized to abort the process, the following message is displayed.</li>
	<p class="image"><img src="images/multiple-abort-noauth-png.png" alt=" Validation Message">
	<br><strong>Figure:</strong> Multiple Abort without Authorization for One of the Process</p>
	
</ul>

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