> For the complete documentation index, see [llms.txt](https://docs.eximee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/konfiguracja/notatki.md).

# Notatki

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2Fgit-blob-dfd8899fbf733561f656e0f58748964a8a800ba9%2F5-Zak%C5%82adka-Notatki.png?alt=media" alt=""><figcaption><p>Ilustracja 1. Zakładka "Notatki"</p></figcaption></figure>

Zakładka `Notatki` prezentuje listę notatek przypisanych do sprawy, uporządkowanych od najnowszej. Każda pozycja listy zawiera treść notatki, imię i nazwisko autora oraz datę utworzenia. Po wybraniu notatki jej pełna treść pojawia się w panelu obok. Jeśli w sprawie nie ma jeszcze notatek, na liście widnieje komunikat `Brak notatek`, a w panelu można od razu przygotować nową notatkę.

## Dodanie zakładki do aplikacji

Zakładka notatek deklarowana jest w skrypcie [konfiguracji ekranów aplikacji](/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/konfiguracja/konfiguracja-ekranow-aplikacji.md), tak jak pozostałe zakładki sprawy — jako wpis `processTabV1` typu `notes`:

```javascript
function call() {
    return processConfigV1()
        .tab(
            processTabV1("zakladka-notatki", "Notatki", "notes", "feature_browse_notes")
        );
}
```

Argumenty istotne dla tej zakładki:

| Argument     | Znaczenie                                                                                                                                                            |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`         | Identyfikator zakładki używany w adresie widoku sprawy, np. `HOST:PORT/#/process/{idSprawy}/zakladka-notatki`. Musi być unikalny w danej konfiguracji.               |
| `type`       | Musi mieć wartość notes, aby Eximee Dashboard wyświetliło komponent notatek.                                                                                         |
| `permission` | Musi mieć wartość `feature_browse_notes`. W przeciwnym wypadku zakładkę zobaczy każdy pracownik mający dostęp do sprawy, również bez uprawnienia do odczytu notatek. |

Konfiguracja ekranów jest przypisana do konkretnej aplikacji. Aby udostępnić notatki w innych aplikacjach, należy dodać zakładkę w konfiguracji każdej z nich.

## Uprawnienia

Dostęp do notatek kontrolują cztery uprawnienia z listy [Uprawnienia](/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/konfiguracja/uprawnienia.md). Przydzielane są tak samo, jak pozostałe uprawnienia Eximee Dashboard - poprzez mapowanie ról w parametrze `AUTH_ROLE_MAPPING`.

| Uprawnienie            | Możliwa akcja                                   |
| ---------------------- | ----------------------------------------------- |
| `feature_browse_notes` | Odczyt notatek sprawy.                          |
| `feature_add_notes`    | Dodanie i zapisanie nowej notatki.              |
| `feature_modify_notes` | Edycja i zapisanie zmian w istniejącej notatce. |
| `feature_delete_notes` | Usunięcie notatki.                              |

Nadając uprawnienia, należy uwzględnić dwie różnice w ich działaniu:

* `Usuwanie`: przycisk usunięcia jest widoczny tylko dla autora notatki. Ograniczenie to wynika z działania interfejsu, a nie z samego uprawnienia `feature_delete_notes`.
* `Edycja`: użytkownik z uprawnieniem `feature_modify_notes` może edytować również cudze notatki. Po zapisaniu zmian autor, data utworzenia i powiązanie ze sprawą pozostają bez zmian; aktualizowana jest data ostatniej modyfikacji.

## Ograniczenia

* Notatka może zawierać wyłącznie zwykły tekst bez formatowania, załączników i obrazów.
* Notatki są dostępne po otwarciu sprawy. Nie można ich wyszukać z poziomu listy spraw ani listy zadań.
* Notatka jest przypisana do sprawy, a nie do zadania lub kroku procesu.
* Dodanie, edycja i usunięcie notatki nie emitują zdarzeń procesowych ani nie wpływają na przebieg procesu.

## Wymagania środowiskowe

Do działania zakładki potrzebny jest moduł notatek: w Eximee Dashboard musi być skonfigurowane źródło danych notatek (`eximee.notes.*`), a w bazie musi być wykonana migracja schematu notatek. Bez tej konfiguracji zakładka może się pojawić, ale próba odczytu lub zapisu notatek zakończy się błędem.

## Najczęstsze problemy

| Objaw                                                       | Najczęstsza przyczyna                                                                                                  |
| ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Zakładka nie pojawia się, choć sprawa otwiera się normalnie | Pracownik nie ma `feature_browse_notes`, albo skrypt konfiguracji tej konkretnej aplikacji nie deklaruje zakładki.     |
| Zakładki nie widać w jednej aplikacji, choć działa w innej. | Konfiguracja ekranu jest przypisana do aplikacji - brakuje wpisu w skrypcie tej aplikacji.                             |
| Po nadaniu uprawnienia zakładka nadal jest niewidoczna.     | Uprawnienia są pobierane podczas logowania. Należy wylogować i zalogować się ponownie.                                 |
| Zakładka jest widoczna, ale nie ma przycisku zapisu.        | Brak `feature_add_notes` (i ewentualnie `feature_modify_notes`). Samo `feature_browse_notes` umożliwia jedynie odczyt. |
| Zakładka otwiera się, ale odczyt notatek zwraca błąd        | Moduł notatek nie jest w pełni skonfigurowany na tym środowisku — patrz „Wymagania środowiskowe".                      |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/konfiguracja/notatki.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.