Definicje formularzy

Definicje formularzy to najbardziej rozbudowany słownik w module Ustawienia — buduje się w nim treść kontroli HACCP: z jakich sekcji i pól się składa, jakie pomiary zawiera, jakie ma tolerancje. Każdy rodzaj kontroli (katalogowany w module HACCP → Katalog rodzajów kontroli) może mieć przypisany jeden lub więcej wersjonowanych formularzy — tylko jedna wersja jest w danym momencie opublikowana i obowiązująca.

Ekran działa na dwóch poziomach:

  1. Lista formularzy (nagłówki: nazwa, wersja, status, okres obowiązywania).
  2. Struktura formularza (ekran „Sekcje”): sekcje i pola wewnątrz jednej, konkretnej wersji formularza.

1. Lista formularzy

Definicje formularzy – lista

Tabela zawiera kolumny:

KolumnaOpis
KategoriaKategoria rodzaju kontroli, do której należy formularz (np. „Pozostałe”).
Rodzaj kontroliNazwa rodzaju kontroli HACCP, do którego przypisany jest formularz.
FormularzNazwa formularza oraz — pod spodem — jego opis.
WersjaNumer wersji dla formularzy opublikowanych; dla wersji roboczej (jeszcze niepublikowanej) wyświetlane jest słowo „robocza”.
ObowiązujeZakres dat obowiązywania, np. „01.01.2026 - bez terminu”.
StatusW edycji / Opublikowany / Anulowany.
AkcjeZestaw ikon opisany w tabeli poniżej — dostępność każdej z nich zależy od statusu wiersza.

Nad tabelą: pole „Szukaj” (filtruje po nazwie formularza lub rodzaju kontroli), filtr „Status”, przycisk „NOWY”.

Akcje na liście i ich dostępność

AkcjaIkonaKiedy dostępnaEfekt
Sekcje📄zawszeOtwiera ekran struktury formularza (sekcje i pola) — patrz rozdział 2. Dla wersji nieaktywnych (Opublikowany/Anulowany) ekran działa jako podgląd — bez możliwości edycji struktury.
Edytuj✏️tylko W edycjiPozwala poprawić nazwę, daty obowiązywania i opis nagłówka formularza.
KlonujzawszeTworzy nową wersję roboczą formularza — kopiuje całą strukturę (sekcje i pola) z klonowanej wersji jako punkt wyjścia do dalszych zmian.
Publikujtylko W edycjiPo potwierdzeniu nadaje formularzowi kolejny numer wersji i zmienia status na Opublikowany. Od tego momentu struktura jest zablokowana do edycji.
Anulujtylko dla najnowszej opublikowanej wersjiWycofuje formularz z użycia (status Anulowany) — bez usuwania historii wyników już zarejestrowanych na jego podstawie.
Usuń🗑️tylko W edycjiTrwale usuwa wersję roboczą wraz z jej sekcjami i polami.

Dodawanie nowego formularza

Kliknięcie „NOWY” otwiera dialog nagłówka formularza:

Dialog nowego formularza

PoleTypOpis
Rodzaj kontroliautouzupełnianie, wymaganeWybór z katalogu rodzajów kontroli HACCP — po wyborze pole Nazwa podpowiada się automatycznie na podstawie nazwy rodzaju kontroli.
Nazwatekst, wymaganaNazwa formularza — domyślnie taka sama jak rodzaj kontroli, można ją zmienić.
Obowiązuje oddata, wymaganaData, od której formularz (po opublikowaniu) będzie obowiązujący.
Obowiązuje dodata, opcjonalnaData końca obowiązywania — puste pole oznacza „bez terminu”.
Opistekst, opcjonalnyKrótki opis przeznaczenia formularza.

Zapis tworzy formularz w statusie W edycji, bez żadnych sekcji ani pól — kolejnym krokiem jest przejście do ekranu Sekcje, ponieważ bez co najmniej jednej sekcji i jednego pola formularza nie da się sensownie opublikować.

Przykład z systemu

KategoriaRodzaj kontroliFormularzWersjaObowiązujeStatus
PozostałeKontrola parametrów MAPKontrola parametrów MAP — „Przykładowa definicja formularza z polami pomiarowymi.”101.01.2026 – bez terminuOpublikowany

2. Struktura formularza (ekran „Sekcje”)

Otwierany ikoną Sekcje z listy. Nagłówek ekranu pokazuje nazwę, wersję i status edytowanego formularza (np. „Kontrola parametrów MAP, wersja robocza, status: W edycji”) oraz przycisk „Podgląd formularza” (symulacja ekranu telefonu z realnym renderowaniem pól — przydatna do sprawdzenia, jak formularz zobaczy operator, zanim zostanie opublikowany).

⚠️ Edycja struktury (dodawanie/zmiana/usuwanie sekcji i pól) jest możliwa wyłącznie dla formularza w statusie W edycji. Dla pozostałych statusów ekran wyświetla komunikat ostrzegawczy i działa wyłącznie jako podgląd „w skostniałym stanie” — co jest celowe: nie da się modyfikować struktury formularza, który jest już opublikowany i mógł zostać wykorzystany do rejestrowania rzeczywistych wyników.

Struktura formularza – edycja

Sekcje

Przycisk „Dodaj sekcję” (przy nagłówku „Struktura”) otwiera dialog:

