ShippingDashboard – Benutzeranleitung

Das ShippingDashboard ist ein Live-Cockpit für deinen JTL-Wawi-Versand. Es läuft als kleiner Windows-Dienst direkt auf deinem Server und zeigt im Browser auf einen Blick: was heute noch raus muss, wie schnell gepackt werden muss und welche Versandboxen bereit sind. Diese Anleitung führt durch Installation, Bedienung und Konfiguration.

---

1. Voraussetzungen

• JTL-Wawi mit Microsoft SQL Server
• Windows-Server oder -PC mit .NET Framework 4.6 oder neuer (i. d. R. bereits vorhanden)
• Ein SQL-Server-Zugang (SQL- oder Windows-Authentifizierung) mit Leserechten auf die Wawi-Datenbank sowie dem Recht, im Schema _spsfc eine kleine Hilfstabelle anzulegen
• Administratorrechte für die Installation (Dienst-Registrierung)

2. Installation

1. Das signierte Setup ShippingDashboard-Setup-x.y.z.exe ausführen (Herausgeber: FALKConS GmbH).
2. Seite „Datenbank-Verbindung": Zugangsdaten zur JTL-Wawi-Datenbank eingeben:
   • SQL-Server – z. B. SERVERNAME\JTLWAWI
   • Datenbank – meist eazybusiness
   • Benutzer / Passwort – SQL-Login. Benutzer leer lassen = Windows-Authentifizierung.
3. Seite „Einstellungen":
   • Warenlager-ID – die kWarenlager des anzuzeigenden Lagers (alle Werte sind später im Dashboard wählbar).
   • Cut-off-Zeit – Trennzeit zwischen „Heute" und „Morgen" (Standard 14:15).
   • Arbeitsbeginn / Versand-Deadline – Zeitfenster für den Tempo-Tacho.
   • Port – lokaler Port des Dashboards (Standard 8080).
4. Die Installation registriert und startet automatisch den Dienst „ShippingDashboard Datenservice".

3. Dashboard öffnen

Auf dem Server einen Browser öffnen und aufrufen:

http://localhost:8080/

(Port entsprechend anpassen, falls bei der Installation geändert.)

Hinweis: Das Dashboard ist aus Sicherheitsgründen nur lokal auf dem Server erreichbar (Loopback). Ein direkter Doppelklick auf die dashboard.html funktioniert nicht – die Seite muss immer über http://localhost:<Port>/ aufgerufen werden.

4. Die Oberfläche im Detail

4.1 Kennzahlen-Kacheln (oben)

Kachel	Bedeutung
Lieferscheine heute	Anzahl der heute erstellten, versendeten Lieferscheine.
Gelieferte Auftragspositionen	Heute versendete Positionsmenge (Stück).
Lieferbare Aufträge	Versandbereite Aufträge, getrennt nach Heute und Morgen.
Lieferbare Auftragspositionen	Versandbereite Positionsmenge, getrennt nach Heute und Morgen.

4.2 Heute / Morgen und die Cut-off-Zeit

Aufträge, die bereits vor der Cut-off-Zeit (Standard 14:15) versandbereit waren oder schon auf der Pickliste stehen, zählen zu Heute. Aufträge, die nach der Cut-off-Zeit versandbereit wurden, zählen zu Morgen. Um Mitternacht rollt die Einteilung automatisch weiter – die gestrigen „Morgen"-Aufträge werden zu „Heute".

4.3 Versand-Tempo-Tacho

Der Tacho zeigt, wie schnell gearbeitet werden muss, um die offenen Positionen bis zur Versand-Deadline zu schaffen:

• Soll-Tempo = noch offene Positionen geteilt durch die verbleibende Zeit (Positionen/Stunde).
• Ist-Tempo = bisher heute verpackte Positionen geteilt durch die bereits vergangene Arbeitszeit.
• Farbe: Grün = gut im Plan, Gelb = knapp, Rot = Tempo erhöhen.
• Trend (Pfeil-Icon): vergleicht die letzten 15 Minuten mit den 15 Minuten davor – steigend, gleichbleibend oder fallend.

In Randzeiten zeigt der Tacho neutrale Texte („Noch nicht gestartet", „Aufwärmen…"). Nach der Deadline erscheint die noch offene Restmenge in Rot.

4.4 Tagesverlauf-Diagramm

Das Balkendiagramm „Verpackt im Tagesverlauf" zeigt je Stunde, wie viel verpackt wurde: Balken = Positionen, Linie = Aufträge. So ist sofort erkennbar, zu welcher Uhrzeit wie viel Durchsatz erreicht wurde.

