### Edycja tasków

Za możliwość edycji obiektu `Task` odpowiada rola - `ROLE_EDIT_WORKFLOW`.  
Włącza ona widoczność przycisku edycji obiektu `Task` w typie transportu.  
Po kliknięciu klawisz edycji otworzy się formularz edycji obiektu `Task`.

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/editTaskButton.png>)

### Pola formularza

```
Nazwa etapu PL: checkpoint_name
Nazwa etapu ENG: checkpoint_name_en
Nazwa statusu przed potwierdzeniem etapu PL: stage_name
Nazwa statusu przed potwierdzeniem etapu ENG: stage_name_en
Etap powiązany z: association
Alias etapu: alias
Kolor statusu: color
Alternatywna nazwa etapu PL: alt_checkpoint_name
Alternatywna nazwa etapu ENG: alt_checkpoint_name_en
Alternatywny kolor: alt_checkpoint_color
Możliwość cofnięcia statusu: can_be_revoked
Możliwość odrzucenia etapu: can_be_rejected
Możliwość potwierdzenia po dodaniu dokumentów do transportu: can_be_confirm_after_adding_documents_for_transport
Automatyczne potwierdzenie statusu po dodaniu awuzacji: should_be_approved_with_advice
Automatyczne potwierdzenie statusu w momencie utworzenia zlecenia: should_be_saved_as_approved
Automatyczne potwierdzenie statusu po przydzieleniu przewoźnika: confirm_checkpoint_after_carrier_select
Etap związany z ważeniem: weighing_included
Warunek transakcji: transaction_condition
```

##### `Etap powiązany z` - wyjaśnienie

Pole decyduje o przynależności statusu do etapu w zależności od jego typu.

Możliwe opcje to:  
\- Magazynem i Kontrahentem  
\- Kontrahentem  
\- Magazynem

Jeżeli obiekt `Task` zostanie ustawiony jako etap powiązany jedynie z `Magazynem` to dla nowego transportu tego typu status rodzaju `Task` zostanie stworzony wyłącznie dla etapu w magazynie.

> Dodatkowo należy pamiętać o ustawieniu czy status rodzaju `Task` jest dla rozładunku czy załadunku

Przykład:

Ustawienie obiektu `Task` (Załadunek - Kontrahent):

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/exampleTask1.png>)

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/exampleTask2.png>)

Spowoduje, że nowy transport z następującymi etapami:

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/exampleTransport.png>)

stworzy się z następującymi statusami (statusy etapów tworzone są po dodaniu awizacji):

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/exampleCheckpoints.png>)

- statusy w ramce różowej — statusy z grupy `Prace przygotowawcze`
- statusy w ramce czerwonej — statusy z grupy `Załadunki i Rozładunki` - etap załadunkowy w magazynie
- statusy w ramce zielonej — statusy z grupy `Załadunki i Rozładunki` - etap załadunkowy u kontrahenta

Jak pokazano w powyższym przykładzie status `Testowy` utworzył się jedynie dla etapu typu `załadunek - kontrahent`.

> Dla etapu `Rozładunek` nie powstały statusy, ponieważ żaden nie obiekt `Task` nie był zdefiniowany jako `rozładunek`
>
> Należy pamiętać, że po dodaniu nowego obiektu `Task` trzeba nadać do niego uprawnienia:

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/exampleTasksPermissions.png>)

##### `Warunek transakcji` - wyjaśnienie

Pole decyduje, czy status z danego tasku zależy od zaakceptowanej transakcji w transporcie. Pole jest dostępne dla tasków we wszystkich grupach. Nowy task dostaje opcję `Bez warunku`.

| Opcja | Wartość w bazie | Kiedy status się generuje |
| --- | --- | --- |
| Bez warunku | `NONE` | Zawsze, transakcja nie ma wpływu na status. |
| Wymagana transakcja kurierska | `COURIER_TRANSACTION_REQUIRED` | Transport ma zaakceptowaną transakcję z firmą, która ma `company.is_courier = true`. |
| Wymagana transakcja niekurierska | `NON_COURIER_TRANSACTION_REQUIRED` | Transport ma zaakceptowaną transakcję z firmą, która ma `company.is_courier = false`. |

Transport ma najwyżej jedną aktywną transakcję. Statusy kurierskie i niekurierskie nie występują więc w transporcie jednocześnie.

Warunek transakcji działa niezależnie od ustawienia `GENERATE_CHECKPOINTS_WITHOUT_ADVICE`. Status powstaje tylko wtedy, gdy oba warunki są spełnione. Kolejność statusów i planowana data potwierdzenia wynikają z ustawień tasku.

Akceptacja, odrzucenie i anulowanie transakcji przeliczają statusy transportu. Kanał zmiany nie ma znaczenia: UI, API, import, aukcja i automatyczne przekazanie działają tak samo. Przeliczenie wykonuje `WorkflowService#recalculateCheckpointsIfTransactionDependent` w tym samym żądaniu co zmiana transakcji.

Przeliczenie działa według trzech zasad:

- niepotwierdzone statusy, które nie pasują do nowej transakcji, są usuwane z transportu,
- statusy z tasków pasujących do nowej transakcji są dodawane,
- potwierdzone statusy zostają bez zmian.

Przeliczenie pomija transport, którego typ nie ma tasku z warunkiem innym niż `Bez warunku`. Pomija też transporty zarchiwizowane, usunięte, zablokowane w planowaniu i transporty bez statusów.

Nowy status nie pojawi się, jeśli jego pozycja wypada przed ostatnim potwierdzonym statusem. Wyjątkiem jest status o nazwie, która już istnieje w transporcie. Tę regułę stosuje `CheckpointService#removeNewCheckpointsAddedBeforeFirstUnconfirmedCheckpoint`.

Przykład: transport ma zaakceptowaną transakcję z kurierem i statusy z tasków `Wymagana transakcja kurierska`. Użytkownik anuluje tę transakcję i przekazuje transport przewoźnikowi niekurierskiemu. Po akceptacji niepotwierdzone statusy kurierskie znikają z listy statusów. W ich miejsce powstają statusy z tasków `Wymagana transakcja niekurierska`.

### Akcje

`Wyłącz`: wyłącza obiekt `Task` dla nowych zleceń (nie będą tworzone statusy danego typu w nowych zleceniach)

### Walidacje

1. Kolor — możliwości — RGB, HEX, nazwy kolorów zdefiniowanych w CSS
