Excel-Wert-Eintragen

Mantiseinträge

 3647

Systemtyp

 83

Beschreibung

Dieser Serverjob trägt Werte in eine bereits vorhandene Excel-Datei im Datenordner des DO ein. Die Datei wird weder erzeugt noch konvertiert noch umbenannt; es werden ausschliesslich einzelne Zellen beschrieben und die Datei im vorhandenen Format (.xlsx oder .xls) wieder gespeichert.

Was genau eingetragen wird, ist aktuell noch nicht frei konfigurierbar, sondern pro Projekt fest im Job hinterlegt. Aktuell existiert nur die Variante Forensik. Für ein weiteres Projekt mit anderer Zelllogik muss ein zusätzlicher Typ im Job ergänzt werden.

Variante Forensik (HZ_EXPORTFILETYP=1)

Der Job verarbeitet die direkten Kinder des DO. Für jedes Kind wird die neueste Leistung am CheckIn-Schritt desselben Produktionsauftrags gesucht und daraus Zeitpunkt und Angestelltenkürzel in die Excel-Datei geschrieben.

Ablauf pro DO:

1. Check-in-Herstellzeile im selben Produktionsauftrag suchen (über HZ_SYSTEMTYP=13, nicht über den sichtbaren Namen). Es muss genau eine existieren.
2. Letzten datenführenden Ordner des DO bestimmen.
3. In diesem Ordner die erste Excel-Datei (.xlsx oder .xls, alphabetisch aufsteigend nach Dateiname) öffnen, erstes Arbeitsblatt.
4. Direkte Kinder des DO aufsteigend nach DO_SEQ laden, je Kind die neueste Check-in-Leistung (bei gleichem LS_DATUM entscheidet die höhere LS_SEQ).
5. Ab Zeile 2 in Spalte D je Kind einen Wert schreiben: Check-in-Zeitpunkt, Schrägstrich, Kürzel des Angestellten.
6. Datei speichern und erst danach das DO weiterschieben.

Beispiel: das erste Kind nach DO_SEQ landet in D2, das zweite in D3 und so weiter.

 D2    11.09.2026 08:14:02/MPE
 D3    11.09.2026 08:15:31/STE
 D4    11.09.2026 08:17:44/STE

Enkel werden nicht verarbeitet. Hat das DO keine direkten Kinder, wird keine Zelle geschrieben; nach erfolgreicher Ordner- und Dateiprüfung gilt der Schritt trotzdem als erledigt und das DO läuft weiter.

Der Schritt legt keinen eigenen Datenordner an. Die Excel-Datei bleibt dort liegen, wo sie vorher lag. Ein Wiederholungslauf beschreibt dieselben Zellen mit denselben Werten und ist damit unproblematisch.

Variante Keine Aktion (HZ_EXPORTFILETYP=0)

Es wird keine Datei und kein Datensatz verändert, das DO wird nur weitergeschoben. Damit lässt sich der Schritt im Ablauf stehen lassen, ohne dass Objekte darin hängen bleiben.

Voraussetzungen

• Im selben Produktionsauftrag muss genau ein CheckIn-Schritt vorhanden sein. Fehlt er oder gibt es mehrere, ist das ein Workflowfehler und die Herstellzeile wird gestoppt.
• Das Einchecken schreibt seit diesem Mantispunkt eine Leistung mit DO, Check-in-Herstellzeile, Angestelltem und Zeitpunkt (feste Dauer von einer Minute, gespeichert als 0.017 Stunden). Nur Objekte, die nach dieser Erweiterung eingecheckt wurden, besitzen eine auswertbare Leistung. Alte Check-ins lassen sich nicht nachträglich rekonstruieren.
• Die Excel-Datei muss vor dem Schritt bereits im Datenordner des DO liegen.
• Jedes direkte Kind braucht eine vollständige Check-in-Leistung mit Datum und auflösbarem Angestellten. Fehlt bei einem Kind etwas davon, bricht der ganze DO mit Fehler ab. Es werden bewusst keine leeren Ersatzwerte geschrieben, weil sonst alle nachfolgenden Zeilen falsch zugeordnet wären.
• Das ExcelFormat-xcomp muss auf dem Server verfügbar sein.

Essentielle Felder

Ausgänge:

 HZ_HZ_SEQ1       Ausgang Links: einziger Ausgang, das DO geht erst weiter, wenn die Excel-Datei erfolgreich gespeichert wurde

Konfiguration:

 HZ_EXPORTFILETYP Droplist: 0=Keine Aktion, 1=Forensik

Konfiguration

Das Konfigurationsfenster enthält bewusst nur diese eine Auswahl. Spalte, Startzeile, Arbeitsblatt, Dateiauswahl und Wertformat sind fest im Job hinterlegt und im Fenster nicht einstellbar.

Fehlermeldungen

Fehler am Objekt werden in DO_FEHLER/DO_FEHLERTEXT gesichert und protokolliert; das DO wird in diesen Fällen nicht weitergeschoben.

Nummer	Ursache
8302	Letzter Datenordner des DO fehlt
8303	Keine Excel-Datei (.xlsx/.xls) im Datenordner gefunden
8304	Excel-Datei oder erstes Arbeitsblatt kann nicht geöffnet werden
8305	Abfrage der Kinder und ihrer Check-in-Leistungen schlägt fehl
8306	Ein Kind hat keine vollständige Check-in-Leistung oder der Angestellte ist nicht auflösbar
8307	Excel-Datei kann nicht gespeichert werden

Eine fehlende oder mehrdeutige Check-in-Herstellzeile sowie ein unbekannter Wert in HZ_EXPORTFILETYP sind dagegen Konfigurationsfehler der Herstellzeile: der Job stoppt die Herstellzeile, statt ein einzelnes Objekt auf Fehler zu setzen.