Skip Navigation Links | |
Exit Print View | |
Oracle Java CAPS Email Binding Component User's Guide Java CAPS Documentation |
Using the eMail Binding Component
About the eMail Binding Component
eMail Binding Component Features
eMail Binding Component Protocols
Working With the eMail Binding Component WSDL Document
Creating the eMail BC WSDL Document
To Create a WSDL Document to Read email (IMAP or POP3)
To Create a WSDL Document to Send email (SMTP)
New WSDL Wizard Properties for the eMail BC
Configuring eMail BC WSDL Attributes
To Configure eMail BC WSDL Attributes
To Send email Messages with Attachments
eMail Binding and Service Level WSDL Attributes
Configuring the eMail Binding Component Runtime Properties
To Configure eMail Binding Component Runtime Properties
eMail Binding Component Runtime Property Descriptions
Creating Application Configurations for Connectivity Parameters
To Create Application Configurations
To Add the Application Configuration to the Endpoint
To Change Application Configuration Values
To Create an Application Variable
To Change an Application Variable Value When the Application is Running
To Use an Application Variable for Password Protection
Using eMail BC Normalized Message Properties in a Business Process
Using Predefined Normalized Message Properties
To Define Normalized Message Properties in Mapper View
To Define Normalized Message Properties in Source View
Normalized Message Properties for the eMail Binding Component
The eMail Binding Component provides external connectivity for email servers, and supports sending email messages using the SMTP protocol and receiving email messages using the POP3 and IMAP protocols. Binding components implement the protocol transformations between abstract messages handled by the JBI Service Engines and concrete messages of the protocol. Other JBI components, such as the BPEL Service Engine, can leverage the eMail Binding Component to transform and route the messages.
The eMail Binding Component sends messages to, and retrieves messages from, an email server using the JavaMail API. This allows you to automate email operations that currently need to be performed manually. You can log into a server, generate email messages, specify recipients, and add subject lines, content, and attachments. You can also save attachments from incoming email messages.
Note - You can access the JavaMail documentation here: http://www.oracle.com/technetwork/java/index-138643.html.
The eMail Binding Component WSDL file defines server connectivity and email handling using a set of extensibility elements. The WSDL extensibility elements are part of the binding and service sections of WSDL documents. Both the binding and service sections of a WSDL document must be properly configured to determine the source of a message, how the message is transformed, and the destination of that message.
The eMail Binding Component provides the following features and functionality to Java CAPS:
Gives Java CAPS applications the ability to read and send email messages.
Provides easy configuration through a wizard that guides you through the steps of creating an email WSDL document.
Allows you to dynamically set server properties and email handling information using normalized message properties in a BPEL process.
Allows you to define application variables and configurations so you can port your email applications from one environment to another.
Supports SMTP, POP3, and IMAP protocols.
Supports Secure Sockets Layer (SSL), providing secure communication channels for data exchanges, safe from unauthorized users.
Allows you to store incoming attachments and attach files to outgoing messages, including text, HTML, XML, and image files.
Supports several character encoding types to enable sending email messages in multiple languages.
The eMail Binding Component takes advantage of the following widely-used, standard protocols. The protocols you use depend on your email server configuration.
POP3 (Post Office Protocol): Used to retrieve email message from an email account.
IMAP (Internet Message Access Protocol): Used to retrieve email message from an email account.
SMTP (Simple Mail Transfer Protocol): Used to send email messages to email accounts.
You can configure the server connectivity properties and message handling information in several different places for the eMail Binding Component. Each of the following areas configures the binding component in a different scope.
New WSDL Wizard: When you create the WSDL file for the eMail Binding Component, you can configure all of the connectivity and email handling properties. The wizard generates the appropriate extensibility elements and attributes in the WSDL file.
WSDL File Elements: Once you create the WSDL file, you can update the extensibility elements and attributes directly in the WSDL file. The values you supply here only apply to the specific eMail Binding Component that the WSDL file represents.
Application Configurations: You can configure server connectivity properties that override those same properties in the WSDL file and apply them to an endpoint in a Composite Application. This allows you to easily deploy the Composite Application within different environments.
Normalized Message Properties : When you connect an Email Binding Component to a business process, the normalized message properties are made available in the BPEL Designer Mapper. These properties allow you to assign property values dynamically based on message content.
There are several sample projects for the eMail Binding Component to help you get started with the eMail BC and further understand the information and instructions provided in this document. To download the samples and read information on how to run them, go to http://wiki.open-esb.java.net/Wiki.jsp?page=EmailBC.