Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Introduction

following recent updates in VocBench, these instructions will be completely rewritten for a quicker test drive, by using a small concept scheme and loading it with the triple store technology embedded with Sesame2. Expect improvements soon

Project Management

The following sections instruct the user on how to create a new project

  1. Project Creation/Deletion
  2. SKOS Concept scheme Management
  3. Ontology Import
  4. Namespace Prefix Mapping Management
  5. Loading pre-existing data
  6. Enabling Indexing

1.   Project creation/deletion

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.
  • Add A window will be prompted to input the following parameters:
    • Project nameName of the new project name (e.g. {ST.PROJECT.NAME}LandAndWater)
    • Project description Description of the project(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 URISpecify the base URI for the project : (e.g. (http://aimswww.fao.org/aos/agrovoc/landandwater/  it is important to keep the ending "/" )
    • Semantic Turkey Server URL
  • 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
    Creating now, to create a plain Sesame2 project (no OWLIM)
    1. select “in memory/persistent” or "native store/persistent"
    2. You can leave the other parameter values (1000, true, true) as they are
    3. Continue with the instructions as in “Running the system”

 

 Delete project

  • Login with the administrator privilege (Only administrator are allowed to delete the project)
  • Once logged in, list of currently available project will be displayed.
  • Select the project to be deleted.
  • On the top right corner, click [-] button to delete the project.
  • Delete window with project name will be prompted.
  • Click [Delete] button to confirm deletion.
  • Delete project will be removed from the list.

 

...

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.
  • To delete the scheme, click [-] button on the right end of each scheme.
  • Delete scheme window with scheme URI will be displayed.
  • Click [Delete] button to remove the concept scheme.
  • NOTE: Add/delete scheme is available only to administrator but selection of concept scheme is available to all users.

3.   Ontology Import

  • To import ontology, follow these link on the top menu bar
    • Administration > Ontology
  • Under Imports box, list of imported ontology will be displayed.
  • To import ontology, click [+] button on the top right corner
  • Four options are available
    • Add import from local file
      • This option will import ontology from the locally by providing following parameter
        • Base URI: base uri of the ontology (e.g. http://www.w3.org/2008/05/skos-xl#)
        • Local file : browse locally available ontology file (e.g. c:\skos-xl.rdf)
        • Mirror file: Name of the ontology file to be stored in server as mirror file (e.g. skos-xl.rdf)
    • Add import from ontology mirror
      • This option will import ontology from the mirror file available in the server by selecting from the list
  • To delete the imported ontology, click [-] button on the right end of each ontology.

4.   Namespace Prefix Mapping Management

  • To manage namespace, follow these link on the top menu bar
    • Administration > Ontology
  • Under namespace management box, list of available namespace with their prefix will be displayed.
  • To add new namespace, click [+] button on the top right corner
  • Provide namespace (http://aims.fao.org/aos/agrontology#) and prefix (agro) and click [Add] button.
  • To edit namespace, click [pen] button on the right end of the namespace in the list.
  • Change namespace prefix and click [Edit] button.
  • To delete namespace, click [-] button on the right end of the namespace in the list.
  • Delete namespace window will be prompted with namespace and prefix.
  • Click [Delete] button to delete the namespace.

5.   Loading pre-existing data


  • To load RDF data, click on the [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://aimswww.fao.org/aoslandandwater/agrovoc/ )
    • RDF file: browser data file to be imported. (e.g. agrovoc_wb_20130507_VB.ntpoint to the location where you downloaded the LandAndWater file)
  • Click [Import button] to import data.This process may take some time depending on the size of the data.

...

  • .

...

  • To enable indexing, click on [Advanced search] link below top menu bar at the top right end.
  • Click on the [index] button at the right end.
  • It will prompt to confirm if you want to index. Click the [Ok] button to enable indexing.
  • This process may take some time.
  • This action is only available to administrator users.

...

Creating a new User

We suppose here that you are both the user and administrator of vocbench (see section 4 on VOCBENCH setup).

...