Picklist – Zielort ändern · WMS Driver Action

1. Übersicht

identpro WES stellt Fahrern am Terminal die Driver Action Picklist – Zielort ändern bereit. Mit ihr kann der Fahrer während der Bearbeitung einer Ladeliste den vorausgewählten Zielort durch einen anderen, für diese Ladeliste konfigurierten Zielort ersetzen.

Hintergrund: Beim Start einer Ladeliste wählt der Fahrer aus einer Liste vorkonfigurierter Ziellokationen eine aus. Stellt er fest, dass dieses Ziel nicht mehr passt (z. B. Zielort belegt, geänderte Disposition), kann er mit dieser Aktion das Ziel wechseln, ohne die Ladeliste abbrechen zu müssen.

Nur WES-intern:
Diese Driver Action kommuniziert nicht mit dem LVS. Die Änderung wird ausschließlich im WES-System gespeichert und an die betroffenen Fahraufträge weitergegeben. Das LVS erhält keine separate Benachrichtigung über die Zieländerung.

2. Voraussetzungen

📌 Aktive Ladeliste

Es muss mindestens eine Ladeliste im Status In Bearbeitung vorliegen, die dem Fahrer (bzw. dem Stapler) zugeordnet ist. Ladelisten ohne aktive Bearbeitung werden nicht angezeigt.

🎯 Mehrere Ziellokationen konfiguriert

Die Ladeliste muss über mindestens eine alternative Ziellokation verfügen. Ist nur ein einziges Ziel definiert, erscheint die Ladeliste in der Auswahlliste nicht (bzw. zeigt eine Fehlermeldung). Die Ziellokationen werden im Ladelisten-Template (PickListTemplate) hinterlegt.

🔒 Template mit fester Zielliste

Nur Ladelisten, deren Template die Einstellung allowIndividualDestinations = false trägt, werden in der Auswahl angezeigt. Ladelisten auf Basis von Templates mit allowIndividualDestinations = true (freie Zieleingabe durch den Fahrer) werden von dieser Aktion automatisch ausgeschlossen — dort gibt es keine vordefinierte Zielliste, aus der der Fahrer wählen könnte.

⚙ Action aktiviert

Die Driver Action ist standardmäßig deaktiviert und muss projektspezifisch in der Driver-Action-Konfiguration (T_DRIVER_ACTION_CONF, Aktionsname PICKLIST_DESTINATION_CHANGE) explizit aktiviert werden.

3. Terminal-Anzeige

Am Fahrzeugterminal erscheint die Aktion im Driver-Action-Menü mit dem Text:

Sprache	Haupttext	Untertext
Deutsch	Zielplatz der Ladeliste ändern	Neues Ziel festlegen
Englisch	Change pick list destination	Set new destination

4. Prozessablauf am Terminal

Die Aktion besteht aus zwei aufeinanderfolgenden Auswahlschritten am Fahrzeugterminal.

Schritt 1 – Ladeliste auswählen (SELECT_PICKLIST)

1 Fahrer öffnet die Driver Action Picklist – Zielort ändern im Terminal-Menü.

2 WES ermittelt alle aktiven Ladelisten des Staplers, für die mindestens ein alternativer Zielort verfügbar ist. Der Fahrer sieht eine Liste zur Auswahl.
Terminal-Text (DE): „Wähle eine Ladeliste …"

