Using eMail BC Normalized Message Properties in a Business Process

You can define normalized message properties in a BPEL process in order to dynamically assign values to the runtime properties for the eMail Binding Component. The normalized message properties for each JBI component are accessed from the BPEL Designer Mapper view. When you expand a variable's Properties folder it exposes the variable's predefined NM properties, as well as the standard BPEL-specific WSDL properties used in correlation sets, assigns, and expressions . If the specific NM property you need is not currently listed, additional NM properties can be added.

Normalized message properties provide the following capabilities:

• Getting and setting transport context properties.

• Getting and setting request parameters.

• Dynamically configuring eMail properties.

Using Predefined Normalized Message Properties

Predefined normalized message properties are automatically available from the BPEL Designer's Mapper view. You can use additional properties by adding them directly to the source code. You can either define these properties using the BPEL Designer Mapper, or by entering the code directly into the source view.

You can perform additional tasks when working with normalized message properties, such as creating additional properties, deleting properties, creating property shortcuts, and so on. For more information, see Using Normalized Message Properties in Oracle Java CAPS BPEL Designer and Service Engine User’s Guide.

To Define Normalized Message Properties in Mapper View

1. Open the BPEL process you want to edit in the BPEL Designer.
2. In Design view, select the activity to add the normalized message property to.
3. In the BPEL Designer toolbar, click Mapper.
4. In the Output pane, expand the variable you want to edit, expand Properties, and then expand Email BC.
5. Expand Outbound or Inbound, depending on the message type.

   A list of available normalized message properties appears.

   
   
6. Select the normalized message property you want to use, and use the mapper operands to build an expression or assign a value.

   For a complete list of normalized message properties for the eMail Binding Component, see Normalized Message Properties for the eMail Binding Component.

To Define Normalized Message Properties in Source View

1. Open the BPEL process you want to edit in the BPEL Designer.
2. In the BPEL Designer toolbar, click Source.

   The BPEL source code for the process is now visible.

3. Declare the sxnmp namespace near the beginning of the process element; for example:

   xmlns:sxnmp="http://www.sun.com/wsbpel/2.0/process/executable/SUNExtension/NMProperty"

4. Define the property using the property names listed and described in Normalized Message Properties for the eMail Binding Component.

   For example,

      <copy>
         <from>'true'</from> 
         <to variable="SendEmailIn" 
             sxnmp:nmProperty="org.glassfish.openesb.email.inbound.usessl"/>
      </copy>

Normalized Message Properties for the eMail Binding Component

Normalized message properties are either specific to the binding component being used or generally available to all participating JBI components. The following topics describe both types of normalized message properties.

• General Normalized Message Properties

• eMail Binding Component Normalized Message Properties

General Normalized Message Properties

The following table lists and described the general properties that are available to all JBI components. All property values are of the type java.lang.String.

Table 13 General Normalized Message Properties

eMail Binding Component Normalized Message Properties

The following properties are specific to the eMail Binding Component. Available properties are different for request messages than for response messages. All property values are of the type java.lang.String, except the Number of Attachments, which is an integer.

Table 14 eMail Binding Component NM Properties (Inbound)

Table 15 eMail Binding Component NM Properties (Outbound)