ReportProblem

Introduction

The Report Problem button can be added to any Quickforms application allowing the user of the application to report problems at any time. The user gives his email address, phone number and a description of the problem.

The problem report is sent to predefined email addresses, along with a copy to the email address the user provided. The email addresses to be used is configurable in the context.xml of tomcat as environment variables. These are also app-specific, i.e. different addresses can be used for different applications. A quickforms application wishing to use this functionality must define these variables in the context.xml of tomcat

Configuration

The configuration in context.xml has 3 variables:

<appname>.reportProblem.fromAddress: The address from which the email will be sent. This must be a gmail address because the smtp settings programmed are for gmail smtp.

<appname>.reportProblem.emailPassword: Password of the above mentioned email address. This is used to login into the gmail SMTP server to send the emails

<appname>.reportProblem.toAddresses: A comma separated list of all email addresses to which the email must be sent. A copy will be sent to each of these email addresses along with the email address provided by the user.

Since this functionality is app-specific, <appname> above refers to the name of the quickforms application. See sample below for RPP.

As of the time of writing, this functionality has been implemented in RPP. Sample configuration for RPP (with fake email addresses to prevent harvesting by spam-bots) looks as follows:

<Environment name="rpp.reportProblem.fromAddress" value="abc@abc.com" type="java.lang.String"/>
<Environment name="rpp.reportProblem.emailPassword" value="12345678" type="java.lang.String"/>
<Environment name="rpp.reportProblem.toAddresses" value="abc@abc.com,user@site.com,someone@somewhere.com" type="java.lang.String"/>