# Blokada potwierdzenia statusu związana z polami niestandardowymi

Platforma udostępnia możliwość włączenia blokady potwierdzenia określonego statusu ze względu na obligatoryjność danego pola niestandardowego.

## Włączenie blokady

W celu włączenia blokady należy (będąc zalogowanym na konto z dostępem do ustawień systemu) przejść do edycji pola niestandardowego:

- zakładka `Ustawienia`
- `Ustawienia typów transportu` - wybór konkretnego typu transportu
- `Ustawienia pól`
- wciśnięcie klawisza `Edytuj` przy wybranym polu niestandardowym

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/checkpoint-blockade/customFieldEdit.png>)

W widoku edycji pola niestandardowego należy zaznaczyć opcję `Wymagane`, po zaznaczeniu tej opcji system udostępni możliwość wybrania statusu, który chcemy zablokować za względu na obligatoryjność edytowanego pola niestandardowego (pole `Pole wymagane podczas oraz po potwierdzaniu etapu:`):

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/checkpoint-blockade/customFieldTask.png>)

> Nie wybranie żadnego statusu w polu `Pole wymagane podczas oraz po potwierdzaniu etapu:` spowoduje obligatoryjność edytowanego pola niestandardowego w formularzu transportu przez cały okres trwania transportu. Nie spowoduje to jednak żadnej blokady potwierdzania statusu.
>
> Po zaznaczeniu pola „Wymagane” w polu nieuzależnionym od innego pola należy wybrać przynajmniej jedną z opcji:  
> \- Pole wymagane podczas oraz po potwierdzaniu etapu - Widoczne podczas tworzenia zlecenia

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/checkpoint-blockade/obligatoryValidation.png>)

## Wyłączenie blokady

W celu wyłączenia blokady należy (w zależności od potrzeb) wykonać jedną z poniższych akcji:

- odznaczyć pole `Wymagane` jeśli chcemy wyłączyć całkowicie obligatoryjność edytowanego pola niestandardowego (zarówno blokadę potwierdzenia statusu jak i obligatoryjność w formularzu transportu)

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/checkpoint-blockade/customFieldNotObligatory.png>)

- kliknąć krzyżyk po prawej stronie od wybranego statusu w polu `Pole wymagane podczas oraz po potwierdzaniu etapu:` aby ustawić obligatoryjność pola na `Niezależne od etapu` - (obligatoryjność w formularzu transportu przez cały okres trwania transportu)

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/checkpoint-blockade/customFieldNoTask.png>)

## Działanie funkcjonalności

### Blokada potwierdzania statusu

Ustawienie obligatoryjności pola niestandardowego oraz wybranie statusu w polu `Pole wymagane podczas oraz po potwierdzaniu etapu:` spowoduje blokadę potwierdzenia wybranego statusu dla każdej roli w systemie (do czasu wypełnienia wymaganych pól).

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/checkpoint-blockade/customFieldExample01.png>)

W momencie, gdy wybrane pole pozostanie nieuzupełnione w formularzu transportu:

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/checkpoint-blockade/customFieldExample02.png>)

nie będzie istniała możliwość potwierdzenia wybranego statusu do momentu uzupełnienia pola niestandardowego, w momencie kliknięcia `Potwierdź` wyświetli się formularz z wymaganymi polami. W formularzu obowiązują analogiczne zasady jak w formularzu transportu, tj. obowiązuje walidacja na pola niestandardowe, pojawiają się pola zależne, jeśli zostanie wybrany odpowiedni warunek w polu rodzica itp.:

> Formularz z wymaganymi przy potwierdzeniu polami niestandardowymi pojawi się zarówno po kliknięciu `Potwierdź` w okienku ze statusami, klawisza ochrony, jak i klawisza `Potwierdź` w formularzu transportu.

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/checkpoint-blockade/customFieldExample03.png>)

Po wypełnieniu wymaganych danych oraz kliknięciu klawisza `Potwierdź` transport zostanie zapisany a status potwierdzony.

### Blokada odrzucania statusu

Odrzucanie statusu: [dokumentacja](<https://docs.logintegra.com/apollo-backend/1. Transports/process/checkpoints/index.md>)

Analogicznie do blokady potwierdzania statusu działa blokada odrzucania statusu.  
W momencie, gdy istnieją pola niestandardowe powiązane ze statusem, który odrzucamy (i są one niewypełnione) pojawi się formularz z tymi polami oraz klawiszem `Odrzuć`.

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/checkpoint-blockade/customFieldExample04.png>)

Po wypełnieniu wymaganych danych oraz kliknięciu klawisza `Odrzuć` transport zostanie zapisany a status odrzucony.

### Walidacja pola w formularzu transportu

#### Ustawienie na wybrany status

##### Stan przed potwierdzeniem wybranego statusu:

Przed potwierdzeniem wybranego statusu będzie istniała możliwość zapisania formularza transportu niezależnie od ustawień obligatoryjności pola niestandardowego. Oznacza to, że pole nie będzie musiało być wypełnione i walidacja nie będzie blokować zapisania transportu.

##### Stan po potwierdzaniu wybranego statusu:

Po potwierdzeniu wybranego statusu będzie obowiązywać walidacja na pole, w którym status został wybrany np.:

- ustawienie pola `Spełnienie warunków sanitarno-technicznych`:

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/checkpoint-blockade/customFieldExample11.png>)

Po wypełnieniu omawianego pola oraz potwierdzeniu ustalonego statusu (tutaj `Rozpoczęcie rozładunku`):

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/checkpoint-blockade/customFieldExample12.png>)

obowiązywać będzie (do końca czasu trwania transportu) walidacja na to pole przy próbie zapisania transportu:

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/checkpoint-blockade/customFieldExample13.png>)

#### Ustawienie `Niezależne od etapu`

Ustawienie `Niezależne od etapu` powoduje włączenie walidacji niezależnie od stanu, w którym znajduje się transport.

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/checkpoint-blockade/customFieldExample21.png>)

Oznacza to, że pole z takim ustawieniem będzie wymagane już w momencie próby utworzenia zlecenia oraz przez cały okres czasu trwania transportu:

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/checkpoint-blockade/customFieldExample22.png>)
