Notatki

Ilustracja 1. Zakładka "Notatki"

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, tak jak pozostałe zakładki sprawy — jako wpis processTabV1 typu notes:

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. 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".