Monday, October 24, 2016

How To Setup Data Virtualization Tooling For JBoss Developer Studio 10

The release of the latest JBoss Developer Studio (JBDS) brings with it the questions around how to get started with the various JBoss Integration and BPM product tool sets that are not installed out of the box.

In this series of articles we will outline for you how to install each set of tools and explain which products they are supporting.

This should help you in making an informed decision about what tooling you might want to install before embarking on your next JBoss integration project.

There are four different software packs that offer tooling for various JBoss integration products:
  1. JBoss Data Virtualization Development
  2. JBoss Business Process and Rules Development
  3. JBoss Fuse Development
  4. JBoss Integration and SOA Development
Tooling is available under software updates
with early access enabled.
This article will outline how to get started with the JBoss Data Virtualization development tooling and any of the JBDS 10 series of releases.


JBDS 10 can be obtained through the Customer Portal or via the early access downloads on After installing JBDS, start it up and you will see a welcoming JBoss Central tab with at the bottom a tab to look at the available tool sets labeled Software/Update

You will notice at the time of this writing that there are no other JBoss Integration stacks offered to install upon first inspection. This is due to the other integration stacks being early access.

Select JBoss Data Virtualization development.
Eventually they will be shown by default once testing finished and they release, but for now you can obtain them by checking the Early Access box in the bottom right corner. 

This will reveal the integration stack tooling offerings and we will select JBoss Data Virtualization Development.

Click on the Install/Update button to start the installation and restart at the end to complete the process.

