Introduction

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 it has not, then start it now
    • put http://127.0.0.1:1979/semantic_turkey/resources/stserver/STServer
• 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 a list of available triple Stores: 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
    
    
  now, to create a plain Sesame2 project (no OWLIM)

1. 1. select “in memory/persistent” or "native store/persistent"
   2. 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.
• The "Add scheme" dialog will prompt you to add the 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, the 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-built thesaurus, by loading its data (next section)

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 into VB, 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.

Start playing around

Project is ready, some sample data has been loaded...time to play around now! things like editing new concepts, lexicalizations etc..

We will be adding more docs soon. In the meanwhile, you can follow those videos reported here: http://aims.fao.org/tools/vocbench-2/support-material

Features still to be implemented

Currently, the search engine is working only with OWLIM SE. Unfortunately, there is no standard for advanced search (like indexed search) in current triple stores, se each triple store is a story on its own.

We need to implement a coherent search interface, and then have different connectors for various technologies...and this should be part of our triplestore agnostic interface...

One thing we will do soon, is to have a simpler approach: we just implement a simple search (no indexing), and then we allow to use the more advanced search of OWLIM-SE in case the user is using it. Later, we will work on the more general interface.

Appendix: 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)