Introduction
This is a simple test drive for you to try VocBench by using the embedded sesame component for creating a very simple project. We will use a small thesaurus developed in FAO as a test data sample. So follow strictly the "e.g." suggestions if you want to get this it working with the provide example.
Create a new project
- Login with the administrator privilege (Only administrator are allowed to delete the project)
- Once logged in, the list of currently available project will be displayed.
- On the top right corner, click [+] button to add the project.
- A window will be prompted to input the following parameters:
- Project name (e.g.
LandAndWater
) - Project description (
A project describing concepts about Land and Water Management
) - Project type (Type of the project (OWL, SKOS, SKOS-XL). Only SKOS-XL is available at the moment)
- Base URI: (e.g. http://www.fao.org/landandwater/ it is important to keep the ending "/" )
- Semantic Turkey Server URL
- Connection URL to Semantic Turkey Server (ST Server)
- It is assumed that ST Server has been started, if not start the server
- URL:(<serverprotocol>://<serverip>:<serverport>/<servletpath>)
- e.g:(http://127.0.0.1:1979/semantic_turkey/resources/stserver/STServer)
- Project name (e.g.
- Click [Connect] button to test the connection to ST Server.
- If failed, will prompt service failed message. Check if ST Server is running and connection URL is correct.
- In case of successful connection, it will prompt list of triple Store: OntologyManagerFactorySesame2Impl
- After triple store selection, it will prompt for available triple storage mode as follows
- In memory/persistent
- In memory/no persist
- Native store/persistent
- Remote access
- select “in memory/persistent” or "native store/persistent"
- You can leave the other parameter values (1000, true, true) as they are
Manage the SKOS Concept Scheme
- After login, you will be directed to concept module.
- If no concept scheme is selected by default, you will be prompted to go to Scheme module to select concept scheme.
- Click on the [Schemes] link on the main menu bar, to go to Schemes module.
- List of available concept schemes will be displayed.
- If none of them is available, click [+] button on top right corner of list box to add new scheme.
- Add scheme window will be prompted to add following parameters:
- Scheme URI (e.g. http://www.fao.org/landandwater no ending slash "/" here )
- Scheme label (e.g. "core scheme for the land and water thesaurus")
- Scheme language (e.g. "en")
- After clicking [Add] button, newly added scheme will be displayed in the list.
- To select the scheme, click on the check box.
Now that a scheme has been created, you can start editing concepts. Anyway, let's start from a pre-build thesaurus, by loading its data
Loading pre-existing data
- By first, download this file: https://bitbucket.org/art-uniroma2/vocbench/downloads/LandAndWater_20131001.nt into your file system
- To load the RDF from the above file, click on the [Load data] link in the main menu bar.
- Input following parameter
- Base URI: base uri of the data to be imported. (e.g. http://www.fao.org/landandwater/ )
- RDF file: browser data file to be imported. (point to the location where you downloaded the LandAndWater file)
- Click [Import button] to import data.
Creating a new User
We suppose here that you are both the user and administrator of vocbench
To add a new user in VocBench follow these steps:
- Go to http://localhost:8080/vocbench-2.0/index.html and click on "Create an account" under the login form on the right of the page
- Input all the required information. It is better, even if it is not mandatory, to specify the "Languages you wish to manage" and the "Ontology you wish to manage"
- At this point the account is not yet allowed to log on.
- As a user, you can wait for the confirmation email that a request has been sent to the administrator
- As administrator, you can wait for the email and follow its instructions
If you do not receive any email (maybe a misplaced configuration) you need to manually enable the account by modifying the admin DB (see FAQ 1)