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.
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 HelloWorld 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, refer to the Red Hat JBoss BPM Suite User Guide).
To create the repository structure, do the following:
  1. Open Business Central in your web browser (if running locally http://localhost:8080/business-central) and log in as a user with the admin role (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 Create Repository dialog box, define the repository properties:
      • Repository Name: helloworldrepo
      • Organizational Unit: helloworld
  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.
    Selecting the helloworldrepo repository in the helloworld organizational group in Project Explorer

    Figure 4.1. Selecting the helloworldrepo repository in the helloworld organizational group in Project Explorer

  6. Create a project in the helloworld repository:
    1. On the perspective menu, go to New Item → Project
    2. In the displayed Create new Project dialog box, define your Project properties:
      • Resource Name (project name): HelloWorld
    3. In the New Project Wizard dialog, define the maven properties of the Project:
      • Group ID: org.bpms
      • Artifact ID: HelloWorld
      • Version ID: 1.0
    4. Click Finish.