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

Customizing the Content of Notifications


Oracle Self-Service E-Billing provides email and SMS notification templates for each type of message it supports. The content for each type of notification is described in Email Notification Template Content in the Business Edition and Email Notification Template Content in the 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 template XSL files using the automated template generator. The notification properties file contains the strings and text used in the composition of messages.

Oracle Self-Service E-Billing can send 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. 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. You customize email and SMS notifications separately.

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-Billing applications, then 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 or SMS notifications

  1. Verify that Oracle Self-Service E-Billing is installed and deployed.
  2. Edit the notification resource properties file, such as NotificationResource_en_US.properties or NotificationResourceSms.properties, with your customizations. The files are located in the following directory:
    • UNIX. EDX_HOME/config/resourcebundle/com/edocs/application/resources/
    • Windows. EDX_HOME\config\resourcebundle\com\edocs\application\resources
  3. Generate a new email or SMS template XML file:
    1. Edit the template generator script for your implementation, located in the following directory. The template generator script generates an email or SMS notification template XML file based on the notification properties file.
      • UNIX. EDX_HOME/bin/notification/generateNotificationTemplate.sh
      • Windows.EDX_HOME\bin\notification\generateNotificationTemplate.cmd
    2. Update the value of EDX_HOME and using the full path names for your installation.
    3. Run the template generator script. To generate the email template file, template_en_US.xsl, run the following command:
      • UNIX. ./generateNotificationTemplate.sh -l en_US -t sms
      • Windows. generateNotificationTemplate.cmd -l en_US -t sms

        To generate the SMS template file, template_sms_en_US.xsl, run the following command:

      • UNIX. ./generateNotificationTemplate.sh -l en_US -t sms
      • Windows. generateNotificationTemplate.cmd -l en_US -t sms
  4. By default, Oracle Self-Service E-Billing automatically detects updates to the external resource files every five minutes. If you have turned this feature off in the global configuration file, then you must manually restart the server for the notification changes to take effect. For more information about automatic detection of changes to resource files, see Changing the Frequency of Automatic Resource File Updates.
Implementation Guide for Oracle Self-Service E-Billing Copyright © 2014, Oracle and/or its affiliates. All rights reserved. Legal Notices.