Extension:Cognitive Process Designer

Cognitive Process supports the creation, importing, exporting and annotating of BPMN processes by using an intuitive graphical user interface. Each element (node and edge) is represented by its own wiki page, which publishes the information according to the Linked Data Principles. Cognitive Process is based on bpmn.io, which is a JavaScript renderer that allows to model BPMN processes and checks the syntax. Semantic Forms is used to facilitate the input of information for each element.

Installation

 * Semantic MediaWiki must be installed in order to provide information for the elements in a structured way and publish the information according to the Linked Data Principles, which helps to avoid having an unbounded web.

Usage


After installation, there are two new Links on Special Pages.
 * Cognitive Process Edit
 * Cognitive Process Test Suite

The Cognitive Process Edit page is the actual Cognitive Process extensions, which allows to create, load, edit, import, export and annotate BPMN processes. Each element (node and edge) is represented by its own wiki page.

The Cognitive Process Test Suite offers similar functionality, however creating diagrams in the test suite does not affect your MediaWiki. Thus, it does not create wiki pages and store the information. It provides only the graphical user interface and the possibility to import and export BPMN diagrams without any affects on your MediaWiki.

Create Diagrams
The init screen shows a text input, in which the name of the diagram that should be created, has to be entered. After entering the name of the diagram click on Create BPMN. Afterwards, the window and the overlay disappears and you can start creating the diagram or exporting an existing.



Cognitive Process checks if a wiki page with the entered name already exists. If so, it will warn the user.



Create Elements
Creating an element (node and edge) leads to the creation of a wiki page that represents the element.

To create an element, there are two options:
 * Either use the sidebar: Click on an element and then drop it on the appropriate position in the diagram
 * Or use the context menu: Click on an element and select a new node type. Therefore, a new edge is also automatically created that links from the node to the new created element.

Change Elements
Click on the wrench of the context menu of an element to select the type in which the element should be changed.

''Important: Changing an element leads to creating a new wiki page for the new element and transfer the content of the old page to the new wiki page. The content of the old wiki page is then deleted.''

Delete Elements
The deletion of an element in Cognitive Process leads to the deletion of content of the wiki page that represents the element. The wiki page itself is not deleted, but the content. This is because, often only admins have the permision to delete a page but not users.

To delete a element. Click on the bin icon of the context menu.

Annotate Elements
Each element (node and edge) in the BPMN process can be annotated. This can be done by
 * Manually changing the content of the wiki page that represents the wiki page or
 * Semantic Forms, which is included into the extension.

Manually Annotate Elements
Each element is represented by its own wiki page. Therefore, information for this element can be added on its page. In order to facilitate to get to the wiki page, which represents the element, we included an icon in the context menu that links to the wiki page.


 * Click on an BPMN element in order to open the context menu.
 * Click on the angular arrow below the magnifier to jump to the wiki page that represents the BPMN element.



This is an examplary wiki page that represents a BPMN element. It contains among other information like position, height, width and label of the BPMN element. Additional information can be added to the wiki page in order to annotate the element.



Using Semantic Forms
In order to faciliate annotating a BPMN element, one can also use Semantic Forms.

In order to annotate a BPMN element by using Semantic Forms, click on the element so that the contex tmenu appers. Afterwards click on the magnifier. Afterwards, all available Forms, stored in the MediaWiki, are listed. Click on the Forms with which the element should be annotated.



After clicking on a Semantic Form, a popup appears that allows to easily annotate the element with the selected form.