# Lista spraw

## Konfiguracja widoczności spraw na liście spraw

Aby sprawa były widoczne na liście, należy skonfigurować uprawnienia dla roli [użytkownika](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/konfiguracja/uprawnienia) (Parametr PROCESS\_DEFINITION\_KEY\_MAPPING).

Za widoczność spraw na liście odpowiada dodatkowo mechanizm: Dynamicznego definiowania dostępu do listy spraw (setAccessGroups).

{% hint style="warning" %}
Mechanizm ten nadaje jedynie \*\*dodatkowe\*\* uprawnienia. Funkcjonalność nie pozwala na usunięcie uprawnień do spraw nadanych poprzez PROCESS\_DEFINITION\_KEY\_MAPPING.
{% endhint %}

## Konfiguracja etykiety sprawy

Istnieje możliwość konfiguracji etykiety dla sprawy w lewej części kafelka na stronie Eximee Dashboard znajdującej się np. pod adresem:

```
ROUTER_HOST:8083/router-ui/#/processes
```

W celu skonfigurowania etykiety, należy w procesie bpmn utworzyć nowe zadanie o typie *ScriptTask* i podpiąć je do procesu:

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2Fgit-blob-bc7b36abbf1b277967560fa39b1e4544461e9f1a%2F1-Konfiguracja-zadania%20-ScriptTask.png?alt=media" alt=""><figcaption><p>Ilustracja 1. Konfiguracja zadania "ScriptTask"</p></figcaption></figure>

W konfiguracji [zadania skryptowego](https://docs.eximee.com/budowanie-aplikacji/proces-biznesowy/zadania-automatyczne/zadanie-skryptowe-bpms-scripttask) należy ustawić:

* **Script Format**: groovy
* **Script Type**: Inline Script
* **eScript**: Tutaj kod w języku groovy, który ustawi w zmiennej **PROCESS\_DASHBOARD\_DESCRIPTION** wartość etykiety o typie tekstowym, np.

```
execution.setVariable("PROCESS_DASHBOARD_DESCRIPTION", "Wniosek o kredyt walutowy");
```

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2Fgit-blob-3b7715df7a343038339878ced5767ed198fc6c77%2F2-Lista-spraw.png?alt=media" alt=""><figcaption><p>Ilustracja 2. Lista spraw</p></figcaption></figure>

Gdy proces jest ukończony (ma status *COMPLETED*), wyświetlany jest tekst: *Sprawa zakończona*.

Gdy proces nie jest ukończony i nie ma uzupełnionej zmiennej **PROCESS\_DASHBOARD\_DESCRIPTION** to nie wyświetlamy etykiety.

W pozostałych przypadkach wyświetlamy tekst wskazany w **PROCESS\_DASHBOARD\_DESCRIPTION**, w przykładzie jest to "Rozpoczęcie procesu" oraz "Formularz".

## Konfiguracja wyświetlania danych

Istnieje możliwość konfiguracji wyświetlanych danych w środkowej części kafelka na stronie Eximee Dashboard znajdującej się np. pod adresem:

```
ROUTER_HOST:8083/router-ui/#/processes
```

W celu skonfigurowania jakie dane chcemy wyświetlać w środkowej części kafelka, należy w procesie bpmn utworzyć nowe zadanie o typie *ScriptTask* i podpiąć je do procesu:

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2Fgit-blob-f153a8a7563c0cca7f80e6e387fd50f4a9d06114%2F3-Konfiguracja-zadania%20-ScriptTask.png?alt=media" alt=""><figcaption><p>Ilustracja 3. Konfiguracja zadania "ScriptTask"</p></figcaption></figure>

W konfiguracji [zadania skryptowego](https://docs.eximee.com/budowanie-aplikacji/proces-biznesowy/zadania-automatyczne/zadanie-skryptowe-bpms-scripttask) należy ustawić:

* **Script Format**: groovy
* **Script Type**: Inline Script
* **Script**: Tutaj kod w języku groovy, który ustawi w zmiennej **PROCESS\_DASHBOARD** mapę konfiguracyjną prawej strony kafelka.

Możemy dodać konfigurację w formie etykieta-wartość, które będą wyświetlane na liście spraw w Eximee Dashboard.

Należy pamiętać, że wartości w kluczu muszą być unikalne.

Do wartości mapy można przekazywać literały lub zmienne procesu za pomocą:

```
execution.getVariable("NAZWA_ZMIENNEJ");
```

Przykładowy kod uzupełniający konfiguracje:

```js
execution.setVariable("PROCESS_DASHBOARD", [
"Etykieta1": "Wartość1",
"Etykieta2": execution.getVariable("zmienna1")
]);
```

Możemy także określić kolejność wyświetlanych zmiennych, podając na początku klucza numer w nawiasach kwadratowych, na podstawie którego zmienne zostaną posortowane, np. "\[1]Etykieta". Numer taki nie zostanie wyświetlony, a zmienne bez numeru trafią na sam koniec. Przykładowo mapa:

```js
execution.setVariable("PROCESS_DASHBOARD", [
 "[3]A": "A",
 "B": "B",
 "[1]C": "C"
]);
```

zostanie wyświetlona jako pary klucz-wartość w kolejności etykiet C, A, B.