Build it yourself

To build, test and run the hello world sample, follow these steps:

Create a new module

To create the HelloWorld module, complete the following steps:

  1. In the Business Integration view, click Click to add a business integration project under Projects.
    (Alternatively: from the menu bar, select File > New > Module).
  2. The New Business Integration Project window opens. Make sure Create a module is selected.
  3. Click Next.

    4. The New Module window opens.

  4. In the Module Name field, enter HelloWorld.
  5. Click Finish. The module will be created. Wait until the automatic build process has finished.

Develop hello world business process

Create the business process

To create the Hello World business process, complete the following steps:

  1. Switch to the Business Integration view.
  2. In the navigation tree, expand HelloWorld and right-click Integration Logic.
  3. From the pop-up menu, select New > Business Process.

    4. The New Business Process window opens.

  4. Make sure New default Business Process is selected.
  5. In the Name field, enter HelloWorldProcess.
  6. In the Folder field, enter bpc/samples.
  7. Accept the default value for the namespace.

  8. Click Next.
  9. In the Select a New Business Process Type panel, select Microflow.

  10. Click Next.
  11. In the Select an Interface panel, select Generate a new Interface. This generates a predefined process interface, which is ok for this first sample; usually you will first define the process interface and subsequently create the process using that interface.

  12. Click Finish.

Edit HelloWorldProcess

Add a snippet activity

  1. Click the Snippet icon on the palette.

    2. To find the snippet icon, it may be necessary to expand the Palette by clicking on Basic Actions. The list of activities will be displayed.

  2. Click the connection between Receive and Reply

    3. The Snippet activity is added.

Implement the snippet activity

  1. In the business process editor, click the Snippet activity.
  2. In the properties view, click the Details tab.
  3. Select Java as implementation type.

  4. If the Question dialog appears, click Yes.

  5. In the text area, enter the following Java code:

    6. //print the greeting:
    System.out.println("Hello, " + input1);
    //assign a value to the Output variable:
    input1 = "Hello World!";

  6. On the toolbar, click the Save button .

Add the hello world process to the module assembly

To complete the implementation of the module, follow these steps:

  1. Switch to the tab HelloWorld - Assembly Diagram.
    Note: If the Assembly Diagram of HelloWorld is not opened by default, double-click on HelloWorld > Assembly Diagram in the Business Integration view.

  2. Expand Integration Logic > Processes > bpc\samples.
  3. Drag and drop the HelloWorldProcess to the HelloWorld - Assembly Diagram.

  4. On the toolbar, click the Save button .

Test the hello world process in the integrated test environment

Install hello world process to the test environment

  1. In the Servers view, click the Servers tab.
  2. Ensure that the status of WebSphere Process Server v7.0 is Started. If the status is Stopped or not displayed, right-click WebSphere Process Server v7.0 and select Start.
  3. From the table, right-click WebSphere Process Server v7.0.
  4. From the pop-up menu, select Add and Remove Projects.

    5. The Add and Remove Projects window opens.

  5. In the Available projects list, select the HelloWorldApp.

  6. Click Add. The HelloWorldApp project is moved to the Configured projects list.

  7. Click Finish. Wait until the automatic publishing process has finished.

Run hello world process using the BPC Explorer

Refer to the Run the Sample section on how to run the hello world process in the integrated test environment.

Configure the Business Object Runtime Framework (optional).

With WebSphere Integration Developer 7.0.0.1 and higher, you can configure the business object runtime framework. The version 7 framework uses partial parsing in a lazy manner which leads to performance improvements in certain scenarios.

Note: This new mode has the status "Technical preview" and is not recommended for production purposes yet.

To enable the new version 7 business object runtime framework, follow these steps:

  1. Switch to the Business Integration view.
  2. In the navigation tree, right-click HelloWorld module.
  3. From the pop-up menu, select Properties.
  4. In the Properties window, expand Business Integration and click Business Object Runtime Framework.

  5. Select Version 7.
  6. Click Ok.

Generate and export enterprise application

If you want to run your business process on a WebSphere Process Server, you have to create an enterprise application. Then, you can install this enterprise application to your WebSphere Process Server.

To create an enterprise application for the Hello World business process, follow these steps:

  1. Switch to the Business Integration view.
  2. In the navigation tree, right-click HelloWorld module.
  3. From the pop-up menu, select Export.
  4. In the Export window, expand Business Integration and click Integration modules and libraries.
  5. Click Next.
  6. Select Files for server deployment.
  7. Select HelloWorld from the list below.
  8. Click Next.
  9. Select a target directory.
  10. Click Finish.

Generate documentation for the business process

You can create a PDF document that contains a detailed description of your business process.

To create the PDF document, follow these steps:

  1. Switch to the Business Integration view.
  2. Expand Integration Logic > Processes > bpc\samples.
  3. Right-click the HelloWorldProcess and select Generate Documentation.
  4. Specify the file name for the output in the field Location and adjust the other output settings according to your preferences.
  5. Press Finish.

The generated file will look similar to this: reportFile.pdf

Install the hello world process to WebSphere Process Server

Note: if you do not have a WebSphere Process Server besides the integrated test environment, you can skip this chapter.

To install the Hello World business process to WebSphere Process Server, follow theses steps:

  1. In a browser, open the administrative console.
    The default URL is
  2. If security is enabled, enter a valid User ID and Password. Click Log in.
  3. In the navigation pane, select Applications > New Application.
  4. Click New Enterprise Application.

  5. Click Browse and select the EAR file you created earlier.

  6. Click Next.
  7. In the Select installation options dialog, leave the default values.

  8. Click Next.
  9. In the Map modules to servers dialog, leave the default values.

  10. Click Next.
  11. Review the options in the Summary dialog.

  12. Click Finish. Your enterprise application will be installed.
  13. Wait until the installation process is finished. This may take some time.
  14. Follow the link to save the changes to the master configuration:

  15. Click Save. The Hello World process is now installed.

To start the Hello World business process, follow theses steps:

  1. In the navigation pane, select Applications > Application Types > WebSphere enterprise applications.
  2. Select HelloWorldApp and click Start.

  3. The HelloWorldApp application is started. You can now work with the HelloWorld business process.

Run the Hello World process on WebSphere Process Server

Refer to the Run the Sample section on how to run the Hello World process on WebSphere Process Server.

Uninstall the hello world process from WebSphere Process Server

  1. In a browser, open the administrative console.
    The default URL is
  2. If security is enabled, enter a valid User ID and Password. Click Log in.
  3. In the navigation pane, select Applications > Application Types > WebSphere enterprise applications.
  4. From the list of applications, click on HelloWorldApp.
  5. Under Modules, click Manage Modules.
  6. Click on HelloWorldEJB.
  7. Under Additional Properties, click Business processes.

  8. Make sure that no running or terminated process instances exist for this process template.
    Note: Process instances may exist in the following cases:
    • if you selected Long-running process as the Business Process type or under the Properties section,
    • and if you disabled the checkbox Automatically delete the process after completion in the Process Editor (by default, this checkbox is enabled).
  9. Select the HelloWorldProcess process template and click Stop. This makes sure no more process instances of this template can be started.
  10. In the message section, click Save.
  11. In the Enterprise Applications list, select HelloWorldApp and click Stop:

  12. In the Enterprise Applications list, select HelloWorldApp and click Uninstall.
  13. In the Uninstall Application screen, click OK:

  14. In the message section, click Save. The Hello World business process is now uninstalled.