# Kategorie plików

W zadaniu [A-15584](<https://youtrack.logintegra.com/issue/A-15584>) powstała funkcjonalność kategorii plików, pozwala ona na dodawanie kategorii do dokumentów załączanych do zlecenia.

## Konfiguracja

Konfiguracja samych kategorii odbywa się w ustawienia "Kategorie dokumentów": ![settings.png](<https://docs.logintegra.com/apollo-backend/static/file categories/settings.png>) Aby ustawienia były widoczne należy posiadać uprawnienie `ROLE_CAN_ACCESS_FILE_CATEGORY_SETTINGS`: ![authority.png](<https://docs.logintegra.com/apollo-backend/static/file categories/authority.png>)

Po przejściu na stronę konfiguracji pojawi się tabela: ![table.png](<https://docs.logintegra.com/apollo-backend/static/file categories/table.png>)

1. Prefix - odpowiada za prefix, który zostanie dodany do nazwy pliku
2. Kategoria - odpowiada za nazwę kategorii
3. Idx - index kategorii
4. Zlecenie transportowe - checkbox, który określa kategorie, do której ma zostać przypisany automatycznie generowany plik zlecenia transportowego
5. Cmr - checkbox, który określa kategorie, do której ma zostać przypisany automatycznie generowany plik cmr
6. Specyfikacje - checkbox, który określa kategorie, do której ma zostać przypisany automatycznie generowany plik ze specyfikacjami

punkty 4, 5 i 6 mogą być przypisane tylko do jednej kategorii, próba zaznaczenia checkboxa w dwóch kategoriach poskutkuje błędem walidacji na serwerze.

Aby moc dodać kategorię do pliku w zleceniu, typ transportu musi mieć włączoną flagę `requiresFileCategory` "Określa czy w procesie dodawani plików wymagamy dodania kategorii pliku.",

## Funkcjonalność

Przy próbie dodania pliku do zlecenia zostanie wyświetlony dialog:

![dialog.png](<https://docs.logintegra.com/apollo-backend/static/file categories/dialog.png>)

Przycisk `Dodaj plik` będzie wyłączony do momentu wybrania samej kategorii.

Po wyborze kategorii będzie można wybrać plik oraz go przesłać, po przesłaniu modal sam się zamknie, a na liście plików pojawi się plik z przypisaną kategorią:

![add\_file.png](<https://docs.logintegra.com/apollo-backend/static/file categories/add_file.png>)

## Sekwencja

Każda kategoria ma swoją sekwencję zaczynającą się od cyfry `1`. Sekwencje przechowywane są w tabeli `file_category_principal_sequence`

Każdy plik dodany do danej kategorii u danego pryncypała będzie zwiększał numer tej sekwencji o jeden.

Numer sekwencji dodawany jest na końcu nazwy przesyłanego pliku, ostateczna nazwa składana jest za pomocą takiego wzrou: `PREFIX_NAME_SEQUENCE-NUMBER` PREFIX = prefix zdefiniowany w kategorii NAME = oryginalna nazwa pliku przesłanego przez użytkownika SEQUENCE-NUMBER = numer sekwencji z tabeli `file_category_principal_sequence`
