Chapter 4. Hello World Project

To demonstrate basic features of Red Hat JBoss BPM Suite, this chapter will instruct you on how to set up the Hello World project with a Hello World business process. All that this business process will do, is display the Hello World! message and finish execution. For additional example that makes use of the full when-then rule functionality, see the Getting Started with Rules and Facts chapter from Red Hat JBoss BPM Suite Development Guide.

You will be instructed to do the following:

  1. Create a Hello World repository in the Artifact repository.
  2. Create the Hello World project with the Hello World business process definition.
  3. Model the Hello World process logic in the business process using the graphical Process Designer tool.
  4. Build and deploy the project on the locally running Execution Engine.
  5. Run the Hello World process.
  6. Monitor the process execution.

4.1. Creating Repository Structure

All business assets live in repositories that live in organizational units, which are directories in the artifact repository. By default, the artifact repository does not contain any organizational units. Therefore to be able to create your own business assets, such as a business process, you need to create an organizational unit in the artifact repository and a (Git) repository in it. The repository can then contain your project. A project can contain an arbitrary package structure, which allows you to structure its content into logical "directory" structure. Any package can contain your business assets (for more information on the artifact repository, see the Red Hat JBoss BPM Suite User Guide).

To create the repository structure, do the following:

  1. Open Business Central in your web browser and log in as a user with the admin role (for example helloworlduser).

  2. Create an organizational unit in the artifact repository:

    1. Go to Authoring → Administration.
    2. On the perspective menu, click Organizational Units → Manage Organizational Units.

    3. In the displayed Organizational Unit Manager view, click Add.

      In the displayed Add New Organizational Unit dialog box, define the unit properties and click Ok:

      • Name: helloworld
      • Owner: helloworlduser

  3. Create a new repository in the helloworld organizational unit:

    1. Go to Authoring → Administration.
    2. On the perspective menu, click Repositories → New repository.

    3. In the displayed New Repository dialog box, define the repository properties:

      • Repository Name: helloworldrepo
      • Organizational Unit: helloworld
    4. Click Finish.
  4. Go to Authoring → Project Authoring.

  5. In the Project Explorer in the organizational unit drop-down box, select helloworld, and in the repository drop-down box select helloworldrepo.

    Figure 4.1. Selecting the helloworldrepo Repository in the helloworld Organizational Group in Project Explorer

    project explorer

  6. Create a project in the helloworld repository:

    1. On the perspective menu, go to New Item → Project.

    2. In the displayed New Project wizard, define your project properties:

      • Project Name: HelloWorld
      • Group ID: org.bpms
      • Artifact ID: HelloWorld
      • Version ID: 1.0
    3. Click Finish.