Kategorie plików¶
W zadaniu 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":
Aby ustawienia były widoczne należy posiadać uprawnienie ROLE_CAN_ACCESS_FILE_CATEGORY_SETTINGS:

Po przejściu na stronę konfiguracji pojawi się tabela:

- Prefix - odpowiada za prefix, który zostanie dodany do nazwy pliku
- Kategoria - odpowiada za nazwę kategorii
- Idx - index kategorii
- Zlecenie transportowe - checkbox, który określa kategorie, do której ma zostać przypisany automatycznie generowany plik zlecenia transportowego
- Cmr - checkbox, który określa kategorie, do której ma zostać przypisany automatycznie generowany plik cmr
- 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:

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ą:

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
Ostatnia zmiana: 2025-12-08 · olkusz
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e