Overview
The IVE provides different import functionalities to get your data into the system.
For Users
The CREATOR is the recommended way to create new entries or manage you existing entries.
TODO: document how to encode videos.
For Admins
To restore existing data into a fresh installation, media files and database content need to be set up separately:
Media files
- If you have imported the CSV files of available scenarios from step 1.2.1. you have to download the required media files
- All content for the IVE (videos, thumbnails and overlay images, etc.) is available on the university cloud storage Sciebo. Please create an account, if you don’t have one yet.
- Then create in your repository the following folders:
public/videos
public/images
public/thumbnails
public/objects
- After that, ask a local team member of the Situated Computing Lab to get access to the online folders of the cloud storage. You can decide which material of the available scenarios you want to download or to download them all. Attention: Please check out the file sizes of the folders before you actually download them!
Neo4j data directory
When restoring a backup or working with docker, it might be easiest to copy the whole neo4j data directory over from an existing installation
This is located at /var/lib/neo4j/data
or in neo4j docker at /data
.
Note: The database needs to be stopped before copying!
Cypher queries
This option is on the database-level and a direct way to your data via the browser interface of Neo4j. It also provides graph-visualizations and more.
Open https://localhost:7474 to access the graphical user interface with the built in neo4j-shell.
- If you want to see your full graph, type in the following cypher query:
MATCH (n) RETURN (n);
- For inserting your data manually, please find the cypher queries below.
If you want to see all queries, which are used in the IVE, checkout the repository folder queries/*
For Developers
To restore existing data into a fresh installation, media files and database content need to be set up separately. See Media files.
CSV files
The source repo contains an example graph database encoded as CSV in data/
.
To import this, use the script node setup.js
.
This is the simplest approach for debugging.
TODO: How to export such CSV files?
prerequisites
- You need node.js installed, see here.
- You need environment variables or a
.env
file for configuration. - If you want to import the data from the CSV files of
IVE/data/*
, you need to setup the import-path for Neo4j. Open the config filesudo nano /etc/neo4j/neo4j.conf
and set the directory to the path of your local repository, e.g.:dbms.directories.import=/home/sitcom/IVE/data/
REST-API
The REST API can be used as well for data imports.