Email Notification Configuration
Configuring email notifications
To configure email notification settings:
- Navigate to [as.root]/bpel/system/services/config
- Open ns_emails.xml
- Replace the parameter values with the desired values
Remember to backup the file ns-email.xml. You do not have to setup the incoming server.
Notification parameters
The parameters can be edited by replacing the values in the xml tags. The configurable parameters include the following email notification settings:
- Notification mode - Must be set to EMAIL in uppercase letters.
- From Name
- From Address
- SMTP host
- SMTP port
- Server
- Port
- Protocol
- Username
- Folder
Consolidated Email
Email notifications must be configured correctly and enabled before Consolidated Emails can be enabled.
By default, users receive one email per notification, there is no mechanism for requesting that notifications be consolidated and delivered at a specified time.
The ReadSoft Notification Service is an adapter to that service which will receive the notifications and then deliver them as specified by scheduling parameters configured in PROCESSIT.
Delivery can be scheduled for Immediate, Daily or Weekly frequencies at Site, Organization or User levels. The notifications are persisted by PROCESSIT ensuring that even if your mail server is unavailable or the SOA Suite Server must be restarted, your notifications will be delivered. The notifications themselves allow access to PROCESSIT or PROCESSIT Mobile similar to standard email notificaitons.
- Immediate - Immediate is similar to the current SOA BPEL email notification option of one email per notification.
- Consolidated - Consolidated emails send a Summary of Worklist Tasks as an attachment.
Worklist Summary Attachment
The Summary of Worklist Tasks Attachment is an html table with your notifications listed by date notification received. You may click on Open Task Form links to access PROCESSIT. Approval Tasks also include a PROCESSIT Mobile link if that Add-On Module is installed.
Administrative Alerts
Administrative Alerts are sent each night that any notifications have reached the retry limit. This usually involves the mail server not being reachable from the Oracle SOA database, though it could be related to mail server configuration or HTTP ACL settings required for this mail server hostname in Oracle database version 11 or above. The ReadSoft Notification Service will attempt up to 5 retries delayed by 5 minutes, 15 minutes , 2 hours and 1 day before reporting the notification as undeliverable.
Console Notifications
A Console Notification will be sent to the Workflow Administrator if there are any interruptions of service detected during the delivery of email notifications.
Consolidated Notification Setup
Consolidated email notifications can be enabled via the configuration parameter Consolidated Email Schedule. A string builder tool can be accessed to assist you in building a string for the parameter that matches your schedule requirements. Click the edit icon next to the parameter value field to access the string builder tool.
RNS Daily Worklist Notifications.
Daily Worklist Notifications are different from Consolidated emails. Consolidated emails are batches of current notifications, while Daily Worklist Notifications contain any task from your worklist regardless of age.
Daily Worklist Notifications are enabled by the configuration parameter Daily Worklist Summary Email Schedule. Using this parameter, you can schedule the job using the levels SITE and USER.
A SITE level parameter setting controls the main Daily Worklist scheduled job and will send emails to everyone with a current task assigned to them. You can overwrite this by setting a specific USER level parameter setting for certain users. The default value is FREQ=NONE; which means the functionality is disabled.
A USER level parameter settings controls the defined user's Daily Worklist scheduled job and will send the user emails containing any current task assigned to them. Any USER level parameter setting excludes the user from the main SITE job. To disable Daily Worklist Notifications for a user, set the parameter setting value to FREQ=NONE;.
In the case where you have many users and you only want a few to receive Daily Worklist emails, you would set SITE Level to FREQ=NONE; and define the same FREQ=DAILY; schedule for each of the users that want to participate. Conversely, if you want all but a few to receive Daily Worklist emails the SITE Level FREQ=DAILY; and FREQ=NONE; for each user you want to exclude.
You may use the schedule builder icon to access the Schedule Builder for this parameter and valid settings are NONE, DAILY or WEEKLY. For example to schedule it for 7:00am each day FREQ=DAILY; BYHOUR=7; BYMINUTE=0;
The order of tasks in the email is the same as in your standard application worklist, with urgent or potential discounts at the top.
RNS translation
There is language translation support for all of RNS.
The configuration parameter Email Date Format controls the display date format for all RNS emails.
The configuration parameter Default language to use for offline communication controls language lookup if the Translation Workbench entries exist.
Decimal and Group separators for amounts like Total Amount for invoices are defaulted from Oracle EBS Profile settings for ICX_NUMERIC_CHARACTERS.
Month translations in dates are created by setting NLS_DATE_LANGUAGE. The value is the nls_language value from Oracle EBS fnd_languages which represented by the iso language code defined in D4_LANGUAGE. For example da uses DANISH, es uses SPANISH and us uses AMERICAN.