spiff-arena/docs/Support/suspend_resume_terminate.md

# Suspend, Resume, and Terminate a Process

| ⚙ How do I get there \| Menu Hierarchy |
| -------------------------------------- |
| Follow steps to find a process instance |


## Suspend a Process

By suspending a process instance, you temporarily halt its execution, allowing you to access and modify the necessary data or configurations associated with that specific instance.
This feature is not only useful for making updates, but also enables the possibility to redo a previous step with different metadata if needed.

> **Step 1: Find the Active Process Instance**

- In order to locate the active process instance, have a look at these pages to find an instance to suspend.

```{admonition} Note

⚠ Note that the suspension of a process instance is only applicable to active instances.
If an instance is not active, it indicates that the process has already been completed, and therefore, it cannot be suspended.

```

> **Step 2: Locate Suspend Icon**

![suspend](images/suspend.png)

- Next to the Process Instance Id, look for the icon that resembles the 'Suspend' icon and select it to initiate the suspension of the process instance.

> **Step 3: Select Suspend Button**

Click on the 'Suspend' icon.
This action will pause the process instance, granting you the ability to make edits and modifications.
When ready, the process instance can be resumed.
The process instance remains highlighted in yellow.

![suspend](images/active_process_instance.png)


| ✅ Success                                                    |
|  :----:  |
| Confirm that the status has changed from ‘waiting’ to ‘suspended’|
|![suspended](images/suspended.png)|

## Resume a Process

Resuming a process is essential for ensuring that the process can continue its execution, recover from interruptions, and proceed with the necessary updates or corrections.

> **Step 1: Locate Resume Icon**

![resume](images/resume.png)

- Next to the Process Instance Id, look for the icon that resembles the 'Resume' icon and select it to resume the suspended process instance.

> **Step 2: Select Resume Button**

- Click on the 'Resume' button. This action will cause the process instance to go back to its active state, allowing the process instance to continue. Depending on where the process instance is in its journey, the status might be waiting or some other active status. The process instance remains highlighted in yellow.

![suspend](images/active_process_instance.png)


| ✅ Success                                                    |
| :----:  |
| Confirm that the status has changed from ‘suspended’ to an active status.|
![waiting](images/waiting.png)|

## Terminate a Process Instance

Terminating refers to ending the execution of a specific occurrence of a process before it reaches its natural completion or final outcome.
There are various reasons for terminating a process instance such as the instance is no longer required or it's in an error state.

> **Step 1: Locate Terminate Icon**

![terminate](images/terminate.png)

- Next to the Process Instance Id, look for the icon that resembles the 'Terminate' icon and select it to terminate the process instance.

> **Step 2: Select Terminate Button**

- Click on the 'Terminate' button. Note that the process instance will be terminated permanently, and this action cannot be undone.

> **Step 3: Confirm Termination**

- Before proceeding with the termination, it is essential to be absolutely certain about your decision.
![terminate_warning](images/terminate_warning.png)

- The process status will now be 'Terminated' and the last active task will be highlighted in purple.
![suspend](images/terminated_process_instance.png)

| ✅ Success                                                    |
| :----:  |
| Confirm that the status has changed from ‘suspended’ to 'terminated'
![suspend](images/terminated.png) |

## Reset a Process
> **Step 1: Find the active Process Instance**

> **Step 2: Navigate to the active User Task**

👤 Note that you need Admin rights to complete the following steps.

> **Step 3: Suspend the Process**

Ensure the status has changed from *user_input_required* to *suspended*
![Reset](images/reset_process2.png)
> **Step 4: Go to the relevant past activity**

Only a previously completed section highlighted in grey can be chosen.

> **Step 5: Select 'View process instance at the time when this task was active.**

![Reset](images/reset_process3.png)

> **Step 6: Observe the task once highlighted in grey should now be yellow.**

A previously completed section is now active and shown in yellow.

> **Step 7: Select 'Reset Process Here’ icon in the popup window.**

![Reset](images/reset_process5.png)

> **Step 8: "Resume" process instance.**
The process instance should be resumed by selecting the ‘Resume’ icon next to the Process Instance Id 

![Reset](images/reset_process6.png)


> **Step 9: Refresh page**

Wait for Resume action to complete, this may take some time. Refresh the page to ensure it has transitioned to the next activity, replacing the current one.

<aside>
✅ From this point onward, the remaining part of the process can smoothly proceed.

</aside>