Chapter 5. 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:
- Create a Hello World repository in the Artifact repository.
- Create the Hello World Project with the
HelloWorld
business process definition. - Model the Hello World process logic in the business process using the graphical Process Designer tool.
- Build and deploy the project on the locally running Execution Engine.
- Run the Hello World process.
- Monitor the Process execution.
5.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 BPMS User Guide).
To create the repository structure, do the following:
- 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
). - Create an organizational unit in the Artifact repository:
- Go to Authoring → Administration.
- On the perspective menu, click Organizational Units → Manage Organizational Units.
- 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
- Create a new repository in the helloworld organizational unit:
- Go to Authoring → Administration.
- On the perspective menu, click Repositories → New repository.
- In the displayed Create Repository dialog box, define the repository properties:
- Repository Name:
helloworldrepo
- Organizational Unit:
helloworld
- Go to Authoring → Project Authoring.
- In the Project Explorer in the organizational unit drop-down box, select
helloworld
, and in the repository drop-down box selecthelloworldrepo
.Figure 5.1. Selecting the
helloworldrepo
repository in thehelloworld
organizational group in Project Explorer - Create a project in the
helloworld
repository:- On the perspective menu, go to New Item → Project
- In the displayed Create new dialog box, define your Project properties:
- Resource Name (project name):
HelloWorld
- Path:
default://master@helloworldrepo/
- In the New Project Wizard dialog, define the maven properties of the Project. Press Enter after making each entry:
- Group ID:
org.bpms
- Artifact ID:
HelloWorld
- Version ID:
1.0
- Click Finish.