Configuring the Sonic ESB Adapter

You can add and configure the Sonic ESB adapter workstep in your process by performing the following procedures.

1. Click the Assign Participants link in the Tasks pane. Expand the Adapters > Managed > SonicESBAdapters folder and drag the default GenericSonicESBAdapter (or a previously configured Sonic ESB adapter instance) to your Content pane, creating an Sonic ESB adapter workstep.

2. Select the workstep, and then right click and select Properties from the pop up menu to open its Properties view, and click the Configuration tab. This tab includes the Configure button and the Change mapping button for defining the adapter configuration and mapping respectively.

Note: You can also open the Sonic ESB Adapter Configurator using the Managed Adapter Browser (available only from Progress Developer Studio for OpenEdge) functionality. In addition to configuring, you can use the Managed Adapter Browser to perform functions like creating a copy, renaming, deleting, as well as importing and exporting the configuration information. For more information, refer to the "Using the Managed Adapter Browser" section of the OpenEdge Getting Started: Developing BPM Applications with Developer Studio.

4. From the Broker Alias box, specify the alias name of the Sonic execution server. You need to ensure that this broker alias name is added in the OEBPS_Home\conf\server-config.xml file. On activation of this adapter workstep, the configured properties for the specified alias are retrieved from the server-config.xml file and used to connect to the Sonic Broker in order to send or receive messages. An example of the alias name entry in the server-config.xml file is provided below:

    <Server name="SonicMachine">
        <Alias>SonicBroker</Alias>
        <Url>tcp://198.168.1.1:2506</Url>
        <SuperUser password="Administrator"
            encrypted="false">Administrator</SuperUser>
        <Description>Description</Description>
        <Category>category</Category>
        <Properties>
            <Property key="DomainName" value="Domain1"/>
        </Properties>
    </Server>

Note: On resuming a suspended adapter workstep, the server-config.xml file is refreshed.

5. Use the Domain Configuration properties to connect to the Sonic Domain Manager to fetch list of processes, services, and JMS Endpoints defined in that particular domain. You need to ensure that the Sonic execution server is running when configuring this option.

Note: The domain and URL values provided here are only used during configuration. At execution, the host and port values are retrieved from the server-config.xml file for the Broker Alias value provided.

6. Click Connect to connect to the Sonic Domain Manager. Once connected, the Send To, Reply, and Request Message tabs are enabled in the Sonic ESB Adapter Configurator.