4.5 Boxen-Übersicht

Jede Versandbox wird mit ihrer Nummer und einer Statusfarbe angezeigt:

• Grün – Box kann verpackt werden
• Orange – Box ist für einen Auftrag reserviert
• Rot – Box ist gesperrt

Gibt es für das gewählte Lager keine Boxen, wird dieser Bereich automatisch ausgeblendet.

5. Einstellungen ändern (⚙)

Unten links im Dashboard befindet sich der Button ⚙ Einstellungen. Dort lassen sich ohne Neuinstallation anpassen:

• Warenlager – per Auswahlliste das anzuzeigende Lager wechseln
• Cut-off-Zeit – Trennung Heute/Morgen
• Arbeitsbeginn / Versand-Deadline – Zeitfenster des Tachos
• Tagesverlauf-Diagramm anzeigen – ein-/ausblenden
• Versand-Tempo-Tacho anzeigen – ein-/ausblenden

Nach Speichern wirken die Änderungen sofort. Ist nur eine der beiden Grafiken (Tacho oder Tagesverlauf) aktiv, nimmt sie automatisch die volle Breite ein.

6. Konfiguration über die Datei (z. B. Port ändern)

Der Port lässt sich nur über die Konfigurationsdatei ändern. Sie liegt im Installationsordner, standardmäßig:

C:\Program Files\FALKConS GmbH\ShippingDashboard\ShippingDashboard.exe.config

Relevante Schlüssel im Abschnitt <appSettings>: Port, Warenlager, CutoffZeit, Arbeitsbeginn, VersandDeadline, TachoAnzeigen, VerlaufAnzeigen. Die Datenbankverbindung steht unter <connectionStrings>. Nach Änderungen an dieser Datei den Dienst neu starten (siehe Abschnitt 7).

7. Dienst verwalten

Der Dienst heißt ShippingDashboard („ShippingDashboard Datenservice"). Über die Windows-Dienste (services.msc) oder per PowerShell (als Administrator):

Restart-Service ShippingDashboard
Stop-Service ShippingDashboard
Start-Service ShippingDashboard

Diagnose-Meldungen schreibt der Dienst in ShippingDashboard.log im Installationsordner.

8. Als Wallboard betreiben

Für den Lager-Monitor den Browser im Vollbildmodus (Taste F11) auf http://localhost:<Port>/ öffnen. Das Dashboard aktualisiert sich automatisch alle 5 Sekunden – es muss nichts neu geladen werden.

9. Mehrere Lager

Über das Einstellungs-Menü kann das angezeigte Lager jederzeit gewechselt werden. Sollen mehrere Lager gleichzeitig auf verschiedenen Bildschirmen laufen, lässt sich pro Lager eine eigene Instanz auf einem eigenen Port einrichten. Die gemeinsame Datenbasis bleibt dabei konfliktfrei. Bei Bedarf unterstützt dich unser Support beim Aufsetzen.

10. Problembehebung

Symptom	Ursache / Lösung
Browser zeigt „Failed to fetch" / keine Zahlen	Die Seite wurde als Datei geöffnet statt über den Dienst. Immer http://localhost:<Port>/ aufrufen.
Alle Werte sind „–" oder „-1"	Datenbankverbindung fehlerhaft. Connection-String in der Config prüfen, Dienst neu starten, ShippingDashboard.log ansehen.
Alle Kennzahlen 0	Für das gewählte Lager liegen keine passenden Daten vor, oder es ist nach der Deadline. Im Menü ein anderes Lager wählen.
Tacho zeigt keinen Trend	Trend erscheint erst nach ca. 30 Minuten Laufzeit (Datenbasis) und nur im aktiven Arbeitszeitfenster.
Boxen-Bereich fehlt	Für das gewählte Lager existieren keine Versandboxen – das ist beabsichtigt.
Dienst startet nicht	In services.msc Status prüfen; ShippingDashboard.log auf Fehler kontrollieren (häufig falsche DB-Zugangsdaten).

11. Deinstallation

Über Windows → Apps → ShippingDashboard → Deinstallieren. Der Dienst wird dabei automatisch gestoppt und entfernt. Die kleine Hilfstabelle im Schema _spsfc bleibt unverändert in der Datenbank bestehen und kann bei Bedarf manuell entfernt werden.

12. Support

Fragen oder Wünsche? Wir helfen gern:

• E-Mail: support@falkcons.de

FALKConS GmbH – Made in Germany.