...
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
- Project Creation/Deletion
- SKOS Concept scheme Management
- Ontology Import
- Namespace Prefix Mapping Management
- Loading pre-existing data
- 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
- 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 nameName of the new project name (e.g. {ST.PROJECT.NAME}
- 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
- 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 web
- This option will import ontology from the web by providing following parameter
- Base URI: base uri of the ontology (e.g. http://www.w3.org/2008/05/skos-xl#)
- Alternative URI: web url for ontology file (e.g. http://www.w3.org/2009/08/skos-reference/skos-xl.rdf)
- This option will import ontology from the web by providing following parameter
- Add import from web
- 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)
- This option will import ontology from the locally by providing following parameter
- Add import from local file
- Add import from web to mirror
- This option will import ontology from web and store in the server as mirror by providing following parameter
- Base URI: base uri of the ontology (e.g. http://www.w3.org/2008/05/skos-xl#)
- Mirror file: Name of the ontology file to be stored in server (e.g. skos-xl.rdf)
- Alternative URI: web url for ontology file (e.g. http://www.w3.org/2009/08/skos-reference/skos-xl.rdf)
- This option will import ontology from web and store in the server as mirror by providing following parameter
- Add import from web to mirror
- Add import from ontology mirror
- This option will import ontology from the mirror file available in the server by selecting from the list
- Add import from ontology mirror
- 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).
...