The installation and configuration tasks for the e-Mail adapter
depend on the roles it must fill in the WebSphere business
integration system. Read the sections below to determine what tasks
you must perform based on how you will be using the e-Mail
adapter.
- Note:
- If you are installing the e-Mail adapter as a stand alone
system, see the installation guides for further instructions,
System Installation Guide for Windows or the
Implementation Guide for WebSphere MQ Integrator
Broker.
If the adapter must poll for new e-Mail messages in an
application and send them to the integration broker for processing,
perform the following steps:
- Install the adapter as described in "Installing the e-Mail adapter and
related files".
- Configure the mail server and mailboxes for poll locations. For
information, see "Configuring
mail servers for polling".
- Create the business
objects required to support the interface. For more information,
see Developing business objects
for the adapter.
- Create or modify a
meta-object for the data handler that the adapter uses to process
the data. For more information, see Data handler meta-objects.
- Create and configure a
poll meta-object to contain a child meta-object for each poll
location. For more information, see Using e-Mail adapter
meta-objects.
- Configure the mail servers that the adapter will be polling as
described in "Configuring mail
servers for polling".
- Configure the adapter definition as described in Configuring the adapter definition.
Keep the following points in mind:
- You must add the business objects developed for the interface
in 3 as supported business objects for
the adapter.
- You must add the poll meta-object created in 5 as a supported object for the adapter.
- You must add the data handler meta-object created in 4 as a supported object for the adapter.
- You must configure the properties of the adapter; because the
adapter will be polling, you must be sure to set the value of the
PollConfigMO property to the name of the poll meta-object created
in 5.
- Run the adapter as described in "Starting the connector".
If the adapter must receive business objects from the
integration broker and process them, perform the following
steps:
- Install the adapter as described in "Installing the e-Mail adapter and
related files".
- Create the business objects required to support the interface.
For more information, see Developing business objects for the
adapter. These business object will include a top-level wrapper
business object that contains routing information for the adapter.
For more information, see Using
e-Mail adapter business objects.
- Create or modify a meta-object for the data handler that the
adapter uses to process the data. For more information, see
Data handler
meta-objects.
- Configure the adapter definition as described in Configuring the adapter definition.
Keep the following points in mind:
- You must add the business objects developed for the interface
in 3 as supported business objects for
the adapter.
- You must add the data handler meta-object created in 4 as a supported object for the adapter.
- You must configure the properties of the adapter.
- Run the adapter as described in "Starting the connector".
- Note:
- Using the adapter for Error Notification (InterChange Server
Integration Broker Only)
If your integration broker is InterChange Server and the adapter
will be used for e-mail notification of errors, perform the
following steps:
- The e-Mail adapter is automatically installed if your
integration broker is InterChange Server, for the reason that it
plays such a significant role in error notification, so you do not
have to perform any installation tasks. Proceed to configure the
adapter properties as described in Configuring the adapter
definition.
- Configure the Email Notification business object as described
in EmailNotification business
object.
- You must configure other InterChange Server components for
e-mail notification. For information on setting up e-mail
notification of errors, refer to the System Administration
Guide.
- Run the adapter as described in Starting the connector.
