# Łączenie transportów

## Tabele powiązań oraz dodawanie nowego wiązania

Powiązania opierają się na 2 tabelach `transport_relation` - która opisuje rodzaj wiązania i typy transportów, między którymi wiązanie może zachodzić, oraz `transport_transport_relation` w której aplikacja zapisuje aktualne powiązania. Jako że w momencie pisania dokumentacji nie ma planu dodawania nowych wiązań ze strony GUI, jedyną możliwością dodania nowego typu powiązania jest zrobienie `INSERT` na tabeli `transport_relation`, przykładowe kwerendy dla obecnie dostępnych rodzajów powiązań:

```
--- Łączenie załadunków
INSERT INTO transport_relation (id,
                                subordinate_transport_type_id,
                                alias,
                                primary_transport_type_id,
                                class,
                                minutes_added_to_time_window_validation,
                                windows_combining,
                                advices_combining,
                                checkpoints_combining,
                                max_total_weight,
                                requires_the_same_warehouse_in_the_same_step_type)
VALUES (NEXTVAL('hibernate_sequence'), 268332786, 'TRANSPORT_COMBINING', 268332786,
        'logintegra.transportRelations.TransportRelationCombining', null, true, true, true, 10000, true)
```

```
--- Łączenie wahadeł i załadunków
INSERT INTO transport_relation (id,
                                subordinate_transport_type_id,
                                alias,
                                primary_transport_type_id,
                                class,
                                minutes_added_to_time_window_validation,
                                windows_combining,
                                advices_combining,
                                checkpoints_combining,
                                max_total_weight,
                                requires_the_same_warehouse_in_the_same_step_type)
VALUES (NEXTVAL('hibernate_sequence'), 268337219, 'TRANSPORT_COMBINING', 268332786,
        'logintegra.transportRelations.TransportRelationCombining', null, true, true, true, 10000, true)
```

```
--- Załadunek czeka na wahadło
INSERT INTO transport_relation (id,
                                subordinate_transport_type_id,
                                alias,
                                primary_transport_type_id,
                                class,
                                minutes_added_to_time_window_validation,
                                windows_combining,
                                advices_combining,
                                checkpoints_combining,
                                requires_the_same_warehouse_in_different_step_type)
VALUES (NEXTVAL('hibernate_sequence'), 268337219, 'HAS_TO_WAIT_FOR', 268332786,
        'logintegra.transportRelations.TransportRelationHasToWaitFor', null, null, null, null, true)
```

## Widoczność powiązań w Apollo

Powiązane ze sobą transporty są widoczne w systemie w nagłowku formularza transportu, numery transportów to odnosniki, którymi można przenosić się między formularzami:

![TRANSPORT\_COMBINING](<https://docs.logintegra.com/apollo-backend/static/Transports/special-features/transport-relations/transport-combining-header.png>) ![HAS\_TO\_WAIT\_FOR\_MASTER](<https://docs.logintegra.com/apollo-backend/static/Transports/special-features/transport-relations/has-to-wait-for-header-master.png>) ![HAS\_TO\_WAIT\_FOR\_RELATED](<https://docs.logintegra.com/apollo-backend/static/Transports/special-features/transport-relations/has-to-wait-for-header-related.png>)

Powiązania również widać w komunikacie PublicApi w węźle `relatedTo`:

```
REQUEST: GET /api/transports/$id
RESPONSE: {
(...)
"readyToPlan": true,
"relatedTo": [
{
"altIdentifier": "",
"dependencyType": "HAS_TO_WAIT_FOR",
"erpIdentifier": "WAH_2",
"id": "286172981"
},
{
"altIdentifier": "",
"dependencyType": "HAS_TO_WAIT_FOR",
"erpIdentifier": "WAH_1",
"id": "286172955"
},
{
"altIdentifier": "",
"dependencyType": "HAS_TO_WAIT_FOR",
"erpIdentifier": "WAH_3",
"id": "286173007"
}
],
(...)
}
```

Po dodaniu kolumny 'Numer powiązania' `TableColumn#TRANSPORT_RELATION`, powiązane transporty mają wspólny numer w tej kolumnie (jest to numer `Transport#internalIndex` transportu głównego). Można za jej pomocą wyszukiwać powiązane ze sobą transporty (na przykładzie poniżej połączono ZAL\_1 z ZAL\_3):

![Kolumna](<https://docs.logintegra.com/apollo-backend/static/Transports/special-features/transport-relations/transport-relation-column.png>)

## Rodzaje powiązań

1\) [Łączenie transportów](<https://docs.logintegra.com/apollo-backend/1. Transports/special-features/transport-combining/index.md>) - `TRANSPORT_COMBINING (TransportRelationCombining)` - pozwala na łączenie tych samych, lub róznych typów transportów, w zależności od konfiguracji flag w tabeli `transport_relation`, transporty mogą dzielić ze sobą statusy, awizacje oraz okno czasowe.

2\) [Transport czeka na](<https://docs.logintegra.com/apollo-backend/1. Transports/special-features/has-to-wait-for/index.md>) - `HAS_TO_WAIT_FOR (TransportRelationHasToWaitFor)` - pozwala na dodawanie relacji między transportami w których jeden transport, czeka na inne transporty. Do momentu dodania okien w transportach zależnym i oznaczeniu transportu głównego jako gotowy, transport główny nie może zostać zaawizowany.

## Rozłączanie transportów

Aby rozłączyć transporty, użytkownik musi mieć uprawnienie 'Usuwanie powiązania łączenia transportów' (`Authority#ROLE_CAN_DELETE_RELATION`). Przycisk dostępny jest w stopce formularza transportu (obok Zapisz, Anuluj itp.). Jeśli usuwamy powiązanie z poziomu formularza transportu zależnego, usuniemy z powiązania tylko ten jeden transport. Jeśli usuwamy z poziomu formularza transportu głównego, usuniemy powiązanie całkowicie (czyli z obecnie wybranego transportu i wszystich innych powiązanych z nim transportów).

Przy typie powiązania `TRANSPORT_COMBINING`, jeśli przed rozłączeniem do transportów dodane zostało już okno czasowe, po rozłączeniu okno będzie tylko w transporcie głownym.
