SBVR is a mature standard for capturing expressive business rules along with their semantics, and is especially useful in the communication with business people. SBVRwiki is a novel tool that allows for an eective use of the SBVR notation. This online collaborative solution allows for distributed and incremental rule authoring for business analytics and users. It supports creation of vocabularies, terms and rules in a transparent, user-friendly fashion. The tool provides visualization and evaluation mechanisms for created rules, and besides basic syntax highlighting and checking, it allows for logical analysis. As it is integrated with the Loki knowledge engineering platform, it allows for on-the-y conversion of the SBVR rule base and vocabularies to Prolog. The Dokuwiki back-end provides storage and unlimited version control, as well as user authentication.
SBVR (Semantics of Business Vocabulary and Business Rules) [
An eective use of the SBVR notation is non trivial, because it requires certain knowledge engineering skills. Thus, there is a need for software supporting business analytics in the rule acquisition process. Such software should allow for syntax checking, automatic hinting as well as preliminary evaluation of the resulting set of rules.
There are several SBVR-supporting tools like editors that support text-based creation of dictionaries and business rules providing syntax highlighting and suggestions; modelers that allow for generating models based on SBVR compliant documents; or tools that allow a user to import various models and transform them into the SBVR syntax. Considering their limitations of the existing tools supporting SBVR authoring, our motivation is to deliver a lightweight tool allowing for easy creation of the SBVR knowledge bases even for inexperienced users. We opt for a web-based solution that allows business users and analytics to collaborate using a familiar browser-based interface. ? The paper is supported from the Prosecco project funded by NCBR.
SBVRwiki uses the Dokuwiki 1 back-end for storage, unlimited version control and user authentication. The tool supports identication and creation of vocabularies, terms and rules in a transparent, user friendly fashion. It also provides visualization and evaluation mechanisms for created rules.
Our tool is integrated with the Loki knowledge engineering platform [
The rest of the paper is structured as follows. Section 2 discusses the functional requirements for the wiki-based collaborative platform for knowledge engineering, especially for requirements analysis. Then, in Section 3 the SBVRwiki system is presented. Future work is summarized in the nal Section 4. 2
Wikis are broadly used in various areas including distributed requirements
analysis [
Main functional requirements for an SBVR wiki-based system are as
follows: 1) creation of a new SBVR project composed of vocabularies, facts, and
rules using a set of predened templates, 2) authoring of a project using
structured vocabularies, with identied categories, 3) SBVR syntax verication and
highlighting in text documents, as well as syntax hinting, 4) visualization of
vocabularies and rules as UML class diagrams to boost the transparency of the
knowledge base, 5) le export in the form of SBVR XMI, 6) integration with
the existing PlWiki and BPWiki [
The development of the SBVR wiki was based on several implementation requirements, such as: the system should be an extension (plugin) to the DokuWiki platform by extending the capabilities of the native Dokuwiki editor; it should operate in parallel with the PlWiki and BPWiki extensions, and should not interfere with the operation of other add-ons installed on the platform.
Dokuwiki oers several classes of plugins allowing for ne-grained processing of the wiki text. SBVRwiki implements two main plugin components: SBVRwiki Action Plugin responsible for the le export in the XMI (XML) format. It also handles the user interface events and extends the built-in Dokuwiki editor with shortcuts for common SBVR constructs.
SBVRwiki Syntax Plugin used to enter SBVR expressions as wiki text using a special <sbvr> wiki markup. Using it a user can enter legal SBVR expressions and the plugin oers rich syntax highlighting. Moreover, vocabularies can be visualized with the dynamic translation to UML class diagrams that are rendered by the wiki using the PlantUML tool 2, see Fig. 1.
There are several advantages of using a Wiki system as the implementation platform. As the SBVR expressions can be stored in separate wiki pages, the content can be simultaneously edited by a number of users. The Loki engine can select only the relevant parts of this knowledge on the y, so the pages can contain not only the SBVR content, but also additional pieces of information, such as comments, gures, media attachments, and hypertext links to other resources in the wiki or on the Web.
For this tool presentation, we uses a benchmark case of SBVR knowledge
base, the classic EU Rent case 3, provided as a part of the SBVR specication [
EU-Rent is a ctional international car rental company. Renters may be individuals or accredited members of corporate customers (a company or similar organization). In each country, EU-Rent oers broadly the same kinds of cars, ranging from economy to premium although the mix of car models varies between countries. Rental prices also vary from country to country. However, dierent models of oered cars are organized into groups, and all cars in a group are charged at the same rates within a country.
3 You can browse the EU-Rent case using wiki on: http://home.agh.edu.pl/~kkutt/ sbvrwiki-demo/. Credentials: demo/demo.
A car rental is a contract between EU-Rent and a renter, who is responsible for payment for the rental and any other costs associated with the rental (except those covered by insurance). A rental booking species: the car group required; the start and end dates/times of the rental; the EU-Rent branch from which the rental is to start.
During creating a new SBVR project, several steps have to be taken. However, this does not require much knowledge of the application because a user is supported by a set of built-in guiding wizards. Using SBVRwiki, a user should dene concepts rst, then writes down facts, and nally rules can be authored. Concepts, facts and rules are stored in the separate Wiki namespaces. The Lexer module of the plugin detects the previously dened tokens what allows for proper syntax highlighting as well as for detecting the use of undened concepts.
In the case of the EU-Rent example, a user can start from creating a dictionary. It is a set of terms grouped in categories. If a user wants to describe concepts such as additional driver or loyalty club, it is a possibility to write down the information about these terms, such as a source, a type or a denition. A user can also group them in category Customers. Finally, dictionary is saved and clearly formatted wiki page can be displayed (see Fig. 2).
The next step consists in creating the base of facts. A user can specify what dependencies exist between previously dened concepts. E.g. it can be specied that loyalty club includes club member, renter is club member, and renter is additional driver. When all such facts are described and saved, simple UML graphs are generated to visualize created database (see Fig. 3). In the last step, a user species rules providing constraints for modeled system. When saved, they are also clearly formatted and visualized in simple graphs form (see Fig. 4). Although the current version of SBVRwiki does not support all aspects of the SBVR standard, it implements enough of its elements to allow users to create complex models of business rules in Structured English. Its limitations are the lack of support for multi-argument facts, polymorphism or additional attributes for the expressions, dictionaries, facts and rules.
As the tool is implemented as a plugin for the DokuWiki system, it can
be integrated with the BPWiki plugin [
SBVRwiki has been recently used in the Prosecco 4 research project as a tool for authoring the SBVR rules. One of the objectives of the project is the development of a system supporting management of SMEs (Small and Medium Enterprises) using business process and rules with well dened semantics. Thus, the tool was used to model vocabularies and rules identied in the SMEs participating in the project.