The configuration here only describes in detail how to configure SMS notification on the server side. How to subscribe some alert by SMS is the same with by Email.
1. Setting up sms.xml
<?xml version="1.0" encoding="UTF-8"?>
Above is a snippet of sms.xml. There are three places to set to make your SMS notification work.
1. Enabled: set it to be "true"
2. Value for SMS.vendor.classname: set it to be the full class name of SMSNotifier implementation.
For CellTrust, the value is:
For Clickatell, the value is:
3. Value for SMS.vendor.reload: set it to be "true" when in development environment, while "false" for production.
Notes: The SMS.vendor.reload is used to set whether to reload properties every time when creating a SMSNotifier implementation instance. When in production environment, the properties for the vendor generally remains the same, and it's not necessary to reload the properties from files.
2. Setting up Vendor's Properties
New properties files are added to define the properties used by vendors.
1. For CellTrust:
There are four essential entries for CellTrust:
Set proper values to these entries. All these values could be provided by the CellTrust.
If other information is correct and still can't send message out, please contact CellTrust to verify whether the service.host (gateway) has changed to another.
The customer.abbrev means the customer abbreviation code provided by CellTrust.
2. For Clickatell:
There are three essential entries for Clickatell:
Set proper values to these entries. All these values could be provided by the Clickatell.
Notes: If other information is correct and still can't send message out, please contact Clickatell to verify whether the service.host (gateway) has changed to another.
3. Vendor's API
Get API jar files from $WDF_INSTALL_FOLDER$/WPFDesigner/addons/dashboard/sms/, and copy them to WEB-INF/work/lib/ folder.
4. Using Multiple Vendors
If users want to leverage multiple vendors to send SMS at same time, it could be done by adding other SMSNotifier implementation classname, separating by comma, to the value of SMS.vendor.classname.
In this case, user might receive duplicate messages from different vendors.
The UI of MyAlertsPortlet for subscription and notification doesn't change. User should subscribe some alert definition by SMS in Subscription page, and type in the mobile phone number in Notification page.
If user wants to switch to another vendor, he could only modify the Value for SMS.vendor.classname in sms.xml, and make it deploy to server. No application/portal restart is needed.