Introduction

Basic instructions for creating a project and starting editing it

1. Project creation/deletion

Create new 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.
On the top right corner, click [+] button to add the project.
Add window will be prompted to input following parameters:
- Project name
  - Name of the new project (e.g. {ST.PROJECT.NAME})
- Project description
  - Description of the project
- Project type
  - Type of the project (OWL, SKOS, SKOS-XL). Only SKOS-XL is available at the moment.
- Base URI
  - Specify the base URI for the project e.g. (http://aims.fao.org/aos/agrovoc/)
- 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)
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 a plain Sesame2 project (no OWLIM)

1. select “in memory/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.

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
- Scheme label
- Scheme language
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.

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)

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

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

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.

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.

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

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)