If processing cannot be completed, the KFI will be suspended, and an information message will be displayed to advise of the failure. If an unattended KFI was being run in minimised (or silent) mode, the task screen and the KFI dialog box will be maximised so that you can interact with the KFI application in the normal manner.
An error file is created which defaults to the name of the keystroke import file (filename.kfi.err). If you open up the error file (using Notepad or similar programs) A comment is inserted in the error file, to mark the point at which the file failed. Some samples of typical error message is as follows:
ErrorOccurredHere="Input rejected by field validation routine","00h","Last field is less than first".
ErrorOccurredHere="Input contains invalid character","A".
ErrorOccurredHere="Input rejected by field validation routine","00h","Transaction Not Allowed for Non-Diminishing Product".
ErrorOccurredHere="Input exceeds field length","a","Brisbane".
🤓Tip: use the Edit, Find menu in Notepad to search for key text i.e.: 'error' to make it easy to find the error messages.
In unattended mode, the failed KFI and error file are moved to a default folder named Failure. This folder is created in the inbox of either KFIDATA or the user's folder, depending on where the keystroke import file was originally placed.
If invalid data is detected
If invalid data is detected in your import file, the keystroke file import is suspended and an information message is displayed:
If you receive this message, you may have to restore your data from the most recent backup made prior to starting the import and correct the import file before attempting to import it again.
In some cases, you may be able to continue with the import if the import was stopped on a particular field and the default for that field allows you to continue. If you are running the KFI to a Masterfile, you may NOT have to restore data. Once you correct the error, you may be able to re run the KFI import file and it will simply overwrite the existing data in the Masterfile table.
📌Note: It is not recommended that you use the continue feature when creating transactional documents such as invoices or credit notes.
Invalid data may include
An entry which has exceeded the field's capacity.
An invalid character in a field, for example an alpha character in a numeric field or an X in a Yes/No field.
A field omitted in the import file, causing the import file to be out of sequence with the task screen.
If you receive an invalid data message, note the highlighted field containing the invalid data, its contents and any other identifying factors.
If you can continue with the import
Choose Continue (F6).
Remember to enquire on this record once the file import is completed to check that the correct details were recorded.
If you encounter more invalid data messages, stop the file import
To stop the import:
Choose Stop (Esc). A file import Interrupted message is displayed.
Choose Close (Esc).
Cancel or delete the entry displayed on the task screen.
Exit from your Attaché system.
You should then correct the invalid data in the import file using the details you noted earlier to determine the error conditions; restore your data (if necessary) from the backup and import the keystroke file again.