Completing a to-do task for a binding that requires manual conversion

To complete the conversion of an export or an import and its binding, you must replace the Passthrough nodes for transport-specific IBM® Integration Bus message flow nodes, configure the message domain to specify the data parser that you want to use, and manually implement the function selector and the fault handling.

Before you begin

Check for any restrictions that apply to the use of message flow nodes for your version of IBM Integration Bus. For more information, see Restrictions that apply in each operation mode.

About this task

In IBM Integration Bus, you use a message flow node to recreate an export or an import and its binding. To specify the parser that you want to use to serialize or deserialize your data, you configure the Message Domain property. To handle faults, you connect the Fault terminal of a node and implement its logic. For exports only, you must manually implement the function selector when the WebSphere® Enterprise Service Bus mediation module is converted into an application.

Procedure

To finalize the conversion of an export or an import that is referenced by a WebSphere Enterprise Service Bus Callout mediation primitive, together with its binding, complete the following steps:

  1. In the Review results view, double-click the following to-do message: Manually convert the binding that has the following implementation class: ''{0}''.

    The Message Flow editor opens the message flow to show the placeholders created for your WebSphere Enterprise Service Bus mediation module exports and imports.

  2. Identify the Passthrough nodes for your export or import.

    The Passthrough nodes are named after your mediation module export or import. In the case of an export placeholder node that represent the response in a request-response operation, the placeholder node ends with _Reply.

  3. Identify the message flow nodes that you must use in IBM Integration Bus to recreate the export or the import binding configuration. For more information about IBM Integration Bus message flow nodes, see Built-in nodes.
    • For an export with an interface that defines one or more one-way operations, you must identify one Input message flow node. For example, if the transport associated with the export in WebSphere Enterprise Service Bus is of type MQ Binding, then you use an MQInput node to recreate the export.
    • For an export with an interface that defines at least one request-response operation, you must identify one Input message flow node and one reply message flow node. For example, if the transport associated with the export in WebSphere Enterprise Service Bus is of type MQ Binding, then you use an MQInput node and an MQReply node to recreate the export.
    • For an import that defines a synchronous interaction, you must identify one message flow node to handle the synchronous request and response interaction. For example, if the transport associated with the import in WebSphere Enterprise Service Bus is of type HTTP Binding, then you use an HTTPRequest node to recreate the import.
    • For an import that defines an asynchronous interaction, you must identify one message flow node to handle the request asynchronously, and one message flow node to handle the response asynchronously. For example, if the transport associated with the import in WebSphere Enterprise Service Bus is of type HTTP Binding, then you use an HTTPAsyncRequest node and an HTTPAsyncResponse node to recreate the import.
  4. Drag and drop the message flow nodes that you identified in the previous step onto the message flow, and configure them.
    • For an export, complete the following steps in order:
      1. Drag and drop the Input node that you identified for your export.
      2. Delete the Passthrough node. This node is the node that is named after your export.
      3. Rename your Input node: Select the node. In the Properties view, select Description. Edit the Node name property and enter the name of the export.
      4. Configure the message domain. In the Properties view, select Input Message Parsing. Configure the Message domain property by selecting a message domain. For more information, see Parsers.
      5. Configure other node properties.
      6. Drag and drop a RouteToLabel node to dynamically determine the route that a message takes through the message flow, based on its content.
      7. Optional: If the export has an interface with one operation, connect the output terminal of the Input node to the input terminal of the RouteToLabel node.
      8. Optional: If the export has an interface with multiple operations, you must implement the logic of the function selector.
        1. Drag and drop a JavaCompute node, or a Compute node, or a Mapping node.
        2. Connect the output terminal of the Input node to the input terminal of the JavaCompute node, the Compute node, or the Mapping node.
        3. Implement the function selector logic that is associated with your export.
        4. Connect the output terminal of the JavaCompute node, the Compute node, or the Mapping node to the input terminal of the RouteToLabel node.
      9. If there is a Passthrough node with the name YourExportName_Reply, where YourExportName is the name of your export, drag and drop the reply node that you identified in a previous step, and then replace the Passthrough node.
      10. Rename your reply node: Select the node. In the Properties view, select Description. Edit the Node name property and enter YourExportName_Reply, where YourExportName is the name of the export.
      11. Configure other node properties.
      12. Connect the output terminal of the operation subflow to the input terminal of the reply node.
      13. Implement the fault binding logic. Review the information available about the node to see how to handle errors and exceptions. For example, to learn how to handle MQInput errors, see Handling MQInput handling errors.
      14. Save your changes.
    • For an import that defines a synchronous interaction, complete the following steps in order:
      1. Drag and drop the node that you identified for your import.
      2. Delete the Passthrough node. This node is the node that is named after your import.
      3. Connect your node in the same way as the Passthrough node was connected.
      4. Rename your node: Select the node. In the Properties view, select Description. Edit the Node name property and enter the name of the import.
      5. Configure the message domain that you want to use to parse the response message. In the Properties view, select Response Message Parsing. Configure the Message domain property by selecting a message domain. For more information, see Parsers.
      6. Configure other node properties.
      7. Implement the fault binding logic. Review the information available about the node to see how to handle errors and exceptions.
      8. Save your changes.
    • For an import that defines an asynchronous interaction, complete the following steps in order:
      1. Drag and drop the asynchronous request node that you identified for your import.
      2. Delete the Passthrough node. This node is the node that is named after your import.
      3. Connect the asynchronous request node in the same way as the Passthrough node was connected. You connect the input terminal of the asynchronous request node only.
      4. Rename your node: Select the node. In the Properties view, select Description. Edit the Node name property and enter the name of the import.
      5. Configure other node properties.
      6. Depending on how the asynchronous response is correlated with the request, you can drag and drop the asynchronous response node onto the same message flow where you added the asynchronous request node, or to a new message flow.
        • If the request and response nodes are in the same message flow, IBM Integration Bus handles the correlation of the response to the request.
        • If you create a new message flow, you must implement the correlation of the request and response manually.
      7. In the asynchronous response node, configure the message domain that you want to use to parse the response message. In the Properties view of the asynchronous response node, select Input Message Parsing or Response Message Parsing. Configure the Message domain property by selecting a message domain. For more information, see Parsers.
      8. Configure other node properties.
      9. If you have one message flow to handle the asynchronous request and response, connect the output terminal of the asynchronous response node to the input terminal of the node to which the output terminal of the Passthrough node was connected.
      10. If you have different message flows to handle the asynchronous request and response, copy the part of the message flow that was connected to the output terminal of the Passthrough node into the new message flow. Then, implement the correlation logic between both message flows.
      11. Implement the fault binding logic. Review the information available about the node to see how to handle errors and exceptions.
      12. Save your changes.

What to do next

In the Review results view, right-click the to-do task. Select Complete.