# Manage the workflow

{% hint style="info" %}
User permissions: Budgets & Forecasts and Manage Budgets & Forecasts
{% endhint %}

There's a separate [workflow](https://docs.phocassoftware.com/budgets-and-forecasts/contributor/use-workflows) for most types of worksheet tabs. If you are the budget owner, your name displays as the baseline in the workflow for all rows in a worksheet, which means that the workflow starts and stops with you. If you are a budget administrator, you can take over the workflow at any time.&#x20;

As illustrated in the diagram below, you assign tasks (rows) to other users (contributors) and when they complete those tasks, they submit the rows back to you. You can then review those rows and either accept or reject them. When you believe there is no more work to do for the rows, you can mark them as complete.

<figure><img src="https://content.gitbook.com/content/aNH5UMuZXBHuAbFF7nI2/blobs/V2Y7bBC5bRGj1kzd2KOR/2776662230.png" alt="" width="839"><figcaption></figcaption></figure>

Preparing the budget or forecast is a collaborative process but you can have peace of mind knowing that while multiple users can work in a worksheet at any time, only the [current workflow owner ](https://docs.phocassoftware.com/budgets-and-forecasts/contributor/use-workflows#useworkflows-workflowowner)of a row can enter or edit data in that row.

{% embed url="<https://phocassoftware.wistia.com/medias/ut4xg4r05a>" %}
Manage the workflow
{% endembed %}

{% embed url="<https://phocassoftware.wistia.com/medias/tpibp7yb4y>" %}
Understanding workflow and task assignment
{% endembed %}

{% embed url="<https://phocassoftware.wistia.com/medias/b0mr6c1cpx>" %}
Delegate a budget line to another user
{% endembed %}

{% hint style="success" %}

* Watch this Phocas demo video for a brief overview: [Workflows and user permissions](https://www.phocassoftware.com/watch-demo/workflows-and-user-permissions?autoplay=true)&#x20;
* To help you manage the workflow process, add administrators to the workbook. Administrators can also take over the workflow in your absence.
  {% endhint %}

## Assign tasks <a href="#managetheworkflow-assigntasks" id="managetheworkflow-assigntasks"></a>

You can assign tasks individually, one row at a time, or assign multiple tasks simultaneously. Assignees (workflow contributors) will see a pink notification on their Phocas homepage next to the relevant workbook, with a number indicating how many tasks they have. You can also[ enable email workflow notifications](https://docs.phocassoftware.com/budgets-and-forecasts/owner-and-administrator/manage-user-access-and-notifications), so assignees get an email informing them they have tasks to complete.

### Assign one task to a user <a href="#managetheworkflow-assignonetasktoauser" id="managetheworkflow-assignonetasktoauser"></a>

1. In the **Workflow** column of a row (or row within a selection of rows), click the workflow status button (it will display as **Baseline** initially).
2. In the workflow window, enter a comment, if required.
3. Click the **Assign** button and select the required user.
   * The workflow window closes instantly and the **Workflow** column updates to reflect your changes - the label on the **Baseline** button changes to **Assigned** and your name is replaced by the user you assigned the task to. Your initials (predecessor identifier) remain, so other users can see who assigned the task.
   * If you change your mind, make a mistake or want to edit the values in the row yourself, you can unassign the user from the row. Click the **Assigned** button, then click **Unassign**. The row returns to you and the other user loses the ability to edit the data.

For example, in the image below, you can see that the budget owner Charlie C.Epho assigned some of the Marketing rows to Mark Marketing and Andy Admin, and the Direct Fuel and Telephone rows to Bill Branchmanager. Charlie remains as the baseline for the remaining Marketing rows, as she didn’t assign them to anyone else. She could not assign the Sales row to any user, as it is being driven (by the Database driver tab).

<div align="left"><figure><img src="https://content.gitbook.com/content/aNH5UMuZXBHuAbFF7nI2/blobs/5Hdr3VwWTl6j9ytW6gj5/image.png" alt="" width="563"><figcaption></figcaption></figure></div>

### Assign multiple tasks to a user simultaneously <a href="#managetheworkflow-assignmultipletaskstoausersimultaneously" id="managetheworkflow-assignmultipletaskstoausersimultaneously"></a>

There are several ways to assign tasks in bulk:

#### Update all rows with a specific workflow status

With no rows selected, click the **Row** menu > **Select all rows with workflow status**, then select the applicable status. With those rows now selected, click the **Row** menu again and select **Update workflow status**, then change the status as usual. The workflow status of all the selected rows is automatically updated.

<figure><img src="https://content.gitbook.com/content/aNH5UMuZXBHuAbFF7nI2/blobs/sWWhi5EdsboNdcjAJ3u2/3466855192.png" alt="image-20240430-213437.png" width="713"><figcaption></figcaption></figure>

#### Update an entire level (hierarchy) with a specific workflow status&#x20;

For example, you might want to select all baseline rows to assign them to a particular user or select all rows with Rejected status for closer inspection.

<figure><img src="https://content.gitbook.com/content/aNH5UMuZXBHuAbFF7nI2/blobs/fajnYPhiLSccuXKJjL0K/3598091293.png" alt="image-20240714-225523.png" width="862"><figcaption></figcaption></figure>

{% embed url="<https://phocassoftware.wistia.com/medias/7fuukcayke>" %}

#### Manually multi-select *like* (similar)rows

These are rows that have the same resulting action, for example, all rows you want to assign to a particular user. These rows can contain a mix of predecessors, owners, and actions. The first row you select determines which other rows can be selected. The *like* rows become available for selection via their checkboxes. As *unlike* rows cannot be selected, their checkboxes do not display. When you make a selection, you can proceed in two ways:

* Use the **Row** menu to take further action with those selected rows.

  <div align="left"><figure><img src="https://content.gitbook.com/content/aNH5UMuZXBHuAbFF7nI2/blobs/hODhLEe60mpEbiQbqtby/3467608123.png" alt="image-20240430-213737.png" width="306"><figcaption></figcaption></figure></div>
* Click on any row in that selection to proceed with assigning the rows.

Note the UI in the following video is out of date but the context is the same.

{% embed url="<https://phocassoftware.wistia.com/medias/ae4v83ror4>" %}

## Check assignments <a href="#managetheworkflow-reviewcompletedtasks" id="managetheworkflow-reviewcompletedtasks"></a>

While there's no need for you to check that your assignments were implemented correctly, you might want to check them to understand the process better, and see the workflow from the other users' perspectives. There are three ways to do this:

* **Shadow a user**: Sit beside a user and watch as they sign into Phocas, open the workbook and [view their tasks](https://docs.phocassoftware.com/budgets-and-forecasts/contributor/use-workflows/contribute-to-the-workflow)
* **Impersonate the user**: If you have permission, you can use the [Impersonate tool](https://docs.phocassoftware.com/budgets-and-forecasts/owner-and-administrator/broken-reference) to view the workbook as a specified user would.
* **Focus on a region or branch**: Coming soon - Use the View as tabs feature to isolate branch or region data for focused reviews.

## Review completed tasks <a href="#managetheworkflow-reviewcompletedtasks" id="managetheworkflow-reviewcompletedtasks"></a>

When users complete their tasks, they might assign the rows to other users for their input or submit the rows straight back to you. Ultimately, as the budget owner, the rows end up back with you.

When a user submits a task, a notification displays in the **Tasks** button in the top right corner. You can either click a task summary to go straight to the corresponding row in the worksheet, which displays in blue, or click the **My tasks** button in the search box to filter the worksheet and view only the rows that were submitted or assigned to you.

<div align="left"><figure><img src="https://content.gitbook.com/content/aNH5UMuZXBHuAbFF7nI2/blobs/7zQB3eavyUbdOQYo5r3I/2929820364.png" alt="" width="510"><figcaption></figcaption></figure></div>

Review the values that were completed by the user and read any [cell comments](https://docs.phocassoftware.com/budgets-and-forecasts/contributor/review-the-budget-or-forecast/add-and-view-cell-comments).&#x20;

Review the [workflow comments](https://docs.phocassoftware.com/budgets-and-forecasts/contributor/use-workflows/view-workflow-comments) and [workflow history](https://docs.phocassoftware.com/budgets-and-forecasts/contributor/use-workflows/view-the-workflow-history), to see how the row progressed from the baseline to being a fully completed budget or forecast line item.

## Accept or reject rows <a href="#managetheworkflow-acceptorrejectrows" id="managetheworkflow-acceptorrejectrows"></a>

If you are satisfied with a row, you can accept it.

If you are not satisfied with the row, you can make your own revisions, then accept the row, or reject the row and send it back to the user for further editing. The workflow continues until you finally accept the row.

You can also accept or reject rows in bulk (read more about this in the **Assigned tasks** section above).

1. In the **Workflow** column of a row (or row within a selection), click the **Submitted** button.
2. In the workflow window, enter a comment, if required.
3. Click **Accept** or **Reject**, as applicable.

   <div align="left"><figure><img src="https://content.gitbook.com/content/aNH5UMuZXBHuAbFF7nI2/blobs/4JBExpNmHW1sDVzVQZlt/2929459405.png" alt="" width="456"><figcaption></figcaption></figure></div>

{% hint style="success" %}
When you accept a row, you can mark the row as complete, as a personal reminder that you have reviewed and accepted the values.
{% endhint %}

## Mark a row as complete <a href="#managetheworkflow-markarowascompleted" id="managetheworkflow-markarowascompleted"></a>

The **Completed** status in the workflow means the row is unassigned to a user, therefore the values can't be edited. This status is useful:

* For reference purposes; it's a note to the budget owner that the data entry for the row is complete and has been reviewed.&#x20;
* For [securing a completed budget or forecast](https://docs.phocassoftware.com/budgets-and-forecasts/owner-and-administrator/create-a-budget/secure-and-distribute-a-completed-budget-or-forecast) prior to distribution.

You don't need to mark every row as complete before you can publish or use the budget or forecast.&#x20;

When the workflow is back with you, you can mark the row(s) as complete in two ways:

* Individual row: Click the **Mark as Complete** button ![](https://content.gitbook.com/content/aNH5UMuZXBHuAbFF7nI2/blobs/qAiKovpHrmCNd5wEJfGd/image.png) or click the **Accepted** button, enter a comment if required, and click **Complete**.
* Multiple rows in bulk: Select the applicable rows, then click the **Row** menu > **Mark as complete**.

  <div align="left"><figure><img src="https://content.gitbook.com/content/aNH5UMuZXBHuAbFF7nI2/blobs/deuszw76u4a93H3TBjYB/3467608135.png" alt="image-20240430-214547.png" width="295"><figcaption></figcaption></figure></div>

Either way, the **Workflow** column updates to reflect your changes - the green **Completed** button ![](https://content.gitbook.com/content/aNH5UMuZXBHuAbFF7nI2/blobs/0C1y97ahzCdfGZJlWI9g/image.png) displays and your name no longer displays, indicating that the workflow has stopped.

<div align="left"><figure><img src="https://content.gitbook.com/content/aNH5UMuZXBHuAbFF7nI2/blobs/3ylcagmOnBGtOsi81Qtp/2776662261.png" alt="" width="272"><figcaption></figcaption></figure></div>

{% hint style="success" %}
To save time, you can select multiple rows and mark one of them as complete - all of the selected rows will display as completed.
{% endhint %}

If you need to undo this action and reopen the row in the workflow, click the **Completed** button. You can also use the **Row** menu to select all rows with the workflow status of Completed, then update the status as required.

## Take over the workflow <a href="#managetheworkflow-takeovertheworkflow" id="managetheworkflow-takeovertheworkflow"></a>

If you are a budget administrator, you can take over the ownership of the workflow from the budget owner by assigning yourself a row. This action is recorded in the workflow history. You can then assign the row to someone else or submit it back to the budget owner. This option is useful when the budget owner is unavailable, and the workflow is at a standstill.

In the **Workflow** column of a row (or row within a selection of rows), click the workflow status button and click **Self Assign**.

## Revert to baseline <a href="#managetheworkflow-reverttobaseline" id="managetheworkflow-reverttobaseline"></a>

You can undo all of the changes that were made in the workflow for a row, so you can start the process again. See [Revert to the baseline values](https://docs.phocassoftware.com/budgets-and-forecasts/contributor/edit-values-in-a-worksheet/revert-to-the-baseline-values).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.phocassoftware.com/budgets-and-forecasts/owner-and-administrator/manage-the-workflow.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
