JBoss.orgCommunity Documentation

Chapter 8. Administrative Functions

8.1. Categories
8.2. Status management
8.3. Archived items
8.4. Event Log
8.5. User permissions
8.6. Import and Export
8.7. Repository Configuration

Categories allow rules (assets) to be labeled (or tagged) with any number of categories that you define. This means that you can then view a list of rules that match a specific category. Rules can belong to any number of categories. In the above diagram, you can see this can in effect create a folder/explorer like view of assets. The names can be anything you want, and are defined by the Guvnor administrator (you can also remove/add new categories - you can only remove them if they are not currently in use).

Generally categories are created with meaningful name that match the area of the business the rule applies to (if the rule applies to multiple areas, multiple categories can be attached). Categories can also be used to "tag" rules as part of their life-cycle, for example to mark as "Draft" or "For Review".

The view above shows the category editor/viewer that is seen when you open an asset. In this example you can see the asset belongs to 2 categories, with a "+" button to add additional items (use the trash can item to remove them). This means that when either category is used to show a list of assets, you will see that asset.

In the above example, the first Category "Finance" is a "top level" category. The second one: "HR/Awards/QAS" is a still a single category, but its a nested category: Categories are hierarchical. This means there is a category called "HR", which contains a category "Awards" (it will in fact have more sub-categories of course), and "Awards" has a sub-category of QAS. The screen shows this as "HR/Awards/QAS" - its very much like a folder structure you would have on your hard disk (the notable exception is of course that rules can appear in multiple places).

When you open an asset to view or edit, it will show a list of categories that it currently belongs to If you make a change (remove or add a category) you will need to save the asset - this will create a new item in the version history. Changing the categories of a rule has no effect on its execution.

The above view shows the administration screen for setting up categories (there) are no categories in the system by default. As the categories can be hierarchical you chose the "parent" category that you want to create a sub-category for. From here categories can also be removed (but only if they are not in use by any current versions of assets).

As a general rule, an asset should only belong to 1 or 2 categories at a time. Categories are critical in cases where you have large numbers of rules. The hierarchies do not need to be too deep, but should be able to see how this can help you break down rules/assets into manageable chunks. Its ok if its not clear at first, you are free to change categories as you go.

Each asset (and also package) in Guvnor has a status flag set. The values of the status flag are set in the Administration section of the Guvnor. (you can add your own status names). Similar to Categories, Statuses do NOT effect the execution in any way, and are purely informational. Unlike categories, assets only have one status AT A TIME.

Using statuses is completely optional. You can use it to manage the lifecycle of assets (which you can alternatively do with categories if you like).

You can change the status of an individual asset (like in the diagram above). Its change takes effect immediately, no separate save is needed.

You can change the status of a whole package - this sets the status flag on the package itself, but it ALSO changes the statuses on ALL the assets that belong to this package in one hit (to be the same as what you set the package to).

This is basically the trash bin.

If you've archived an asset (effectively deleting it), and you want to restore it, open this screen, select the asset and click the button Restore selected asset.

If instead, you want to permanently delete it, select it and click the button Delete selected asset.

The event log shows the server events that have occured.

To clean the log, click the button Clean.

When role based permissions are enabled (see administration guide), it's possible limit user permissions.

To add a new user, click the button Create new user mapping.


The user guest is special: if the user exists, Guvnor will automatically log in users as guest.


Do not delete or cripple the users admin or mailman. They are users used by the system.

To add or remove a permission to a user, select a user and click on the button Open. Click on the green + to add a permission type:

There are several permission types:

  • Admin: this user can do everything

  • Analyst or Analyst read-only: analyst permissions for a specific category. Create the category before attempting to assign users to it.

  • Package admin, Package developer or Package read-only: package permissions for a specific package. Create the package before attempting to assign users to it.

The entire Guvnor respository can be exported to a file. This is usefull as a backup. It can be imported in the same or another Guvnor server instance.

To export the entire repository content into a zip file, click the button Export. You 'll get a pop-up in your browser to save the zip file.

To import such a zip file, click the button Browse, select the zip file and click the button Import.

Both actions may take some time, especially if the repository is big.

Check Chapter "Configuring Guvnor to use an external RDBMS" for more information.