Implementation Guide for Oracle Self-Service E-Billing > Using and Customizing Email Notifications >

Customizing the Content of Email Notifications

Oracle Self-Service E-Billling provides email notification templates for each type of message it supports. The content for each type of notification is described in Email Notification Template Content (Business Edition) and Email Notification Template Content (Consumer Edition). You can customize some of the notification content for your organization by updating the notification properties file contained in the application resource bundles and regenerating the email template XSL files using the automated template generator. The notification properties file contains the strings and text used in the composition of email messages.

Oracle Self-Service E-Billling can send email notifications to users based on enrollment events as well as various billing and payment lifecycle events, such as when a new bill is ready for viewing online, a payment is due, scheduled, sent, and so on. Email notifications are classified into batch and instant notifications, based on whether the notification is generated by a batch job defined and run in the Command Center or a user's action.

NOTE:  Note that validation URLs are inserted automatically and cannot be changed; users are required to complete the enrollment process.

If you have localized your Oracle Self-Service E-Billling applications, be sure to update the corresponding notification property file for each language (if appropriate). For more information about localization, see Localizing the User Interface.

To customize the content of email notifications

1. Oracle Self-Service E-Billling must be installed and deployed. Shut down the Billing and Payment, Command Center, and Customer Service Representative application servers (if running).
2. Extract the app-resources-1.0-SNAPSHOT.jar file from the Billing and Payment and the Customer Service Representative EAR files shown in the following table (use back slashes (\) on Windows):

   Application Server	Oracle Self-Service E-Billing Application	Location of the Application Resource Bundle File
   Oracle WebLogic	Billing and Payment	EDX_HOME/J2EEApps/ebilling/ weblogic/ebilling-weblogic-10-6.0.4.ear/xma/app-resources-1.0-SNAPSHOT.jar
   	Command Center	EDX_HOME/J2EEApps/commandcenter/weblogic/command-center-weblogic-10-6.0.4.ear/xma/app-resources-1.0-SNAPSHOT.jar
   	Customer Service Representative	EDX_HOME/J2EEApps/csr/ weblogic/csr-app-6.0.4.ear/xma/app-resources-1.0-SNAPSHOT.jar
   IBM WebSphere	Billing and Payment	EDX_HOME/J2EEApps/ebilling/ websphere/ebilling-websphere-6-6.0.4.ear/xma/app-resources-1.0-SNAPSHOT.jar
   	Command Center	EDX_HOME/J2EEApps/commandcenter/websphere/command-center-websphere-6-6.0.4.ear/xma/app-resources-1.0-SNAPSHOT.jar
   	Customer Service Representative	EDX_HOME/J2EEApps/csr/ websphere/csr-app-6.0.4.ear/xma/app-resources-1.0-SNAPSHOT.jar

3. Edit the NotificationResource_en_US.properties file with your customizations, located under the corresponding application JAR path in the com/edocs/application/resources directory (or the com\edocs\application\resources directory on Windows).
4. Repackage the JAR and EAR files at the application server console and deploy the EAR files. For instructions on how to deploy an application EAR file, see Installation Guide for Oracle Self-Service E-Billing.
5. Generate a new email template XML file:
   1. Modify the template generator script for your implementation. The template generator script generates an email notification template XML file based on the notification properties file. Change to the EDX_HOME/bin/notification directory (or the EDX_HOME\bin\notification directory on Windows). In the generateEmailTemplate.sh file script found in this directory (or the enerateEmailTemplate.cmd file on Windows), update the value of EDX_HOME and using the full path names for your installation. If you have saved the Billing and Payment application ear file in a new location, update the path to the ear file in the EBearfile variable(the default is EBearfile="$EDX_HOME/J2EEApps/ebilling/weblogic/ebilling-weblogic-10-6.0.4.ear").
   2. Run the template generator script to regenerate the template_en_US.xsl file:

      UNIX: ./generateEmailTemplate.sh -l en_US

      Windows: generateEmailTemplate.cmd -l en_US

6. Restart the application servers.