PoleTypOpis
Nazwa sekcjitekst, wymaganaNazwa grupy pól (np. „Parametry opakowania MAP”).
Opistekst, opcjonalnyDodatkowy opis sekcji.
Sekcja powtarzalnaprzełącznikWłączenie pozwala operatorowi wypełnić sekcję wielokrotnie w ramach jednego wykonania kontroli (np. dla kilku pobranych próbek).
Tryb powtarzania (widoczny gdy „Sekcja powtarzalna” włączona)lista rozwijanaStała liczba — sekcja powtarza się zawsze dokładnie tyle samo razy (pole „Liczba powtórzeń”). Operator dodaje — operator sam decyduje, ile razy wypełnić sekcję, w granicach pól „Minimum”/„Maksimum”.
Minimum / Maksimum (tryb „Operator dodaje”)liczba całkowitaDopuszczalny zakres liczby powtórzeń sekcji wypełnianych przez operatora.

Sekcje i pola wewnątrz nich można przesuwać strzałkami góra/dół (ikony „Przesuń sekcję/pole w górę/w dół”) oraz usuwać (ikona kosza „Usuń sekcję”/„Usuń pole”).

Przykład z systemu — sekcja „Parametry opakowania MAP”: powtarzalność Operator dodaje, Minimum 1, Maksimum 3, opis „Sekcja dla kolejnych próbek opakowań.” — czyli operator rejestruje od 1 do 3 próbek opakowania w ramach jednego wykonania kontroli.

Pola formularza

Wewnątrz rozwiniętej sekcji przycisk „DODAJ POLE” otwiera dialog „Nowe pole”:

PoleTypOpis
Metrykalookup, opcjonalnyWybór metryki ze słownika Metryk. Wybranie metryki automatycznie uzupełnia poniższe pola Kod, Nazwa, Typ wartości i Jednostka wartościami z metryki (można je potem ręcznie doprecyzować). Pole formularza nie musi być powiązane z metryką — wtedy nie pojawi się na wykresach trendu, ale wciąż działa jako zwykłe pole formularza.
Kodtekst, wymaganyTechniczny identyfikator pola w ramach formularza.
Nazwatekst, wymaganaEtykieta pola widoczna dla operatora wypełniającego kontrolę.
Typ polalista rozwijana, domyślnie PomiarPomiar — pole z wartością mierzalną/oceniającą. Pytanie — pole typu tak/nie lub wyboru bez charakteru pomiarowego. Informacja — pole czysto opisowe, nieprzeznaczone do analizy.
Typ wartościlista rozwijana, domyślnie LiczbaLiczba / Tekst / Tak/Nie / Wybór jednej / Wybór wiele / Data — analogicznie jak w metrykach.
JednostkatekstJednostka miary wyświetlana przy polu (np. °C, %).
WymaganeprzełącznikCzy operator musi wypełnić to pole, aby zapisać wykonanie kontroli.
Miejsca po przecinku (typ Liczba)liczba całkowitaWyłącznie formatowanie renderowanej wartości liczbowej (np. 2 → wyświetlanie z dokładnością do setnych).
Opistekst, opcjonalnyDodatkowy opis/instrukcja dla operatora.

⚠️ Ważna różnica względem Metryk: dialog pola formularza nie zawiera pól „Wartość nominalna”, „Tolerancja -/+” ani „Minimum/Maksimum” — te ustawienia należą wyłącznie do metryki powiązanej z polem. Jeśli chcesz, aby pole miało zdefiniowaną tolerancję widoczną potem na wykresie trendu, ustaw ją raz na poziomie metryki, a nie na poziomie pola. Pole formularza kontroluje jedynie sposób wyświetlania wartości („Miejsca po przecinku”) oraz to, czy wypełnienie jest wymagane.

Przykład z systemu — formularz „Kontrola parametrów MAP” zawiera w sekcji „Parametry opakowania MAP” sześć pól, każde powiązane z metryką o tym samym przeznaczeniu:

Pole (nazwa)Powiązana metrykaTyp wartości
Bieg pracy maszynyBIEG_MASZYNYWybór jednej
Temperatura z miernikaTEMP_MASZYNYLiczba
Zawartość O2MAP_O2Liczba
Zawartość CO2MAP_CO2Liczba
Opakowanie prawidłoweOPAKOWANIE_OKTak/Nie
Uwagi operatoraUWAGI_OPERATORATekst

Podgląd formularza

Przycisk „Podgląd formularza” (dostępny niezależnie od statusu) otwiera symulację ekranu telefonu z realnym renderowaniem wszystkich sekcji i pól — pozwala sprawdzić układ i kolejność pól z perspektywy operatora, zanim (lub już po tym, jak) formularz zostanie opublikowany.

Typowy scenariusz konfiguracji

  1. Upewnij się, że rodzaj kontroli (katalog HACCP), metryki i punkty kontrolne, których dotyczy formularz, już istnieją.
  2. Utwórz nowy formularz, wskazując rodzaj kontroli — nazwa podpowie się automatycznie.
  3. Przejdź do ekranu „Sekcje” i dodaj co najmniej jedną sekcję.
  4. W sekcji dodaj pola, w miarę możliwości powiązane z metrykami ze słownika — to one nadadzą polom tolerancję i umożliwią raportowanie trendu.
  5. Jeśli kontrola wymaga wielokrotnego pobrania próbek (np. kilka opakowań, kilka punktów pomiaru), oznacz sekcję jako powtarzalną i wybierz odpowiedni tryb.
  6. Sprawdź układ formularza przyciskiem „Podgląd formularza”.
  7. Wróć do listy i kliknij „Publikuj” — po potwierdzeniu formularz otrzymuje numer wersji i staje się dostępny do rejestrowania rzeczywistych wyników; jego struktura przestaje być edytowalna.
  8. Jeśli po czasie trzeba zmienić strukturę formularza, użyj „Klonuj” na opublikowanej wersji — powstanie nowa wersja robocza gotowa do modyfikacji, bez wpływu na wersję już w użyciu.