Lines

Line management: view, create, edit, edit directly and delete line connections with a fixed timetable.

The line management is used to maintain fixed line connections (e.g. rail or train connections with a fixed timetable). A line defines a recurring connection between two depots with fixed departure and arrival times, validity period and operating days. These lines are then available at other places in the system – for example in order and tour planning – as selectable connections.

Note: The line management is available exclusively to users with administrator permission (Superadmin or Admin).


1. Navigation

The line management is accessible via the main menu under Dispatching › Lines.


2. Line Overview (Table)

The overview shows all lines in a paginable, sortable and filterable table. Each row represents one line connection.

Default Columns

ColumnDescription
IdInternal identifier of the line
NameDesignation of the line
ActiveSwitches the line active/inactive (interactive checkbox)
GroupAssigned organisation group
DescriptionSupplementary description
Starting locationDeparture location (depot)
Departure timePlanned departure time
End locationDestination location (depot)
Arrival timePlanned arrival time
Plus date daysNumber of days by which the arrival is shifted after the departure (e.g. for arrival on the following day)
Tariff kilometersStored tariff kilometres of the line
Valid From / Valid UntilValidity period of the line
Train numberNumber of the train or connection
RefIdReference identifier of the line
Sunday to SaturdayOperating days of the line as checkboxes, starting with Sunday

The columns Departure time, Arrival time, Plus date days, Tariff kilometers, Valid From and Valid Until cannot be filtered.

Sorting and Pagination

Clicking a column header sorts the list in ascending or descending order. The table loads the data page by page from the server, so that even large line inventories are displayed with good performance.

Open Line

A double-click on a row opens the line in the editing dialog (see Section 4). Alternatively, select exactly one row and click Edit in the toolbar. A single click only selects the row.

Interactive Checkbox Cells

The Active column as well as the individual Weekdays are displayed as clickable checkboxes directly in the table rows. They can be toggled directly in the table (see Section 5).

Column Configuration

The displayed columns can be customised per user (show/hide, order). The configuration is saved user-specifically and is retained after logging out.


3. Group Filter

The page has no group selection of its own. It shows the lines of the group selected in the header bar of the application. If you switch the group there, the table is reloaded automatically.

  • A new line is created in the currently selected group.
  • An existing line keeps its group when edited.

4. Create and Edit Line

A new line can be created or an existing line edited via the toolbar. In both cases, a dialog opens with the title Add Line or Edit line.

Fields

The header of the dialog shows the name of the line, the RefId and the Train number as well as the Active checkbox. The other fields are organised in sections:

SectionFieldDescriptionRequired
HeaderActiveSet the line active (switched on for a new line)—
GeneralRefIdReference identifier of the line (max. 200 characters)Yes
GeneralNameDesignation of the line (max. 200 characters)Yes
GeneralTrain numberNumber of the connection (max. 200 characters)No
GeneralDescriptionFree text about the line (max. 300 characters)No
TimesStarting locationDeparture location, selected via autocomplete; only depots are offeredYes
TimesDeparture timePlanned departure time (default 00:00)Yes
TimesEnd locationDestination location, selected via autocomplete; only depots are offeredYes
TimesArrival timePlanned arrival time (default 00:00)Yes
TimesPlus date daysDay offset of the arrival (0–365, default 0)No
TimesTariff kilometersTariff kilometres (not negative)No
AvailabilityValid FromStart of the validity period (empty for a new line)Yes
AvailabilityValid UntilEnd of the validity periodNo
WeekdaysSunday to SaturdayOperating days (no day is selected for a new line)—

The Weekdays section is located on the right of the dialog and can be expanded and collapsed. When collapsed, a counter shows how many days are selected.

Procedure

  1. Click Add in the toolbar (new line) or open an existing line for editing.
  2. Fill in or adjust the fields. Starting location and End location are searched and selected via autocomplete; only depots are offered.
  3. Under Weekdays, set the desired operating days, and in the header of the dialog set the active status.
  4. Confirm with Save. Click Cancel to close the dialog without saving.

When editing an existing line, the stored starting and end locations are loaded automatically and shown in the form. A new line is created in the group selected in the header bar of the application.

Validations

When saving, the system checks the following rules:

  • Required fields: Name, RefId, Starting location, End location and Valid From must be filled in.
  • Maximum length: Name, RefId and Train number may be at most 200 characters long, Description at most 300 characters.
  • Uniqueness: Within the group, no second line with the same RefId may operate on the same weekday in an overlapping time window. Otherwise, saving is rejected with the message «RefId must be unique».
  • Start ≠ End: The Starting location must not be the same as the End location.
  • Time logic: If Plus date days is 0, the arrival time must be equal to or later than the departure time.
  • Plus date days: The value must be between 0 and 365.
  • Tariff kilometers: The value must not be negative.
  • Validity period: Valid Until must be equal to or later than Valid From.

After successful saving, the confirmation «Saved» appears and the table is refreshed.


5. Direct Editing in the Table

The active status as well as the operating days can be toggled directly in the table rows, without opening the editing dialog.

  1. In the desired row, click the checkboxes for Active and/or the individual Weekdays.
  2. As soon as changes are present, the toolbar button «Save» (direct save) becomes active.
  3. Click the button – all changes made are saved in one operation.

Several rows can be edited before saving; with a single click on «Save», all pending changes are applied.

Note: Before the first toggling of a checkbox, the direct save button is disabled.

If a changed line belongs to a group other than the one selected in the header bar, saving is rejected with the message «Not allowed».


6. Delete Lines

Lines that are no longer needed can be deleted from the overview.

  1. Mark one or more lines in the table.
  2. Click «Delete» in the toolbar.
  3. Confirm the security prompt.

The marked lines are removed and a confirmation message appears. The simultaneous deletion of several lines is supported.


7. Toolbar

The toolbar of the line overview provides the following functions:

ActionDescription
Add / EditCreate a new line or edit an existing line (permission-dependent)
Save (direct save)Save pending direct edits in the table
DeleteDelete marked lines
Apply templatesApply saved view templates for the line table
Layout functionsOpen column selection and reset layout

Templates

Users can save their column and view configuration as a template and apply it again via the toolbar. This allows frequently used views of the line table to be quickly restored.


8. Using Lines at Other Places

The lines maintained here are available as selectable connections at further places in the system. In the corresponding selection fields (line picker), a line can be searched for; the result list is filtered by the current group and the validity period. For each line found, additional information such as train number, plus date days as well as departure and arrival time is displayed.


9. Notes

  • The line management is restricted to users with administrator role (Superadmin or Admin).
  • A line connects exactly one starting location with one end location (each a depot). There are no intermediate stops and no assignment of vehicles or drivers.
  • Sorting, filtering and column configuration are processed server-side or user-specifically and are retained per user.