✗ Keine geeignete Ladeliste vorhanden: Dem Fahrer wird eine Fehlermeldung angezeigt („Keine Ladeliste verfügbar") und die Aktion wird beendet.

✓ Fahrer wählt eine Ladeliste aus → weiter mit Schritt 2.

Schritt 2 – Neuen Zielort auswählen (SELECT_DESTINATION)

3 WES liest die für die gewählte Ladeliste konfigurierten Ziellokationen aus. Der aktuelle Zielort wird hervorgehoben; alle alternativen Ziele werden zur Auswahl angezeigt.
Terminal-Text (DE): „Wähle neuen Zielplatz für die Ladeliste"

✗ Kein gültiges Ziel verfügbar: Dem Fahrer wird eine Fehlermeldung angezeigt („Kein gültiges Ziel") und die Aktion wird beendet.

✓ Fahrer wählt einen neuen Zielort aus → WES führt die Änderung durch.

Schritt 3 – Änderung wird durchgeführt (CHANGE_FINISHED)

4 WES aktualisiert den selectedDestinationLocation-Wert der Ladeliste auf den neu gewählten Zielort.

5 Für alle noch nicht abgeschlossenen Fahraufträge der Ladeliste wird das destinationSet (Zielort-Menge der Aufträge) auf den neuen Zielort aktualisiert. Bereits abgeschlossene Fahraufträge (COMPLETED) bleiben unverändert.

! Benachrichtigung anderer Stapler: Arbeiten weitere Stapler an derselben Ladeliste, erhalten diese automatisch eine Terminal-Meldung über die Zieländerung (Meldungscode 90022: „Ladeliste [ID] wurde verändert von Stapler [Name] mit neuem Zielort [Ziel]"). Der ändernde Fahrer selbst erhält Meldungscode 90023: „Ladeliste [ID] wurde verändert mit neuem Zielort [Ziel]".

✓ Dem Fahrer wird am Terminal eine Erfolgsmeldung angezeigt („Ladelisten Zielplatz Änderung fertig"). Die Aktion ist abgeschlossen.

5. Konfiguration

Driver Action aktivieren

Tabelle: T_DRIVER_ACTION_CONF
Spalte: action_name
Wert: PICKLIST_DESTINATION_CHANGE

Standardmäßig ist die Aktion deaktiviert. Sie muss projektspezifisch über die Driver-Action-Konfiguration freigeschaltet werden.

Ziellokationen am Template

Die möglichen Zielorte einer Ladeliste werden am PickListTemplate konfiguriert. Nur Ladelisten, deren Template mindestens eine wählbare Ziellokation enthält, werden in der Aktion angeboten. Ist nur ein Zielort definiert, ist kein Wechsel möglich.

6. Verhalten im Detail

Welche Fahraufträge werden aktualisiert?

Nach der Auswahl eines neuen Zielorts aktualisiert WES das destinationSet aller Fahraufträge der Ladeliste, die noch nicht den Status COMPLETED haben. Bereits abgeschlossene Transportvorgänge bleiben davon unberührt.

Zusätzlich werden nur Fahraufträge aktualisiert, die keine MaterialFlowPosition mit Nachfolgern besitzen — also freie, noch nicht fest in einen Materialfluss eingebettete Aufträge.

Mehrere Stapler an einer Ladeliste

Arbeiten mehrere Stapler gleichzeitig an einer Ladeliste und einer davon ändert den Zielort, erhalten alle anderen Stapler automatisch eine Terminalmeldung, damit sie ihren aktuellen Zielort kennen und entsprechend navigieren können.

Meldungscode	Empfänger	Text (DE)
`90022`	Andere Stapler	Ladeliste: [ID] wurde verändert von Stapler: [Name] mit neuem Zielort: [Ziel]
`90023`	Ändernder Stapler	Ladeliste: [ID] wurde verändert mit neuem Zielort: [Ziel]

7. Technische Schnittstelle (WES-intern)

► Fahrer → WES (intern)

Die Aktion wird über die generische Driver-Action-Schnittstelle von WES abgewickelt. Es gibt keinen dedizierten WMS REST-Endpunkt für diese Aktion; die Verarbeitung findet vollständig innerhalb von WES statt.

Endpunkt	`POST /truckaction/executeaction`
Aktions-ID	`PICKLIST_DESTINATION_CHANGE`
Implementierung	`PickListDestinationChangeAction`

Schritte (Steps) der Aktion

Step-ID	Beschreibung
`SELECT_PICKLIST`	WES liefert die Liste der auswählbaren Ladelisten. Der Fahrer wählt eine aus.
`SELECT_DESTINATION`	WES liefert die konfigurierten Ziellokationen der gewählten Ladeliste. Der Fahrer wählt den neuen Zielort.
`CHANGE_FINISHED`	Abschluss der Aktion – entweder Bestätigung der erfolgreichen Änderung oder Fehlermeldung.

Kein LVS-Callback:
Im Gegensatz zu anderen Driver Actions (z. B. Lagerort-Status, Ladungsschaden) wird das LVS über diese Zieländerung nicht informiert. Soll das LVS den neuen Zielort kennen, muss dies über den normalen TOCO/SUMO-Quittierungsfluss beim Abschluss der betroffenen Fahraufträge geschehen – der Absetzort wird im TOCO übermittelt.

Picklist – Zielortändern