OracleAS Portal Integration Solutions
Oracle Application Server SMS Portlet - Installation Instructions

Contents

Features
Deploying the OracleAS SMS Portlet
Publishing the OracleAS SMS Portlet

Creating the External Application
Registering the Portlet Provider 
Adding the OracleAS SMS Portlet to a Page

Features

The greatest application of SMS is as a delivery mechanism for mobile information services. Initially, the success of SMS was limited to two-way communication between mobile handsets.  The use of SMS as a "Push" technology has spurred the demand for Web based messaging, which has been addressed by the OracleAS SMS Portlet.  This portlet can be used to send an SMS from Oracle Application Server (OracleAS) Portal to a mobile device.  It provides an efficient web based messaging interface for OracleAS Portal customers to send an SMS to anyone, anywhere on any mobile device.

The OracleAS SMS Portlet leverages OracleAS Wireless Push Service and Transport Architecture to send an SMS to any mobile device.  The user of this portlet would need to get an account with OracleAS Wireless Service team. However, to encourage the use of this service, a trial account of 1000 units (where each SMS message uses 10 units) per IP address has been permitted.  For purchasing more units and know more the about Push Service pricing mechanism, you can send an e-mail to messenger_us@oracle.com

This document describes how to install the OracleAS SMS Portlet.

Screen Shots

Show Mode

Using this portlet you can send an SMS to any number of recipients across the world, via its simple webmail like interface.  However, the sender's and recipients' mobile phone numbers should be specified in the following format,
               countrycode-areacode-localnumber e.g. 1-650-5551212
       For multiple entries, comma should be used as a separator e.g.1-650-5551212,1-650-5551313

Edit Mode

Deploying the OracleAS SMS Portlet

Publishing the OracleAS SMS Portlet

Creating the External Application

• Login to OracleAS Portal as a OracleAS Portal Administrator.  Go to the Administer tab of the OracleAS Portal Builder.  In the SSO Server Administration portlet, click Administer External Applications.
• Click on Add External Application.  In the External Application Login and Authentication Method sections, enter the following:
• Application Name: SMSExternalApp
• Login URL: http://your_oc4j_hostname:port/sms/login
• User Name/ID Field Name: Username
• Password Field Name: Password
• Type of Authentication Used: Select POST
In the additional field section, add the following:
 

Field Name	Field Value	Display to User
serviceURL	http://messenger.oracle.com/push/webservices	Check this box
trialUser	<if trial user then write YES else NO>	Check this box
proxyHost	<Optional, specify the proxy host name>	Check this box
proxyPort	<Optional, specify the proxy port number>	Check this box

 
Note: serviceURL and trialUser values must be passed.  Only specify the proxyHost and proxyPort values if you are accessing the service URL through a proxy.  If you are in the same domain as the hosted service, then DO NOT specify these values.

• Click OK.  
• Then click on the link for your new SMSExternalApp application and enter the Username and Password.  Please note:
  • If you are a trial user (i.e. specified field value YES for trialUser), then you can enter any username and password. The username and password fields are immaterial for trial users, as they have an account of 1000 units per IP address. 
  • If you are not a trial user (i.e. specified NO for trialUser), you need to specify the username and password that has been given by the OracleAS Wireless Push Service team. The 'Remember My Login Information...' checkbox must be checked.
• If successful, you should get the message like "You have successfully registered with Portal".
• If unsuccessful, you will get an "Unsuccessful Registration Message" and messages ighlighting the cause of failure. Go back to the External Application and pass the right credentials.

Registering the Portlet Provider

1. Login to OracleAS Portal using an account that has build privileges. If your home page is not the Build/Administer page, click on the Builder link in the top right corner of the screen. Click on the Build tab if that is not the active tab.
2. Under the Build tab (on OracleAS Portal Home Page), click on Register Portlet Provider within the portlet called Providers.
3. Fill out provider information for the SMS Portlet Provider:
• Name: SMSProvider 
• Display Name: SMS Portlet Provider
• Timeout: 100
• Timeout Message: SMS Portlet Provider Timed Out
• Implementation Style: Web
4. Click on the Next button to enter the Web Provider specific information
5. Enter the Web Provider location
• URL: http://your_oc4j_hostname:port/sms/providers/sms
6. Scroll down to the User/Session Information section and specify the login frequency as Once Per Session.
7. Select the radio button labeled The user's identity needs to be mapped to a different name....  In the External Application ID field, select the ID corresponding to SMSExternalApp application you created in the previous step.
8. Click on the Finish button to complete the registration

Adding the OracleAS SMS Portlet to a Page

Trademarks

Oracle and the Oracle logo are trademarks or registered trademarks of Oracle Corporation in the United States and other countries.

All other names are trademarks and/or registered trademarks of their respective owners.