Versions Compared

Old Version 9

changes.mady.by.user Armando Stellato

Saved on

compared with

New Version Current

changes.mady.by.user Armando Stellato

Saved on

Key

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

...

Table of Contents

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.

The sample thesaurus, the "Land and Water" FAO vocabulary, is available for download (see later section on loading pre-existing data)

So follow strictly the "e.g." suggestions if you want to get this working with the provided 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 (Connection URL to Semantic Turkey Server (ST Server) )
  • 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 StoreStores: 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 OWLIMas a starting point, we will use sesame internal triple stores)
    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.
  • The "Add scheme window will be prompted " 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.
  • 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 fileThis option will import ontology from the locally by providing 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

    • 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 [Load data] link in the main menu bar.
  • Input following parameter
    • Base URI: base uri of the data to be imported. (e.g. http://aims.fao.org/aos/agrovoc/)
    • RDF file: browser data file to be imported. (e.g. agrovoc_wb_20130507_VB.nt)
  • Click [Import button] to import data.
  • This process may take some time depending on the size of the data.

6.   Enabling indexing

  • 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.

 

    • 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

Ok, test drive done...time now for seriously managing a big thesaurus!

As a first thing, we recommend to work with a separate data server1, with the proper triple store and its setup balanced for your needs.

You can use a sesame2 remote connection to a sesame2 server (see related section of the sesame2 manual for how to setup a server). Remember to enable RDFS Reasoning and a Hierarchical Reasoner if you want to exploit the reasoning capabilities of VB (though this will affect performances).

Also, we recommend use of other triple stores if you have the necessity to manage large quantities of data and/or if you want to exploit OWL reasoning capabilities. Currently in fact, VB is best adopted with a triple store supporting at least hierarchical inferencing and RDFS/OWL reasoning, however, Sesame has usually poor performances on even average size repositories when its reasoning sails are being activated.

For using the remote connection, just follow these instructions:

  • create an empty repository on your sesame server, and remember the Repository ID you chose
  • Now, on VocBench, create a new project, then...
  • Select the remote access option
  • VB will prompt to input the following parameters:
    • repositoryId
      • ID of the sesame2 repository to be accessed 
      • This should match the ID value used in repository (Repository ID value while creating new repository in OWLIM)
    • serverURL
    • Username
      • Identifier for the user connecting to the rdf repository
      • If not applicable, add “test” as this is mandatory field
    • Password
      • Password for the user connecting to the rdf repository
      • If not applicable, add “test” as this is mandatory field
    • Click on the [?] icon to view each field information.
    • It is assumed that the Data Server is already running and the specified repository has been created.
    • Click [Add] button to create the project.
    • The newly created project will be added to the list.

 

In this page on the Semantic Turkey wiki there are some information for using VB/ST with other triple stores.

Appendix: Creating a new User

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

To add a new user in VocBench follow these steps:

...

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)


[1] in VB2.1, which is still based on Semantic Turkey 0.9.1, there is still a nasty bug about projects being deleted (or corrupted) when access to their data fails (actually a portion of code collapsing both the case of a wrongly set remote-connection project, which is rolled back by removing its folder, and the case of a project failing to access its data for any reason, which should obviously not end up in deleting it!). Accessing a separate data server with a remote connection also prevents from any accidental data loss of this kind.