Skip to content

fix indentation, en-US spelling #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
rpietzsch wants to merge 3 commits into from
Closed

fix indentation, en-US spelling #1

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
197d792
fix indentation, en-US spelling
rpietzsch Mar 11, 2026
5959d2b
avoid abbreviations
rpietzsch Mar 11, 2026
fa6b0a2
polish language
rpietzsch Mar 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
120 changes: 59 additions & 61 deletions docs/explore-and-author/bke-module/visually-authoring-ontologies/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
icon: material/cog-outline
subtitle: using BKE interface
subtitle: using Business Knowledge Editor interface
tags:
- BeginnersTutorial
- Vocabulary
Expand All @@ -9,184 +9,182 @@ tags:

## Introduction

This beginner-level tutorial shows how to use Business Knowledge Editor (BKE) to create new ontology (vocabulary) **classes** and **predicates** (object property, data property) visually.
This beginner-level tutorial shows how to use Business Knowledge Editor to visually create new ontology (vocabulary) **classes** and **properties** (object properties and datatype properties).

There are other way of creating new classes and properties within Corporate Memory (using shacl shapes), but BKE allows for an intuitive "diagram" approach, simplifying the creation.
There are other ways to create new classes and properties in Corporate Memory, for example by using SHACL shapes. Business Knowledge Editor provides an intuitive diagram-based approach that simplifies this process.

The tutorial consists of the following steps, which are described in detail below:

1. Initializing a new ontology
2. Opening a new BKE visualisation
3. Creating classes
4. Linking related classes through object properties
5. Adding data properties
6. Saving the changes
1. Initialize a new ontology
2. Open a new Business Knowledge Editor visualization
3. Create classes
4. Link related classes through an object property
5. Add data properties
6. Save the changes

## Class Diagram

This tutorial will go through the example of creating an ontology modeling the following diagram:
This tutorial uses the following example ontology:

![](diagram_product_expert.png)

Two classes will be related to each other through an `expertIn` object property.
Two classes are related through an `expertIn` object property.

Each class will have its own data property.

---

## 1 Initializing a new ontology

The "to-be-created" classes and properties will be saved in a given Knowledge Graph, a new ontology graph will be initialized for this tutorial.
The classes and properties created in this tutorial are stored in a knowledge graph. For this tutorial, create a new ontology graph.

!!!info
!!! info

It is also possible to extend an existing vocabulary, in that case directly go to step 2
You can also extend an existing vocabulary. In that case, continue with step 2.

To create a new ontology graph :
To create a new ontology graph:

1. In Corporate Memory, click **Knowledge graphs** under **EXPLORE** in the navigation on the left side of the page.
1. In Corporate Memory, click **Knowledge graphs** under **EXPLORE** in the navigation on the left side of the page.

![](explore-kgs.png){ class="bordered" width="50%" }
![](explore-kgs.png){ class="bordered" width="50%" }

2. In the **Graphs** drop-down menu click the **(+)** button and select **New Ontology (owl:Ontology)**.
2. In the **Graphs** drop-down menu, click the **(+)** button and select **New Ontology (owl:Ontology)**.

![](adding-new-graph.png){ class="bordered" width="50%" } ![](create-ontology-graph.png){ class="bordered" width="50%" }
![](adding-new-graph.png){ class="bordered" width="50%" } ![](create-ontology-graph.png){ class="bordered" width="50%" }

3. Define a **Name** and a **Graph URI** for the ontology. In this example, use:
- Label: `Custom Dprod`
- Graph URI: `http://ld.company.org/custom-dprod/`

3. Define a **Name** and a **Graph URI** for the ontology. _In this example we will use:_
- Label: `Custom Dprod`
- Graph URI: `http://ld.company.org/custom-dprod/`
---

## 2 Opening a new BKE visualisation
## 2 Opening a new Business Knowledge Editor visualization

1. In Corporate Memory, click **Business knowledge editor** under **EXPLORE** in the navigation on the left side of the page.
1. In Corporate Memory, click **Business Knowledge Editor** under **EXPLORE** in the navigation on the left side of the page.

![](explore-bke.png){ class="bordered" width="50%" }

2. Select the target graph using the drop-down menu.

![](bke-select-graph.png){ class="bordered" width="50%" }

3. Create an empty visualization.
3. Create a new empty visualization.

!!!success
!!! success

If you see an empty canvas you are ready to use BKE to create classes and properties
If you see an empty canvas, you are ready to use Business Knowledge Editor to create classes and properties.

---

## 3 Creating classes

New elements can be created by using the concepts defined in `Classes` visible in the left side of the canvas
New elements can be created from the entries listed in **Classes** on the left side of the canvas.

1. Drag and drop **Class** from the bottom left list into the canvas.

![](classes.png){ class="bordered" width="50%" }

!!!info
!!! info

