# Configuration

Case specific configurations can be made that have effect on the behaviour of active cases and the processes that support these cases.

Currently there are two options that can be configured on this page.

* Assigning a case handler
* Automatically assigning user tasks to the case handler

## Configuring cases to be assignable

On the case management page, a setting can be changed to indicate that cases of that type can have an assignee. This can be done by toggling the 'Case handler' checkbox to enable assigning cases.

{% tabs %}
{% tab title="Via UI" %}
When the case handler option is selected the following changes are visible in the user interface:

* **The case list screen is divided in to three tabs**

  <figure><img src="https://290147654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG2PoMeT8OSmMoaW7kF6t%2Fuploads%2Fgit-blob-ea8f2ec1832bd8a8876de903aa52f90d60208c8e%2Fimage%20(35)%20(1).png?alt=media" alt=""><figcaption><p>Case overview with case handler option selected<br></p></figcaption></figure>

  * **All cases**\
    \&#xNAN;*This overview is the same as for cases that do not have a case handler configured.*\
    \&#xNAN;*All cases are displayed on this tab.*
  * **My cases**\
    \&#xNAN;*Overview of cases that are assigned to the user that is currently logged in.*
  * **Unassigned cases**\
    \&#xNAN;*Overview of cases that are not assigned to a case handler*
* **An "Assignee" column is automatically added to the case list columns**\
  This column displays the case handler assigned to each case in the overview. This column is fixed and can't be removed via the case list configuration page.
* **An option to assign a case handler on the case details page.**\
  When clicked a dropdown menu is displayed with all case handlers that can be assigned to the case. Case handlers can be configured via [Access control](https://docs.valtimo.nl/v12/features/access-control) for each case type.
* **An additional menu in which a case can be claimed.**\
  In this menu the logged in user has the possibility to immediately "claim" the case. Once a case is claimed, the unassign option removes the case handler that is currently assigned to the case. Who is allowed to claim, assign and unassign is all configured via [Access control](https://docs.valtimo.nl/v12/features/access-control).
  {% endtab %}

{% tab title="Via IDE" %}
Case settings can be loaded automatically when creating a case by reading a configuration file. **This file will only be used when creating a case definition to avoid overriding user configuration.**

A file should be created on the classpath in the `/config/case/definition` folder. The filename should be the name of the document definition and use the `json` file extension. So if there is a document definition with the name `loans` then the json file should be named `loans.json`

```json
{
    "canHaveAssignee": true
}
```

{% endtab %}
{% endtabs %}

## Assigning a case handler

There are different ways of assigning a user to a case.

* Assigning the case via the UI
* Claiming the case via the UI
* Implementing a service task in the process
* Using an endpoint in the backend of the implementation

{% tabs %}
{% tab title="Via UI" %}
**Assigning a case**

On the case details page there is an option to assign a user. When clicked, a dropdown menu opens that displays all case handlers that can be assigned.

<figure><img src="https://290147654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG2PoMeT8OSmMoaW7kF6t%2Fuploads%2Fgit-blob-3342cf1c5b919d90016b1e2da6fecb059b3b931c%2Fimage%20(36)%20(1).png?alt=media" alt=""><figcaption><p>Assigning a user</p></figcaption></figure>

**Claiming a case**

When a specific case is opened, it can be claimed with the `Claim` button in the menu on the right side of the case details page.

<figure><img src="https://290147654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG2PoMeT8OSmMoaW7kF6t%2Fuploads%2Fgit-blob-71067ab818bc86fdb16303c7f12584d2a118fb9c%2Fimage%20(37).png?alt=media" alt=""><figcaption><p>Menu to claim a case or unassign the current assignee</p></figcaption></figure>

Once a case is assigned the `Unassign` button is enabled, making it possible to unassign the case again.

**User assignment through the process**

It is possible to assign a user to the current process by creating a service task and adding the following expression:

```
${documentDelegate.setAssignee(execution, "email address of user")}
```

When this service task is reached the assignee will be set.

<figure><img src="https://beta.docs-v2.valtimo.nl/~gitbook/image?url=https%3A%2F%2F217214225-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FbcArISKZtxWk4tKpZb9P%252Fuploads%252Fgit-blob-cb874bd5d70b9917bf09cf156c90f70ca5515715%252Fassign-user-in-process.png%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=44bc2eae&#x26;sv=2" alt=""><figcaption><p>Assign user in process</p></figcaption></figure>

Unassigning the case inside a process can be done by using the following expression:

```spel
${documentDelegate.unassign(execution)}
```

{% endtab %}

{% tab title="Via IDE" %}
The endpoint `POST /api/document/{documentId}/assign` makes it possible to assign a case handler by using code. To do this a user ID needs to be provided in the request body:

```json
{
  "assigneeId": "some UUID"
} 
```

To unassign, the endpoint `POST /api/document/{documentId}/unassign` can be used.
{% endtab %}
{% endtabs %}

## Automatic task assignment

{% hint style="success" %}
Available since Valtimo `10.7.0`
{% endhint %}

It is possible to have user tasks be automatically assigned to a case assignee making the tasks in a case appear under the case assignee's task list.

### Functionality

* This feature causes user tasks (existing and new) to be assigned to the current case assignee if there is one assigned.
* Upon the (re-)assignment of a case all user tasks from all processes currently using the same business key will have their assignee updated to match the new case assignee.
* Removal of an assignee from the case will also clear the assignee on all assigned user tasks withing all processes using the same business key.

{% tabs %}
{% tab title="Via UI" %}
Automatic task assignment can be enabled when the case is configured to have a case handler. Once the case handler option is selected, the second checkbox will appear that configures if all user tasks in the processes that support the case should automatically be assigned to the case handler.

<figure><img src="https://290147654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG2PoMeT8OSmMoaW7kF6t%2Fuploads%2Fgit-blob-4e98b510fb038a492617552df363aea9d9964423%2Fimage%20(31)%20(1).png?alt=media" alt=""><figcaption><p>Case specific configuration</p></figcaption></figure>
{% endtab %}

{% tab title="Via IDE" %}
`autoAssignTasks` can only be set to true when `canHaveAssignee` is true.

```json
{
    "canHaveAssignee": true,
    "autoAssignTasks": true
}
```

Any value not present in the json file will not be loaded and will instead use the default value (`false`). Auto-deployed case configuration settings are validated against unsupported properties or invalid values.
{% endtab %}
{% endtabs %}

### Limitations

* Only tasks that the user has access to (user has the required role) are assigned to the case assignee.
* Tasks already loaded on a dossier detail page do not automatically show the new assignment. A component reload (switching tabs or reload the page) is required to see the up-to-date assignee in the task modal.