If you are interested in what is being installed, it can be examined by examining the pop-up listing of components and versions. Note this will change as the early access progresses towards final releases.
    Examine components and versions to be installed.
    Stay tuned for more articles in this series that will detail the installation of the remaining JBoss Integration Stack tools.

    Other options

    In the past we have outlined the use of JBoss BPM and rules tooling for other versions of JBDS:

    Thursday, October 20, 2016

    Modeling Your Business Process Data

    (This article was excerpted from the book Effective Business Process Management with JBoss BPM by Eric D. Schabell.)

    One of the most important building blocks for a process project is data. It could be argued that this is a fact for any application development project, but it’s essential for a process project because, by definition, a process is receiving, acting on, moving, manipulating and modifying data constantly during its lifecycle. This data needs to be in a form that can be easily understood by all involved in designing and building the process project. The form the data is put into is called a Data Model, which is a part of every computer science student’s education, learning how to formally model data.

    The actual discovery of data that’s part of the process you’re implementing, as well as the structuring of this into a form that can be considered a data model, is outside the scope of this article. I start at the point that you’ve a completed data model delivered to you for implementation and you need to make this model available to applications and processes from within the JBoss BPM Suite.

    Let’s imagine you’re part of a project team automating a process that determines if a customer of your financial institution has the right income and age to be considered for a car loan. There has already been a round of discovery workshops to uncover the process steps, which uncovers the data needed to complete the process. This data is modeled by someone in the project team and delivered to you as the project team member responsible for implementing this data model.

    At this point, with your data model in hand, you’ll start the journey of implementing data objects for your process projects.

    Data modeling tooling overview

    Figure 4.1. This example data model has been given to you for 
    implementation in JBoss BPM Suite. It consists of two data 
    objects; Department and Employee. 
    Traditionally the art of data modeling referred to how data was structured in an organization. You can find detailed definitions of data modeling[1], but for our purposes I’m focusing on being able to create a simple set of data objects that represent the data being manipulated in our process project. I don’t provide details provided on how to design data models, nor do I discuss the actual code generated behind the data modeler tooling when you create a data object.

    The data objects I’m using as an example to illustrate use of tooling are the following two objects:
    • Employee
    • Department
    An employee has a name, employee number and a department that she works in. The department data object has a name, department number, and list of employees that belong to that department. This is a simple and fictitious data model, shown in figure 4.1, from the example project described above and I’m going to walk you through implementing it in JBoss BPM Suite.

    Getting started with data modeling

    The first thing to do with a new design for your projects data model is to start implementing that model. This can be done by developers in the Java programming language using their favorite editors, or integrated development environments and given to your project, or you can use the data modeler provided by JBoss BPM Suite. I’m going to show you how to use the data modeler within the JBoss BPM Suite tooling as shown in figure 4.2.
    Figure 4.2. An overview of the path you’ll take in this article is outlined. Inside the box are the steps to be covered, from the moment you receive a data model design, through implementation in JBoss BPM Suite, to the final data objects in your project for use by the rest of your team.

    Let’s get started modeling the data model we’ve been given. First, you need to log in to the Business Central console as in figure 4.3. If you haven’t previously done so, browse the documentation found in the tabs indicated by the arrows in the figure to get a feel for what is available in JBoss BPM Suite.
    Figure 4.3. After logging in to the Business Central
    you’ll be at the home screen where you can browse
    the documentation. This home screen is where you
    start your work on data modeling.

    Next, you open the project authoring perspective to begin accessing and creating your data model. This is found in the Authoring menu as shown in figure 4.4; select Project Authoring to open the perspective where you see the data modeler.

    Figure 4.4. The Project Authoring perspective can be found
    in the Authoring menu and opened by clicking on the Project
    Authoring entry. This will get you to the various authoring tools
    for any BPM projects you’re working on.

    Now that your project is in front of you, open the data modeler by selecting from the New Item menu a new Data Object. This produces a pop-up, shown in figure 4.5, where you can get started on your first data object, the Employee. You can provide the following details to get started with the Employee data object:

    • Data Object : Employee
    • Package :
    • Persistable : (leave check box empty)

    Figure 4.5. Pop-up to create a new data object.    
    The first is the name of the data object, Employee, as we’re going to be create an object to hold our employees for this project. The package name is selected from a drop down menu and specifies where the data object is to be stored in your project. The final item, Persistable, is a check box that allows you to indicate you want to save this object to a database table and provides special configuration details that need to be generated for you. That sort of mapping of data to a database table is outside of our scope as we’re managing our data objects in memory, and you can leave that box empty.

    You finish creating the Employee data object by clicking on the +OK button, which opens the data modeler with the provided Employee details already inserted in some of the fields you see.

    Now the Employee object appears in the data modeler within your Business Central console and you’re ready to interact with the data modeler to start adding data fields like name, department and employee number.

    Figure 4.6. Data objects are put into packages in
    which they appear to have been hidden from the
    main Project Explorer default view. To find them you
    need to expand your folder structure.
    At this time, you expect to see the newly created Employee data object in your Project Explorer pane on the left side of your screen, right? The reason that it isn’t there is because you’re viewing the default level of your project, which contains all the assets you created, except for assets that have been given package names that are deeper into the project folder structure.

    If you remember, you created the Employee data object with the package set to which translates to the folder structure of com/group/retail/hremployerewards/ in your project. Any time you wish to browse or select the data modeler for the Employee object, you need to first navigate down to this folder before it appears in the Project Explorer.

    In figure 4.6, the Project Explorer is shown with the folder structure expanded.

    If you click on the Employee object, it opens in the data modeler. Any time you’re looking for the data objects available in a project, you can follow this process within the Project Explorer to traverse your project and explore data model assets.

    Taking a closer look at the data model editor

    Figure 4.7. The JBoss BPM Suite data model
    editor where you create, modify and view
    data objects.
    After initializing the Employee object, you’re now at the point of adding all of the identified fields like name, employee number and department where the employee is working. This section takes you through the data model editor, explaining what’s available to you to complete the Employee object.

    In figure 4.7 you see the Employee data object in its initial state after opening it in the data model editor. Nothing has yet been created outside of a name and assigning it to a location in the projects package structure. This is at the starting point for further implementing the details of this Employee object. To start working with the data modeler you need to understand the layout of this editor.

    You’ll use a few menu bar buttons while creating and updating your data objects. Let’s take a look at their actions in table 4.1.

    Table 4.1. An overview of the data modeler buttons as found on the top right of the screen. You can activate six actions by clicking on one of the buttons shown here.
    Any time you’re modifying your data objects, be sure to use the Save button and provide a short message as to what you’ve changed. It’s easy to lose some of your work by forgetting you’re working in a browser-based editor and pressing the back button on your browser.

    Adding fields to a data object

    Figure 4.8. The New field form will pop-up when
    you click on the +add field button in the data
    model editor. 
    Now that you’ve an idea of what the data model editor looks like, let’s finish the Employee object by adding all the fields that were identified earlier. Let’s start with the field for the employee name by clicking on the +add field button to generate a pop-up labeled New Field as shown in figure 4.8.

    This pop-up is asking for the values that you can enter with the following values and shown in figure 4.9:

    New field

    • Id: name
    • Label: Name
    • Type: String
    • List: don’t check this box

    Once you’ve completed all the items for your field, you can submit them with the Create button or with Create and continue.

    • The Create button submits and closes out the New field pop-up form.
    • The Create and continue button submits your field and opens an empty New field form, allowing you to add multiple fields quickly.

    Figure 4.9. This is the entry form called New field, used
    to add all the relevant information when adding a
    field to an existing data object. Here a field with an
    id, label and type with the values name, Name
    and String is being created.
    Figure 4.9 also gives a good look at the item Type, which is a menu with many entries to pick from. Most are from the Java language, as this is the implementation language used to create JBoss BPM Suite. One interesting entry isn’t a standard Java type; did you see it? Look closely and notice the entry entitled If you think back, when we created our initial Employee data object, it was put into a package with exactly that name. As you can now see, each object created is also available for use as a field type, even as a list of types if you should check the box making a field a list.

    At this point I want you to use the Complete button to submit the field and close the form. This way you can examine your work as the data object editor now includes the name field in the list of fields in the left pane as shown in figure 4.10.

    Figure 4.10. After adding the first field
    name, it appears in the data modeler.
    Now you’re a real BPM data model editor expert, having successfully created the Employee data object and added a name field! It’s time for you to fly solo and create the two remaining fields for Employee; the employee id and department fields. Go ahead and create and verify them against figures 4.11 and 4.12. Otherwise follow along as I help you to create them.

    Click on the +add field button in the data model editor to create the employee id field with the data here, it should look like figure 4.10 after you submit with the Create button:

    Employee id field
    • Id : employeeid
    • Label : Employee Id
    • Type : Integer
    • List : don’t check this box
      Figure 4.11. The Employee object in the data model
      editor should look like this when you get done
      adding in the employee id field.
    For the last field you’re adding to the Employee object, click on the +add field button in the data model editor to create the department field with the data here, submit it and ensure it looks like figure 4.12:

    Employee id field

    • Id : department
    • Label : Department
    • Type : String (for now, see why in figure 11 description)
    • List : don’t check this box
    This completes the Employee data object with the fields name, employee id and department. You can now use the Save button in the data model editor found in the top right - it produces a pop-up labeled Save this item, in which you can enter a comment. For example, enter “Created Employee Object” and click on the Save button to save your data object.

    Figure 4.12. The Employee object in the data model
    editor should look like this when you’ve added
    the last department field.
    Before you finish the entire data model by adding the Department object, I want to show you a few more of the features available to explore and work with your Employee object. If you’ve been paying close attention to your screen you might notice two more tabs at the bottom; let’s take a look at them.

    More to the data modeler than meets the eye

    The data modeler offers a few tabs at the bottom of your screen, the first being the editor you’ve been using. The second is labeled Overview and it’s the next one that shows you what can be done with the Employee object you created.

    You can open the Overview tab by clicking on it; this reveals a window similar to figure 4.13. Note that this view contains the same main header and menu buttons on the top left or right as was covered in the editor.
    Figure 4.13. The data modeler Overview tab
    provides all the details around the currently
    selected object. In our case it’s the
    Employee object.

    The section on the top left provides detailed information about the Employee object, such as its type, a field to add a description for this object, which projects use this object, the date this object was last modified, and when you created the Employee object. On the lower left you see the versions of the Employee object that you’ve saved in the past. The current version is listed at the top and it’s the one currently displayed in the data modeler. If you wanted to go back to one of the previous versions listed, you only have to select one and it’ll replace the current version of the data modeler. On the right you’ve a comments field where you can leave information for your fellow modelers.

    If you click on the Metadata tab next to the Version history tab, you’ll see something similar to that shown in figure 4.14. This shows you an editor to add some extra, or meta, information about this data object. You can insert a tag name and click on the Add a new tag button. The Note field shows you the last save message for this object and the actual path to the object’s file in your project. The URI field points to the exact file for checking out the current data object from the GIT repository for this project. The Subject, Type, External link and Source fields are all free form text fields that let you put any information in them you deem pertinent for this data object.

    Figure 4.14. The tab labeled Metadata will provide
    you  with the chance to add extra information
    about the current data object.
    These fields are left to you to determine how you want them to be used. For example, here we set the Type to Doc as we’re relating all the information supplied here to the documentation-related employee-docs tag. All of this extra information can be added to enrich the information supporting your data object, and is often detailed about how an organization works with data. The more details in your artifacts, the less chance of confusion later for anyone who revisits your data object.

    The last field, labeled Lock status, shows if someone has locked this data object by having it open in the data modeler editor, and provides a button that allows you to unlock it. Valid reasons to take away a locked object exist.

    Imagine your colleague was working on the Employee object and left it open on his machine when he went away on an extended vacation. It might be nice to be able to access it after you’ve verified that the person isn’t going to be working on the Employee object?

    Now that we’ve the Employee object open, it puts a lock on this behind the scenes that the next person, working on a different workstation and in a different browser, who attempts to open this Employee object finds it locked. It opens for them, but it’s shown with a small lock icon next to the name in the Project Explorer, and is only readable. They could use the Metadata tab to force an unlocking of the data object, but need to be aware that they’re possibly interrupting your work as you’re unaware that they’ve taken the data object lock away. This is a light form of locking, meaning it’s not informing anyone about who forces the unlocking, and everyone using the system is responsible for behaving nicely when taking away a locked object from another user.

    Remember to save any modifications you’ve made in the Overview tab by clicking on the Save button found in the top right menu bar; it produces a pop-up labeled Save this item that allows you to enter a comment. For example, enter “Added metadata to Employee Object” and click on the Save button to save your data object.

    Using the data model source

    The last tab in the data modeler is labeled Source, and it provides a learning tool for those interested in looking inside data models. If you click on this, it shows you the actual Java source code generated for the data object you’re working on. In figure 4.15 you can see an example based on the Employee object you’ve been working on. It’s an example of my Employee object, but it should resemble yours closely, if not exactly.
    Figure 4.15. The Source editor is the tab that provides
    a developer view of the actual Java source code
    that makes up your Employee data object.

    This Source editor is a free text editor without any developer tooling such as code completion or other help. It’s a view of what a Java developer would code in an integrated development environment (IDE) tooling, and could add to the project. The only point to note is that if a developer chooses to code their own data objects and add them to the project, they must implement the Java class to work with a JBoss BPM project. This is because everything in the project, behind the scenes during runtime, is serialized before being stored in the persistence layer (i.e. database) and unserialized when it’s retrieved from the persistence layer.

    Furthermore, each data object that has fields is a Java serializable object with getters and setters methods. For example, the name field uses a getName method and a setName method. Be aware that this editor doesn’t support code completion or other fancy tooling, it’s a free text editor and you can easily break your data object if you aren’t careful. Use the Validate button before saving to ensure your data object is working.

    Let’s take a look at what you can do if you decide to edit a data object by hand in the Source editor, to make sure you aren’t saving a broken data object. If you click on the source code and remove the last ‘e’ in the word Serializable on line seven from figure 4.15, you can validate the data object before saving by clicking on the Validate button in the top right menu bar. After removing the ‘e’ a pop-up box with a validation error should appear, as in figure 4.16.

    Figure 4.16. If you’re going to be editing a data
    object’s Source, you’ll need to use the Validate 

    button to ensure you haven’t broken your data
    If you fix that error by putting the ‘e’ back on to the word Serializable, click again on the Validate button. You should see a green bar pop-up with a message stating that Item validated successfully. You can now save the data object without fear of breaking your project.

    As you can see, the Source editor is a quick way to fix something that needs to be done in your data object, but requires discipline to constantly validate that your changes haven’t broken anything. If you stick to the provided data modeler Editor, you never have to worry about these types of problems.

    This concludes the excerpt. For source code, sample chapters, the Online Author Forum, and other resources, go to:

    [1] A formal definition can be found at, which states “Data modeling is often the first step in database design and object-oriented programming as the designers first create a conceptual model of how data items relate to each other. Data modeling involves a progression from conceptual model to logical model to physical schema.”