konfipay help center

SFTP-Kommunikationsprotokolle

Dieser Artikel wird zeitnah um Abbildungen ergänzt.

Für jede SFTP-Verbindung protokolliert konfipay die durchgeführten Abrufe und Übertragungen. So lässt sich im Bedarfsfall – etwa zur Fehleranalyse – nachvollziehen, welche Dateien über die Verbindung verarbeitet wurden und mit welchem Ergebnis. Da ein SFTP-Server keine Verarbeitungsquittung liefert, ist dieses Protokoll der maßgebliche Nachweis einer Übertragung.

Dazu wird unter Stammdaten > SFTP-Verbindungen eine Verbindung ausgewählt und in der Toolbar auf Kommunikationslog geklickt. Zum Öffnen ist die Berechtigung Anzeigen der Funktion SFTP-Verbindungen erforderlich.

Läufe einsehen

Über den Datumsbereich am oberen Rand wird der angezeigte Zeitraum eingegrenzt. Jede Zeile steht für einen Lauf – also für einen planmäßigen oder manuell gestarteten Abruf beziehungsweise eine Übertragung – und enthält:

  • Start und Ende – Zeitpunkt und Dauer des Laufs.

  • Typ – ob es sich um einen Abruf oder eine Übertragung handelt.

  • Status – ob der Lauf erfolgreich, teilweise erfolgreich oder fehlgeschlagen war beziehungsweise noch läuft. Ein teilweise erfolgreicher Lauf bedeutet, dass ein Teil der Dateien verarbeitet wurde und ein anderer nicht.

  • Gefundene Dateien, Verarbeitet und Übersprungen – wie viele Dateien der Lauf angetroffen und wie viele er davon verarbeitet oder übergangen hat. Übersprungen werden insbesondere Dateien, die bereits früher verarbeitet wurden.

  • Fehler – die Anzahl der fehlerhaften Einzelvorgänge.

Die Liste lässt sich wie andere Tabellen in konfipay sortieren, filtern, gruppieren und exportieren.

Einzelne Dateien eines Laufs

Über die Auswahl eines Laufs und Einträge werden die Einzelvorgänge geöffnet. Je Eintrag werden angezeigt:

  • Datei – der Dateiname auf dem SFTP-Server.

  • Status – ob die Datei verarbeitet, übersprungen oder mit Fehler abgebrochen wurde.

  • Meldung – im Fehlerfall die zugehörige Fehlermeldung.

  • Verarbeitet am – der Zeitpunkt der Verarbeitung.

Zu einem ausgewählten Eintrag lässt sich über Datei der gespeicherte Dateiinhalt im Dateibetrachter öffnen. Der Inhalt liegt nur zu erfolgreich abgeholten Dateien vor; zu Übertragungen und zu fehlgeschlagenen Vorgängen wird ein entsprechender Hinweis angezeigt.

Hinweise zur Fehleranalyse

  • Ein Lauf ohne gefundene Dateien deutet in der Regel auf einen abweichenden Remote-Pfad oder ein nicht passendes Dateimuster hin (siehe SFTP-Download konfigurieren).

  • Wiederholte Fehler zur selben Datei sprechen für ein Format- oder Inhaltsproblem der Datei. Solche Dateien werden nach mehreren Versuchen nicht weiter verarbeitet, bleiben aber mit ihren Meldungen im Protokoll sichtbar.

  • Scheitert bereits der Verbindungsaufbau, ist der Hinweis zum geänderten Server-Schlüssel zu beachten (siehe SFTP-Verbindung einrichten).