Logging

Wo die App protokolliert, was bei einem Import passiert ist – und wie Sie daraus eine Ursache ableiten.

Die Ebenen der Protokollierung

Die App protokolliert auf drei Ebenen. Arbeiten Sie sich bei einer Störung von oben nach unten durch.

Ebene	Ort	Antwortet auf die Frage
1	Importsitzung	Ist der Import als Ganzes durchgelaufen?
2	Staging-Datensatz	Welcher einzelne Datensatz hat ein Problem, und warum?
3	Ergebnismeldungen der Aktionen	Was hat das Schreiben von Preisen oder Stücklisten bewirkt?

Ebene 1: Die Importsitzung

Jede Importsitzung hält den Verlauf eines Imports fest.

Feld	Aussage
Status	Ausstehend, In Verarbeitung, Abgeschlossen, Abgeschlossen mit Fehlern, Fehler, Abgebrochen.
Dateiname	Welche Datei verarbeitet wurde.
DATANORM-Version	Die aus dem Vorlaufsatz erkannte Version.
Kreditorennr.	Der zugeordnete Kreditor.
Verarbeitete Datensätze	Anzahl gelesener Datensätze.
Fehlerhafte Datensätze	Anzahl Zeilen, die nicht gelesen werden konnten.
Startzeit, Endzeit	Laufzeit des Imports.
Fehlermeldung	Ursache, falls die Sitzung abgebrochen wurde.

Abgeschlossen mit Fehlern bedeutet, dass die Datei verarbeitet wurde, einzelne Zeilen aber nicht gelesen werden konnten. Der Import ist damit nicht wertlos – prüfen Sie im Staging, was fehlt.

Ebene 2: Der Staging-Datensatz

Jeder Datensatz trägt seinen eigenen Status und seine eigene Meldung.

Feld	Aussage
Verarbeitungsstatus	Wo der Datensatz im Ablauf steht.
Duplikat, Duplikatgrund	Ob und weshalb ein Treffer erkannt wurde.
Zugeordnete Artikelnr.	Der vorhandene Artikel, auf den der Treffer verweist.
Fehlermeldung	Warum die Synchronisierung fehlgeschlagen ist.
Zusammengeführte Quellsätze	Aus wie vielen Dateizeilen der Datensatz entstanden ist.

Filtern Sie im Staging auf Verarbeitungsstatus = Fehler, um alle Problemfälle einer Sitzung auf einmal zu sehen.

Ebene 3: Ergebnismeldungen

Die Aktionen an der Importsitzung melden nach dem Lauf, was sie bewirkt haben.

Aktion	Meldung enthält
Einkaufspreisliste schreiben	Anzahl Einkaufszeilen, Verkaufszeilen, Staffelpreiszeilen und übersprungener Artikel.
Stücklisten aufbauen	Anzahl aufgebauter Sets, erzeugter Komponenten, übersprungener Sets und Fehler.
Kreditor zuordnen	Anzahl angepasster Staging-Datensätze.

Notieren Sie diese Zahlen bei einer Abnahme. Sie sind der schnellste Nachweis, dass ein Import vollständig durchgelaufen ist.

Archivierte Dateien

Ist Importierte Dateien archivieren aktiv, bewahrt die App den ursprünglichen Dateiinhalt an der Importsitzung auf. Damit lässt sich später nachvollziehen, was der Lieferant tatsächlich geliefert hat – unabhängig davon, ob die Datei beim Lieferanten noch verfügbar ist.

Lassen Sie die Archivierung aktiv. Sie ist bei einer Klärung mit dem Lieferanten oft der entscheidende Beleg. Sehr große Kataloge belegen entsprechend Speicherplatz – löschen Sie alte Sitzungen bei Bedarf gezielt.

SFTP-Protokollierung

Die SFTP-Einrichtung führt zwei Felder für die Diagnose:

Feld	Aussage
Letzte Abfrage	Wann der Eingangsordner zuletzt geprüft wurde. Ein alter Zeitstempel deutet auf eine nicht laufende Jobwarteschlange.
Status der letzten Abfrage	Ergebnis oder Fehlermeldung des letzten Abrufs.

Zusätzlich zeigt DATANORM SFTP-Dateien, was im Eingangsordner liegt.

Vorgehen bei einer Störung

1

Sitzung ansehen

Status und Fehlermeldung der Importsitzung lesen. Steht dort ein Abbruchgrund, ist die Ursache meist die Datei selbst.

2

Staging filtern

Auf Status Fehler filtern und die Fehlermeldungen lesen. Wiederholt sich dieselbe Meldung, liegt es an der Einrichtung, nicht an den Daten.

3

Ursache beheben

Fehlende Einheitenzuordnung, Buchungsgruppe oder Nummernserie ergänzen, siehe Typische Fehlerquellen.

4

Erneut synchronisieren

Nur die betroffenen Datensätze erneut synchronisieren. Ein Neuimport der Datei ist fast nie nötig.

Für eine Supportanfrage

Halten Sie diese Angaben bereit:

• Nummer und Status der Importsitzung
• Dateiname und erkannte DATANORM-Version
• Wortlaut der Fehlermeldung
• Anzahl verarbeiteter und fehlerhafter Datensätze
• die betroffene DATANORM-Datei, sofern Sie sie weitergeben dürfen

Kontakte unter Supportkontakte.