# Viewing flow deployments

## Introduction

The `flow deployments` page lists all flow deployments (current and historic) across all your virtual environments, and also deployments made to `no environment`.  For example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FocHJsOM9tr0ViPn1Le5d%2Fflow%20deployments%20page%201.png?alt=media&#x26;token=f1f92a85-e908-42a3-9e6d-60b73a3125f4" alt=""><figcaption></figcaption></figure></div>

Every deployment completed, irrespective of the deployment mechanism (i.e. deployed [individually](https://doc.wearepatchworks.com/product-documentation/virtual-environments/implementing-virtual-environments/deploying-a-single-process-flow-to-a-virtual-environment) or via a [package](https://doc.wearepatchworks.com/product-documentation/virtual-environments/virtual-environment-packages/managing-packages/deploying-a-package)), is listed.&#x20;

{% hint style="info" %}
If a flow deployment is [deleted](https://doc.wearepatchworks.com/product-documentation/virtual-environments/managing-virtual-environments-versions-and-flows/managing-virtual-environment-flow-deployments/deleting-a-process-flow-deployment-from-a-virtual-environment) from the associated virtual environment, the corresponding entry is removed from this list. Otherwise, deployments remain for all time.
{% endhint %}

## Accessing the flow deployments page

To access the `flow deployments` page, select `virtual environments` ➤ `deployments` from the left-hand navigation menu:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FBuysRx0yr6fujD4T3J3e%2Faccess%20flow%20deployments.png?alt=media&#x26;token=e3b31fe4-28c2-40b9-af46-9a35716be934" alt="" width="229"><figcaption></figcaption></figure></div>

## Understanding the flow deployments page

By default, flow deployments are listed in chronological order by deployment date/time, with the most recent deployments first.&#x20;

## Working with flow deployments

You can use [search and filter options](#search-and-filter-options) to refine the list, and you can use [actions](#flow-deployment-actions) to perform given tasks. Each entry is listed under a series of headings - for example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2Fu2hzqLwAEQhn3YBD3096%2Fflow%20deployments%20page%201a.png?alt=media&#x26;token=30f7e0c2-db8e-4508-83c7-094e82a6ecf6" alt=""><figcaption></figcaption></figure></div>

These headings are summarised below:

<table><thead><tr><th width="164.5546875">Heading</th><th width="446.23828125">Summary</th><th>Sort &#x26; filter?<select><option value="HWMyw9zzW4lm" label="can be filtered" color="blue"></option><option value="T9FCKIy16WQy" label="can be sorted" color="blue"></option><option value="TPDe7gGrlYjH" label="n/a" color="blue"></option></select></th></tr></thead><tbody><tr><td>Flow</td><td>The process flow name, displayed as a hyperlink (click the link to access the associated flow). If a deployment is associated with a flow version that has been subsequently deleted, the name will include a <code>deleted</code> marker. </td><td><span data-option="T9FCKIy16WQy">can be sorted</span></td></tr><tr><td>Version</td><td>The process flow version that was deployed.</td><td><span data-option="T9FCKIy16WQy">can be sorted</span></td></tr><tr><td>Package</td><td>If the deployment was made via a <a href="../../virtual-environment-packages/managing-packages/deploying-a-package">package</a>, the package name is displayed as a hyperlink (click the link to access the associated package).</td><td><span data-option="HWMyw9zzW4lm">can be filtered</span></td></tr><tr><td>Virtual environments</td><td>The name of the target virtual environment (if applicable).</td><td><span data-option="HWMyw9zzW4lm">can be filtered</span></td></tr><tr><td>Deployed at</td><td>The date and time that this flow version was last deployed to the associated virtual environment. <br><br>Typically, this won't change. However, if you were to deploy a flow version, then delete that deployment and subsequently re-deploy the same version to the same virtual environment, this value would be updated. </td><td><span data-option="T9FCKIy16WQy">can be sorted</span></td></tr><tr><td>Enabled at</td><td>The date and time that the deployment was last enabled. When a process flow is deployed, it is enabled automatically, so typically this date/time is the same as the <code>deployed at</code> date/time.<br><br>However, if you were to <a href="../../implementing-virtual-environments/deploying-a-single-process-flow-to-a-virtual-environment">deploy a flow version</a>, then <a href="disabling-or-enabling-a-process-flow-deployment-for-a-virtual-environment">disable</a> that deployment and subsequently re-enable it, this value would be updated. </td><td><span data-option="T9FCKIy16WQy">can be sorted</span></td></tr><tr><td>Enabled by</td><td>The username of the person who last enabled this deployment. <br><br>Typically, this will be the same as the <code>deployed by</code> value. However, if you were to <a href="disabling-or-enabling-a-process-flow-deployment-for-a-virtual-environment">disable</a> a deployment and subsequently it is re-enabled by a different user, this value would be updated. </td><td><span data-option="TPDe7gGrlYjH">n/a</span></td></tr><tr><td>...</td><td>Access <a href="#flow-deployment-actions">actions that can be taken with the selected flow deployment</a>.</td><td><span data-option="TPDe7gGrlYjH">n/a</span></td></tr></tbody></table>

### Search & filter options

Use the `search` field at the top of the page to search by any part of a process flow name. For example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FOWvzVX6Bz5rqljsuWHBM%2Fflow%20deployments%20page%20-%20search%20a.png?alt=media&#x26;token=98ea4cfb-6fb7-4678-b4cb-55b53ebfdddf" alt=""><figcaption></figcaption></figure></div>

You can also filter the list by `package` and/or `virtual environment`, using filter options associated with these columns. For example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FfmQuy9s1kbNbXcAiv4dM%2Fflow%20deployments%20page%20-%20search%20b.png?alt=media&#x26;token=1cc07257-75dd-43aa-8619-5d5a6f86f7fc" alt=""><figcaption></figcaption></figure></div>

Note that:

* Any virtual environments with at least one flow deployment (irrespective of whether those deployments are enabled or disabled) will be available for selection.
* Any packages deployed at least once will be available for selection.

### Flow deployment actions

The ellipsis associated with each deployment provides access to the following actions:

<table><thead><tr><th width="198.3359375">Option</th><th>Summary</th></tr></thead><tbody><tr><td>Disable / Enable</td><td><p>Availability depends on whether the selected deployment is currently <a href="disabling-or-enabling-a-process-flow-deployment-for-a-virtual-environment">enabled or disabled</a>, so you set the reverse state. Note that: <br></p><ul><li>If a deployment is <code>enabled</code>, it will run in the associated virtual environment.</li><li>If a deployment is <code>disabled</code>, it will NOT run in the associated virtual environment.</li></ul></td></tr><tr><td>Delete</td><td><a href="deleting-a-process-flow-deployment-from-a-virtual-environment">Delete the selected deployment</a>. This removes the flow version from the associated virtual environment and sets the status to <code>inactive</code>.</td></tr></tbody></table>
