For every SFTP connection, konfipay logs the retrievals and transfers carried out. This makes it possible, when needed – for example for error analysis – to trace which files were processed via the connection and with what result. Since an SFTP server does not supply a processing acknowledgement, this log is the authoritative evidence of a transfer.
To do so, a connection is selected under Master data > SFTP connections and Communication log is clicked in the toolbar. The Anzeigen permission for the SFTP connections function is required in order to open it.
Viewing runs
The date range at the top limits the period displayed. Each row represents a run – that is, a scheduled or manually started retrieval or transfer – and contains:
-
Start and End – time and duration of the run.
-
Type – whether it is a retrieval or a transfer.
-
Status – whether the run was successful, partially successful or failed, or is still running. A partially successful run means that some of the files were processed and others were not.
-
Files found, Processed and Skipped – how many files the run encountered and how many of them it processed or passed over. Files that have already been processed earlier are skipped in particular.
-
Errors – the number of faulty individual operations.
The list can be sorted, filtered, grouped and exported like other tables in konfipay.
Individual files of a run
Selecting a run and clicking Entries opens the individual operations. The following are displayed for each entry:
-
File – the file name on the SFTP server.
-
Status – whether the file was processed, skipped or aborted with an error.
-
Message – the corresponding error message in the event of an error.
-
Processed on – the time of processing.
For a selected entry, the stored file content can be opened in the file viewer using File. The content is only available for successfully retrieved files; for transfers and for failed operations, a corresponding notice is displayed.
Notes on error analysis
-
A run with no files found usually indicates a deviating remote path or a file pattern that does not match (see Configure SFTP download).
-
Repeated errors for the same file suggest a format or content problem with the file. After several attempts, such files are no longer processed, but remain visible in the log together with their messages.
-
If the connection cannot even be established, the note on the changed server key should be observed (see Set up SFTP connection).