Mapping Creator¤

Configuration Info¤

A specific configuration is required to activate this feature. Furthermore, for the best experience, an LLM provider configuration is also needed. See the link in the info box for details.

Configuration

See Mapping Creator and LLM Configuration to learn how to enable and configure this feature.

Usage¤

The Mapping Creator is a feature of BUILD transformation tasks (BUILD > Project > (Workflow >) Transformation > Mapping Creator).

Help

Access help and a feature tour via the help menu .

Use the Mapping Creator to connect your data to semantic models. Using visual tools, drag-and-drop, and suggestions, you can create mappings between your source data and knowledge graph classes as well as their properties.

The Mapping Creator consists of three parts:

Source schema shown on the left side
Target Schema shown on the right side
Mappings between elements in the source schema and in the target schema

You can move, connect or disconnect, and inspect each element visually.

Color Legend¤

Each color and visual element used in the Mapping Creator has a specific meaning as shown in the screenshot below.

TODO: show the color legend here, too

Manual creation¤

To start a mapping you need to select or define a target class first. The target class defines where your data will be mapped in the knowledge graph.

Add properties¤

To complete a mapping, properties need to be added to complete your desired target schema (i.e. the graph fragment that your transformation shall yield).

There are two options to add properties:

during class selection
from vocabularies

During class selection¤

In the add target class dialog you may select different kind of properties:

class properties - properties defined in the domain of the selected class or its super-classes
default properties - typical well-known properties like rdfs:label or rdfs:comment
generic properties - properties defined with no explicit domain (or in domain of owl:Thing)

The property preview helps to confirm your choice.

From vocabularies¤

The add property from vocabularies dialog allows you to search and select a property and to configure it in the desired way:

redefine the role of a property, to use a DatatypeProperty in the role of an ObjectProperty, or vice versa
define the direction an ObjectProperty should be used in

Create direct mappings¤

Drag from a property in your source data to a class or property in the canvas to create your mapping. This is helpful when smart suggestions are not sufficient.

Edit saved mapping rule¤

Click on an already saved target element to show more details. With the Pencil icon you can edit the mapping rule and rename elements, or adjust configurations. Advanced users can refine transformation logic here.

Smart suggestions with AI support¤

Info

Note that this feature is only available if a Large Language Model is configured.

Click the Magic Wand to automatically generate mapping suggestions based on your data and the selected class. Accept () or reject () each suggestion as needed.

Class suggestions¤

If you haven’t selected a target class yet, the AI will suggest classes from the selected vocabularies that best fit your source data. Alternatively, you can search for classes manually by typing text into the search field.

Hover over the wand icon for each suggestion to understand why this class has been recommended.

Property suggestions¤

Property suggestions are generated that map your source data to elements of the selected target vocabularies. You can accept () or reject () each suggestion.

Once the smart suggestions have been generated, you need to perform two steps:

For each property, decide whether to accept or reject the AI-generated mapping. Click Confirm to accept or Decline to reject.
Once you have completed your mapping, click the Save Mapping button to apply and save your changes to the transformation task.