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

Contents

Introduction
Deploying the OracleAS Email Portlet
Publishing the OracleAS Email Portlet

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

Introduction

This implementation of the Email portlet supports the following set of features:

• Integrates Internet Message Access Protocol (IMAP) Server with OracleAS Portal.
• Lists all messages received in the INBOX Folder.
• Renders the message content in the same portlet container (inline).
• Allows easy navigation between messages.
• Allows mail ordering and pagination.
• Allows mail messages to be sent to wide range of addresses.
• Integrates with the Single Sign-On (SSO) Server being used by your OracleAS Portal, to provide LDAP Address Book mappings.
• Allows Users to pick the addresses from Oracle Identity Management while composing mails.
• Provides Reply, Reply All & Forward messages functionality.
• Allows rich set of mail formats to be read (multipart mails).
• Allows messages to be sent in Text, HTML or both the formats.
• Allows attachments to be sent with the messages.
• Allows attachments to be downloadable from the messages.
• Allows the user to compress/expunge the required folder.
• Allows users to list messages from multiple folders.
• Provides user friendly interface to interact with.

The Email portlet allows the page designer to customize it to supply the following details:

• Mail Server configuration details
• Oracle Internet Directory (OID)/LDAP Configuration

User Interface

When added to an OracleAS Portal this portlet provides the following user interface components:

Show Mode

Message Content Page

Compose Message Page

Deploying the OracleAS Email Portlet

Publishing the OracleAS Email Portlet

Creating the External Application

• Log on 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:EmailExternalApp
• Login URL: http://your_oc4j_hostname:port/email/login
• User Name/ID Field Name:user
• 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
imap.host	imapServerName.domain	Check this box
imap.port	<you can enter -1 to select a default port>	Check this box
smtp.host	smtpServerName.domain	Check this box
smtp.port	<you can enter -1 to select a default port>	Check this box

• Click OK. 
• Now click on the link for your new EmailExternalApp application and enter the Username and Password.  While supplying the values, you should ensure that user field contains user name with the domain information, e.g username@domain

  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 "Failed to authenticate the user with the credentials supplied." message.
  
• If failed, 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 Email Provider:
• Name: EmailProvider
• Display Name: Email Portlet Provider
• Timeout: 100
• Timeout Message: Email 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/email/providers/email
6. Select the radio button labeled The user's identity needs to be mapped to a different name.... 
   
7. In the External Application ID field, select the ID corresponding to EmailExternalApp application you created in the previous step.
8. Scroll down to the User/Session Information section and specify the login frequency as Once Per Session.
9. Click on the Finish button to complete the registration

Adding the OracleAS Email Portlet to a Page

Note: If you are logged on as a user other than the OracleAS Portal administrator,  you will be asked to update the login information for the External Application before you can view messages within the portlet.  Click on the Update Login Information link and enter your Email user credentials: Username, Password, imap.host, imap.port, smtp.host and smtp.port to view information within the portlet.

While supplying the values, you should ensure that user field contains user name with the domain information (username@domain) e.g: john.deo@oracle.com.

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.