IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Testing modules > Unit testing > Running unit tests in the test client > Manage test configuration module attachments

Attaching the integration test client to test configuration modules

If you want to use the integration test client to test modules and their components but you do not want to use the invocation mechanism of the test client to perform your testing, you can attach the integration test client to the modules using a test configuration and then use a different invocation mechanism for testing your operations, such as JMS messages, web services, or JSPs.

It is generally considered a "best practice" to attach the integration test client to your test configuration modules before you use your own invocation mechanism to start an operation. This enables the integration test client to deploy your module and start the server before your invocation progresses too far or even completes, which is essential for a short-running operation and generally desirable for a long-running operation. However, if you have a long-running operation and you only want to attach the integration test client to your test configuration modules at a particular point during the invocation, then you can start your operation before you attach the integration test client to the test configuration modules.

To attach the integration test client to a test configuration module:


Procedure

  1. To attach to a module from your local system, or from an IBM BPM, IBM Process Center Server, or WebSphere Enterprise Service Bus Server, complete one of the following steps:

    • If the integration test client is not open, right-click your module or assembly diagram in the Business Integration view and select Test > Attach to Modules on a Local Server. The integration test client opens and an Attach event is displayed in the Events area.

    • If the integration test client is already open for your module, click the down arrow beside the Invoke icon

      and then select Attach. An Attach event is displayed in the Events area.

  2. To attach to all modules in a process application or a toolkit, complete one of the following steps:

    • Right-click the process application in the Business Integration view and select Test > Attach to Process Application.
    • Right-click the toolkit in the Business Integration view and select Test > Attach to Toolkit.

  3. In the Events area, ensure that your Attach event is selected and then click the Continue icon

    . If the Deployment Location wizard opens, follow the instructions in the topic "Deploying modules from the integration test client".

  4. Start your operation using your preferred method, such as a JMS message, web service, or JSP.

  5. If the test pauses at a manual Emulate event in the Events area, specify output parameter values in the value editor or select an exception to throw, then click the Continue icon

    to continue the invocation. Information about specifying output parameter values and selecting exceptions for manual emulators is found in the topic "Specifying emulation values."

  6. If you want to save a test trace of your attach session to a test trace file, click the Save Test Client icon

    at any time. Information about saving test traces is found in the topic "Saving test traces."


Example

It is important to note that you can only attach a single instance of the integration test client to the modules of one test configuration at a time.

Manage test configuration module attachments