Defining an Outlet

In this section:

How to:

Outlets contain references to preemitters, encryptors, and emitters. Once a document has been processed, it must be sent to one or more designated recipients. This is the job of the outlet. The outlet is responsible for all aspects of preparing the document for emission and then emitting it.

Outlets contain a sequence of components tailored for this task. Multiple outlets can be configured for a single message flow. Each outlet incorporates all of the components needed to send the message to its destination.

A channel must contain an outlet. However, a default outlet, which contains no emitter, can be used. When you assign an empty outlet to a channel, the document output goes back to the listener assigned to the inlet and is emitted through whatever output is specified in the listener.

Preemitters convert the document from the internal format to an external format. This may include simply flattening XML or may be more complex, involving transformation logic. An example is converting the document to an EDI or HIPAA format. Preemitters can also be chained, so the output of one becomes the input to the next. The first preemitter receives the document in internal form, and transforms it to a message format. Subsequent preemitters can perform extra work on this message. Transformations are prepared using the iWay Transformer. For more information, see the iWay Transformer User’s Guide.

Encryptors operate on the message that is ready for emitting. Parameters such as the location of encryption keys or certificate aliases can be stored by destination address in the optional iWay Trading Manager component. For more information, see the iWay Trading Manager User’s Guide.

The emitter uses the appropriate transport protocol to send the document to its destination. Examples include JMS, HTTP, email, and AS2. Header information that has been prepared by processes and stored in special registers is applied to the message in a format-appropriate manner.


Top of page

x
Procedure: How to Define an Outlet

To define an outlet using the iWay Service Manager Administration Console:

  1. In the left console pane of the Registry menu, select Outlets, as shown in the following image.

    The Outlets pane opens, as shown in the following image.

    The table that is provided lists each outlet that is defined with a brief description. If you click the document schematic icon in the References column for a specific outlet, you will see which components are referencing that outlet.

  2. Click Add.

    The New Outlet Definition pane opens, as shown in the following image.

  3. Enter a name, for example, SampleOutlet, and description for the outlet.
  4. Click Finish.

    The Construct Outlet pane opens, as shown in the following image.

    The table that is provided is used to list the components that are currently registered with the outlet.

  5. Click Add.

    The Select component type pane opens, as shown in the following image.

    The table that is provided lists the component types you can select and register with the outlet you are defining.

    • Emitter. Protocol handlers that send the output of a channel to a configured end point.
    • Preemitter. A logical process that handles documents immediately prior to transmission, for example, converting an XML document to non-XML.
    • Encryptor. Used to encrypt a document.

    An outlet that does not contain an emitter is considered a default outlet, whose emitter is defined by a channel’s inlet listener. A default outlet defines an empty outlet.


Top of page

x
Outlet Strategies

iWay Service Manager provides mechanisms to support various routing strategies when using outlets. This section describes how you can use iSM to execute business logic and route documents to a particular location. The following topics are provided:



x
Procedure: How to Add Conditions to Outlets

To add conditions to outlets:

  1. Open the channel you want to edit.
  2. Click the add conditions icon in the outlet for which you want to set conditions.

    The Set Conditions pane appears.

  3. Provide the condition, and then click Back to return to the channel pane.

    The icon changes to the Edit icon to indicate that a condition has been set.

    If multiple outlets are defined for a channel and no conditions are added to the outlets, all of the outlets will be processed by iWay Service Manager.



x
Procedure: How to Configure Outlet Run-Time Options

To configure outlet run-time options:

  1. Open the channel you want to edit.
  2. Click the check icon for the outlet you want to modify to set the run time option from On Success to On Error or the other way around, as appropriate.

iWay Software