Creating a Simple Orchestration

If you have not already done so, review Understanding Orchestration.

Before defining the data flow with Orchestration Editor, the client messages and server messages should be defined.

  1. In the ePortal Message View window, click the Open Orchestration icon (). The Orchestration.eporch tab is displayed. At a minimum the following event handlers are present:

    • OnClient Session Start

    • OnClient Session End

  2. Ensure that the Toolbox window is present. The various activities presented in the Toolbox can be added to these event handlers. Refer to Orchestration Toolbox Selections for information about each activity.

  3. Modify the On Client Session Start event handler if necessary. Refer to:

  4. If necessary, create an On <client message name> event handler for each client message received from the client and add activities to the Start node that are needed to process this request.

    Refer to Adding a Basic Client Request Event Handler.

    Note: For cases where there is a simple mapping between a client message and a server message with the same name, you may be able to avoid explicitly creating an On <client message name> event handler. Refer to Using Map and Forward to Simplify Orchestration.

  5. Modify the On Client Session End event handler if necessary.

Adding a Basic Client Request Event Handler

The following procedure sends a server message to the ClearPath server application, gets a server message back from the ClearPath server application, and sends a client message to the client.

  1. In the ePortal Message View window, select the appropriate client message and drag it to the root of the orchestration tree. The On <client message name> node is added to the tree and the client message appears in the Client Messages node of the event.

  2. In the ePortal Message window, select the server message to be sent to the ClearPath server, drag it to the Start node of the client request event, and click InvokeServer. The Send property is set and the server message appears in the Server Messages node of the event.

  3. In the Properties window, do the following:

    1. Select the server message to be received in the Receive property. The server message appears in the Server Messages node of the event.

    2. Click the MessageData property, and click the selection button on the right. Make any necessary changes in the Assign Data for Message dialog box and click OK. Refer to Assign Data for Message Dialog Box for details.

  4. In the ePortal Message window, select the client message to be sent to the client, and drag it to the Start node of the client request event. An OnClientReply activity appears in the orchestration tree and the client message appears in the Client Messages node of the event.

  5. In the Properties window, click the MessageData property, and click the selection button on the right. Make any necessary changes in the Assign Data for Message dialog box. Refer to Assign Data for Message Dialog Box for details.