Przejdź do treści

Strona może być nieaktualna

Nikt jej nie zmieniał od 16 miesięcy (ostatni commit: 2025-07-01, Marlena Żarczyńska). Jeśli opisuje stan, którego już nie ma, zgłoś ją jako nieaktualną.

Zlecenie transportowe

Zlecenie transportowe jest dokumentem PDF, który generowany jest po utworzeniu lub aktualizacja transportu. Dokument zawiera wszystkie podstawowe informacje dotyczące transportu: - Numer transportu (domyślnie internal_index, ale może być też erp_identifier lub alt_identifier – patrz sekcja Ustawienia) - Termin załadunku - Miejsca załadunku - Termin rozładunku - Miejsca rozładunku - Fracht (z sufixem pobieranym z ustawień) - Ilość towaru - Waga - Wybrane custom fieldy (pobierane z ustawień) - Uwagi z transportu - Dodatkowe uwagi z transportu

Mapowanie danych

Informacje wyświetlane na dokumencie mapowane są na podstawie poniższej grafiki:

transport_order_mapping.png

Ustawienia

Ustawienia dotyczące dokumentu zlecenia transportowego znajdują się w zakładce Ustawienia -> Ustawienia typu transportu -> Ustawienia zlecenia transportowego

transport_order_settings.png

  1. Stały tekst dopisywany przy frachcie - określa sufix dodawany do pola Fracht na dokumencie.
  2. W przypadku zakresu czasu w stepie wyświetlaj tylko datę i godzinę początku zakresu - Określa, czy data załadunku/rozładunku powinna wyświetlać zakres "od-do" czy tylko datę "od".
  3. Określa, czy dla transportów w typie transportu powinien zostać wygenerowany dokument zlecenia transportowego - Określa, czy dokument zlecenia transportowego powinien być generowany dla typu transportu, którego dotyczą ustawienia.
  4. Wybrane custom-fieldy będą wyświetlane w dokumencie zlecenia transportowego (Wpisz nazwy cfów po przecinku) - Określa, jakie custom fieldy powinny być generowane na dokumencie, nazwy cfów powinny być wpisywane po przecinku bez spacji.
  5. Identyfikator do numerowania dokumentu - pozwala wybrać, po którym identyfikatorze dokument Zlecenie transportowe będzie numerowany. Dostępne opcje:

    • internalIndex zlecenia domyślna opcja
    • erpIdentifier
    • altIdentifier

Generowanie dokumentu

Za generowanie dokumentu odpowiedzialna jest metoda TransportOrderDocumentService#generateGenericTransportOrderDocument, jest ona wywoływana podczas zapisu transportu w TransportService#saveTransport oraz podczas aktualizacji transportu w TransportService#updateTransport.

Podczas aktualizacji transportu sprawdzamy, czy plik o tej samej nazwie już istnieje, jeśli tak to go usuwamy i zastępujemy nowo wygenerowanym dokumentem:

        IPdfDocument doc = new GenericTransportOrderDocument(gtom)
        File oldFile = File.findByNameAndTransport(doc.fileName, transport)
        if (oldFile) {
            transportFileService.deleteFile(oldFile, transport.principalCompany)
        }

Dane potrzebne do wygenerowania dokumentu gromadzone są w klasie GenericTransportOrderModel, mapowanie danych odbywa się w klasie GenericTransportOrderModelBuilder. Po utworzeniu model przekazywany jest do klasy GenericTransportOrderDocument, w której dane mapowane są do odpowiednich tabeli dokumentu PDF.

Wartość używana do numeracji dokumentu jest wybierana zgodnie z ustawieniem documentIdentifier:

private String getSelectedIdentifier() {
   String identifierTypeString = transportOrderSettings?.documentIdentifier ?: TransportOrderSettings.DocumentIdentifierType.INTERNAL_INDEX.name()
   ...
    switch (identifierType) {
        case ERP_IDENTIFIER:
            selectedIdentifier = transport?.erpIdentifier
            break
        case ALT_IDENTIFIER:
            selectedIdentifier = transport?.altIdentifier
            break
        case INTERNAL_INDEX:
        default:
            selectedIdentifier = transport?.internalIndex
            break
        }
        return selectedIdentifier ?: ""
   }
Plik zapisuje się pod nazwą zgodną z wybranym identyfikatorem:

private void setFileName() {
    genericTransportOrderModel.fileName = fileNamePrefix + getSelectedIdentifier()
}

private void setDocumentTitle() {
    this.genericTransportOrderModel.documentTitle = documentTitle + getSelectedIdentifier()
}

Logo pryncypała pobierane jest z dysku google, w klasie GenericTransportOrderModelBuilder podawana jest stała wartość ścieżki logo pryncypała np.: private final static String logoPath = "resources/images/pelletenergy/pelletenergyLogo.png".

Po pomyślnym wygenerowaniu dokumentu zlecenia transportowego plik zapisywany jest na dysku google (lub serwerze ftp, w zależności od pryncypała) w folderze, którego nazwa to id transportu. Nazwa pliku określana jest w klasie GenericTransportOrderModelBuilder, prefix nazwy dokumentu ustalany jest w stałej fileNamePrefix: private final static String fileNamePrefix = "Zlecenie_transportowe_", następnie prefix dodawany jest do internal_index transportu w metodzie setFileName:

    private void setFileName() {
        this.genericTransportOrderModel.fileName = fileNamePrefix + transport?.internalIndex
    }

Pobieranie dokumentu

Wygenerowany dokument zlecenia transportowego można pobrać w sekcji dokumenty w szczegółach transportu:

transport_detalis_document_section.png

lub w kolumnie dokumentu z tabeli transportu: document_section.png

Ostatnia zmiana: 2025-07-01 · Marlena Żarczyńska
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e