Customizing Error Messages in HTML

Lists of specific error messages are contained in the AppErrors.csv and AlertSeverities.csv files, which can be edited by double-clicking them in the Data Files section of the project tree view. These lists are based on significant consulting experience and meet the needs of most users. If however you feel that certain error messages are missing, or you wish to add additional error messages, you can customize these files.

Customizing Error Messages in HTML

The AppErrors.csv file contains error messages that cause errors to be raised when they occur in HTTP responses. Each row defines one error message across three columns:

  • Severity: Specifies the severity of error that is to be raised. Values in this column must begin with S, I, W, E, or T (signifying the severities Success, Informational, Warning, Error, or Transaction Exit).
  • Data or Html: Specifies whether the entire HTTP response should be searched for the error message (API function WebVerifyData), or whether only the visible HTML content should be searched for the error message (API function WebVerifyHtml). Values in this column must begin with either D or H.
  • Error String: The text of the error message. If you want to catch a set of error messages that have a common substring, it is good practice to enter only one entry where the Error String is the common substring. Example: If you have 100 different error messages, which all begin with Microsoft SQL error:, it is sufficient to have one list entry with the Error String "Microsoft SQL error:.

The AppErrors.csv file can be edited to meet your needs.