Overview
Data mapping defines how raw fields from your external data sources are transformed into entities and relationships in the knowledge graph. Mappings tell Experio how to interpret structured data (CSV, Excel, databases) and create the corresponding graph nodes and edges.
Navigate to Admin > Data Sources > Data Mapping.
Viewing Mappings
The data mapping page shows a table of all configured mappings with server-side pagination. Each entry displays the mapping name and configuration details.
Creating a Mapping
Click Create New Mapping to open the mapping editor.
The mapping editor provides two modes:
A step-by-step form interface for defining:
- Source Fields — Select which fields from your data source to use
- Node Mappings — Define how source fields map to entity types in your ontology
- Relationship Mappings — Define how relationships between entities are derived from the data
Visual Canvas
An interactive drag-and-drop canvas (powered by React Flow) for visually designing mappings:
- Drag source fields onto the canvas
- Connect fields to entity types and properties
- Draw relationship lines between entities
- Zoom and pan to navigate complex mappings
Mapping Components
Source Fields
Define the raw fields available from your data source. Each field has:
- Field name — The column or property name in the source data
- Data type — String, number, date, etc.
Node Mappings
Map source fields to entity properties:
| Configuration | Description |
|---|
| Entity Type | Which ontology entity this maps to |
| Property Mapping | Which source field populates which entity property |
| Identifier | Which field uniquely identifies this entity |
Relationship Mappings
Define how entities are connected:
| Configuration | Description |
|---|
| Source Entity | The starting node of the relationship |
| Target Entity | The ending node of the relationship |
| Relationship Type | The type of connection between entities |
Editing and Deleting
- Click any mapping row to edit its configuration
- Use the delete action to remove a mapping
Deleting a mapping does not remove entities or relationships already created in the knowledge graph. It only prevents future data from being mapped using that configuration.