If you don't see Class within the first entries you can use the text search bar to find it
If you do not see **Class** in the first entries, use the search bar to find it.

2. Click the newly created **Untitled (Class)** in the canvas to bring up a form on the right side.

![](untitled-class.png){ class="bordered" width="50%" }


3. Fill out the form with the required (*) and optional values .
3. Fill out the required fields and any optional fields you want to define for the class.

![](expert-class.png){ class="bordered" width="50%" }

---

## 4 Linking related classes through object properties


1. Drag and drop **owl:ObjectProperty** from the bottom left list into the canvas.

!!!info

If you don't see owl:ObjectProperty within the first entries you can use the text search bar to find it
!!! info

If you do not see **owl:ObjectProperty** in the first entries, use the search bar to find it.

2. Click the newly created **Untitled (Object Property)** in the canvas to bring up a form on the right side.

3. Fill out the form with the required (*) and optional values .
3. Fill out the required fields and any optional fields you want to define for the object property.

![](expert-in-form.png){ class="bordered" width="50%" }

4. Click and hold the edge of the Class to begin drawing an arrow. Link that to the created property's edge.
4. Click and hold the connector dot at the right edge of the class to begin drawing an arrow, then connect it to the connector dot at the left edge of the object property.

![](pointer-click-hold.png){ class="bordered" width="50%" }

5. Inside the edge type selection window that pops up, select **In Domain Of**
5. In the edge type selection window that appears, select **In Domain Of**.

![](edge-type.png){ class="bordered" width="50%" }

!!!info
!!! info

This is one way of associating a property with an existing class, below is shown another way (creating new class from an existing property)
This is one way to associate a property with an existing class. The next step shows another option: creating a new class from an existing property.

6. Click the right side edge of the object property and select **Range** from the selection so that it brings an additional **New Class** on the right side
6. Click the right-side edge of the object property and select **Range**. This adds **New Class** on the right side.

![](range-created-new-class.png){ class="bordered" width="50%" }

7. Drag and drop **New Class** into the canvas.

![](drag-drop-new-class.png){ class="bordered" width="50%" }

8. Click the newly created class to bring out the form and fill out with the required (*) and optional values .
8. Click the newly created class to open its form, then fill out the required fields and any optional fields you want to define.

![](form-product.png){ class="bordered" width="50%" }

!!!success
!!! success

The property is now succesfully linking the two concepts together through the use of Domain and Range
The property now links the two concepts through its domain and range.

---

## 5 Adding data properties

Datatype properties can be added to the canvas the same way as an object property,
Datatype properties can be added to the canvas in the same way as object properties.

1. Drag and drop **owl:DatatypeProperty** from the bottom left list into the canvas.

!!!info
!!! info

If you don't see owl:DatatypeProperty within the first entries you can use the text search bar to find it
If you do not see **owl:DatatypeProperty** in the first entries, use the search bar to find it.

2. Click the newly created **Untitled (Data Property)** in the canvas to bring up a form on the right side.

3. Fill out the form with the required (*) and optional values .
3. Fill out the required fields and any optional fields you want to define for the data property.

![](form-property.png){ class="bordered" width="50%" }

4. Click and hold the edge of the Class to begin drawing an arrow. Link that to the created property's edge.
4. Click and hold the connector dot at the right edge of the class to begin drawing an arrow, then connect it to the connector dot at the left edge of the data property.

5. Inside the edge type selection window that pops up, select **In Domain Of**
5. In the edge type selection window that appears, select **In Domain Of**.

![](linking-datatype-property.png){ class="bordered" width="50%" }

!!!warning
!!! warning

At the time of writing this tutorial, setting up a datatype range (languaged string, float, date ...) is not possible from within BKE directly.
We recommend saving the changes and finish the datatype edition using the shacl shapes approach.
At the time of writing, it is not possible to set a datatype range such as a language-tagged string, float, or date directly in Business Knowledge Editor.
Save your changes, then complete the datatype definition by using the SHACL shapes approach.

![](datatype-range-not-supported.png){ class="bordered" width="30%" }

## 6 Saving the changes

It is recommended to save the changes by using a named visualisation, in case you need to edit your classes and properties later.
Save the changes as a named visualization so you can edit your classes and properties later.

1. Click **Save** from the top right section of the canvas
1. Click **Save** in the upper-right corner of the canvas.

2. Using the Graph drop-down selector, choose your ontology (vocabulary)
2. In the **Graph** drop-down selector, choose your ontology (vocabulary).

3. Fill out the name
3. Enter a name for the visualization.

![](save-changes.png)

4. Click Save
4. Click **Save**.

!!!success
!!! success

You have successfully created new concepts and properties inside your ontology using BKE's canvas.
You have successfully created new concepts and properties inside your ontology using Business Knowledge Editor's canvas.