Home

User Manual

Contents

1. node Figure 104 Properties area Domains amp ranges tab 10 2 Operations on Properties 10 2 1 Add a new property This action may be performed by Publishers and Administrators To add a new property take the following steps 1 Choose where in the hierarchy to add the new property 2 Click on the icon in the bar above the property hierarchy Figure 98 a window opens with the title Create new property Create new property Label Langusge Select Position None Figure 105 Create new property VB v2 1 User Manual In the window add the following pieces of information a Label b Select Language from the drop down list c Click on the Submit button Page 91 of 101 VB v2 1 User Manual Page 92 of 101 11 Schemes module The Schemes module is only accessible to Administrators Recent changes Concepts Relationships Validation Load data Export Statistics The module lists the SKOS concept schemes managed by the VB and offers the possibility to add new schemes Scheme Management sG http www w fao org landandwater s G s Lm http w w w fao org landandwater s Lm s E http wwww fao org landandwater s_E Js Wr http www fao orq landandwater s_ Wr s Wr http www fao org landandwater s_Wr s http w w w fao org landandwater s Js Wh http w w w fao org landandwater s Wh s Wu http www w fao org landandwater s Wu Figure 106 Schemes module Scheme management Note Only one sch
2. Administration Configurstion Lan A Figure 29 Top menu bar Administration Configuration is only available to Administrators Users and Groups are available to both Publishers and Administrators e Users This option shows the users using the same VB installation as you For each user user details user group s language s and ontolog ies are indicated Figure 30 User Management Users W Active Y Inactive Y New User details 12 User group s Administrator a Publisher Publisher a A Usemame lavanya Validator Validator a Ontology editors Ontoeditor a Password Confirm password Term editors Termeditor a Administrator Guest a Johannsen a caracciolo a um yjaques a Email lavanyakirann gmail coi Affiliation ICRISAT yingsean a Address 212 KSI ICRISAT Postal code English zuzana_horvathova agroinstitut a cklee75 a Beto supiah a Country India v URL Registration date 29 112013 beikzadeh a saniah a Work phone Mobile phone 91 9177609798 jamesatcaas a manishps824 a Chat address lavanyakms SKYPE iv tvprabhakar a agrovoc nurul adilla a faotopics bramangkoun a Comment Jasbeer Singh a atifah a ehesse a V Activated Save Cancel UzFl al First name lavanya Last name Kiran Language s tTj Ontology Figure 30 Administration Users VB v2 1 User Manual e Groups Page 32 of 101 This option is used to manage user roles the associa
3. Figure 21 Search option Stats on relations and properties Select the group Stats on Agrovoc specific relations and properties Figure 22 to view the following information o number of subvocabularies of concepts Chemicals Geographical Country level Fishery related terms etc o number of subvocabularies of terms taxonomic terms for bacteria plants animals common name for plants viruses animals etc Note This group is specific to the AGROVOC concept scheme Statistics Stats on Agrovoc specific relations and properties v ja Common name for viruses lo sk zh Common name for plants lo sk zh it tr ms 288 cn Co 0 h O h Co O CO Co CO CO h h CO CO 8 742 17 632 332 526 Figure 22 option Stats on Agrovoc specific relations and properties VB v2 1 User Manual Page 26 of 101 Select the group Stats on workflow Figure 23 to view the following information o total number of users o last user connected o number of users by language o last modification by each user o number of exports for the scheme you are working on Statistics Stats on workflow iv User information Total number of users 56 Last user connected Administrator Count number of users assigned for every language Language User count Arabic ar JRA bn bosanski jezik bs Catala ca Cesky cs dansk da Deutsch de EAANVIKG el English en Espa o
4. Datatype Select i Select _typedLiteral Figure 75 Add a Note VB v2 1 User Manual Page 75 of 101 e Add a relationship between two concepts To create a relationship between two concepts follow these steps 1 Select the first concept by browsing or searching 2 Click on the Relationship tab Figure 76 3 Click on Add new relationship A popup window will appear where you can specify the relation to use and select the other concept in the relation Figure 77 4 To select a relation click on the Browse button and the Relationship browser will open Figure 78 To view the complete list of relation types click on Expand all at the bottom of the window and select from the list the appropriate new relation 5 To select the second concept in the relationship click on the Browse button The Concept browser will open where you can search and browse for the desired concept Figure 79 Once the concept is identified click Submit or Cancel 6 Click the Create button to confirm the new relationship Figure 80 7 The new relationship is now visible in the Concept Term Area Figure 81 J Rice en Terms 33 Definition 0 Mote 0 Attribute 0 Relationship 17 History 07 Image 07 Add new relationship Relationship Concepts ls produced by en G Oryza indicareny Oryza sativa en Oryza japonicalen Figure 76 Create a relationship between concepts Select Relationship tab VB v2 1 User
5. Cancel Figure 79 Concept browser Search related concept Create a new relationship to another concept Relationship ls produced by eni Browse Related concept Oryza glaberrima en Browse Create Cancel Figure 80 Create new relationship between concepts Information added VB v2 1 User Manual Page 78 of 101 4G Rice en Terms 33 Definition 0 Mote 01 Attribute 07 Relationships 2 History 00 Image 07 Add new relationship Relationship Concepts E BE m Oryza indicareny Oryza sativa en Oryza japonica en ls produced by en n i 16 Oryza glaberrima eny African riceten Figure 81 Create new relationship between concepts Completed e View the schemes a concept belongs to 1 Select the concept by browsing or searching 2 Click on the Scheme tab Figure 82 e Add remove a concept to from a scheme In order to add remove a concept to from any of the schemes defined for the edited thesaurus the user has to 1 Select the concept by browsing or searching 2 Click on the Schemes tab 3 Depending on the operation 1 Click on to add the concept to any of the schemes it does not already belong to 2 Click on the symbol close to each of the listed schemes to remove the concept from that scheme Notice that maintaining concepts belonging to different schemes cross scheme management is not trivial According to SKOS all concepts belonging to a scheme must be
6. see Sec 5 2 User languages amp ontologies To add a search language click on the to remove one on the icon VB v2 1 User Manual Page 41 of 101 Search Clear A US S Index 9 Enable indexing Disable indexing y 1 Exact word v Search Clear Search preferred terms only YY mziten in gt AEN 3 Repository NOne So earch in these language s C Term codes Code Eng s Spanish Status All psnis French Arabic Concept scheme Select n Chinese Concept relationships Russian Fortuguese Term relationships Browse a Latin Czech Concept attribute Lao Japanese Term attribute Thai Hindi Figure 39 Advanced search interface An advanced search may be performed by using the same search options described in Sec 6 Search for simple search Moreover three more search options are available 1 Case sensitive Enables a case sensitive search 2 Include notes Includes also content of editorial notes scope notes and definitions in the search 3 Search preferred terms only Restricts the search to terms marked as preferred term VB version 2 3 includes the new search field concept URI In the Advanced search options area the following constraints down below to the search criteria may be applied 6 2 1 Search for relationships between concepts To search for relationships between concepts click on t
7. 2 7 Search for term attribute Terms may be specified by attributes For example Figure 49 shows the list of attributes currently available for AGROVOC terms Click on the icon in the Term attribute field to open the list and select the desired term attribute e g use agrontologyHasTermType to find concepts whose terms belong to a specific VB v2 1 User Manual Page 48 of 101 subvocabulary of terms Select term attribute Relationship None None agrontology hasPlural agrontology hasSingular agrontology hasTermType agrontology hasSpelling Variant Figure 49 Advanced Search Search for term attribute A new field Value is added select here the subvocabulary you want to search in e g Common name for plants Figure 50 and click on Add Select term attribute Relationship agrontology hasTermType Value Acronym y Acronym Common name for animals Common name for bacteria Common name for fungi Common name for plants Common name for viruses Taxonomic terms for animals Taxonomic terms for bacteria Taxonomic terms for fungi Taxonomic terms for plants Taxonomic terms for viruses Figure 50 Advanced Search Search for Common name for plants 6 3 Concept navigation history The orange button Concept navigation history in the bottom of the search area Figure 51 gives you a chronological overview of the concepts navigated during your current session indicating date and time
8. 45 46 47 47 48 48 49 49 50 52 56 57 58 60 61 62 63 65 66 67 67 67 68 68 VB v2 1 User Manual Figure 69 Figure 70 Figure 71 Figure 72 Figure 73 Figure 74 Figure 75 Figure 76 Figure 77 Figure 78 Figure 79 Figure 80 Figure 81 Figure 82 Figure 83 Figure 84 Figure 85 Figure 86 Figure 87 Figure 88 Figure 89 Figure 90 Figure 91 Figure 92 Figure 93 Figure 94 Figure 95 Figure 96 Figure 97 Figure 98 Figure 99 Alignment tab Create a new concept Add term and language Create new concept Concept already exists Create a new concept Select Preferred term Delete concept Warning message Add definition Add a Note Create a relationship between concepts Select Relationship tab Create a new relationship between concepts Relationship browser Create a new relationship between concepts Concept browser Search related concept Create new relationship between concepts Information added Create new relationship between concepts Completed Adding removing a concept to from a scheme Add Edit Delete term Add new term Edit term Delete term Information about a Term Tab History Information about a term Tab Relationship Information about a term Tab Attribute AGROVOC example Information about a Term Tab Notation AGROVOC example Properties module Select the required type of property Example of object properties for AGROVOC Example of Datatype properties
9. Figure 52 VB v2 1 User Manual Page 49 of 101 Exact word A Go Advan search Figure 51 Search area Concept navigation history amp content language Concept navigation history O 2014 03 17 12 12 48 ie MOND de Moon en Luna es Lune fr Luna it O 2014 03 17 12 12 46 rA MODELL de Models en Modelos es Mod le fr Mod le d exploitation fr Modelli it O 2014 03 17 12 12 32 el FOSSIL de Fossils en F siles es Fossile fr Fossili it O 2014 03 17 12 07 34 rey PRIVATDARLEHEN de Private loans en Pr stamos privados es Pr t prive fr Prestiti privati it 2014 03 17 11 13 52 C Heide de Heideland de Moorland de heathland en moorland en moors en Brenal es Landas es P ramos es Tierra yerma es Brande fr Lande fr Brughiere it Landa it Territorio di brughiera it 9 2014 03 17 11 13 32 ii Habitat de habitats en Habitat es Sitio ecol gico es Habitat fr Habitat it 2014 03 17 11 13 14 Figure 52 Concept navigation history 6 4 Content language The orange button Content language in the bottom of the search area Figure 51 gives the option to select the languages you would like to search and visualize concepts in The languages you select here are only related to searching and visualizing and only for the current session Figure 53 In Preferences you may set the languages in which you would like to edit concep
10. Property Users Note mM Validate VB v2 1 User Manual Page 95 of 101 10 11 Shows the concept in case the change belonged to the concept e g the creation of new concept a new term a new concept to concept relationship Shows the term in case you add any term term relationship Change shows the current value of the element Old value shows the previous value of the element Action indicates the action applied to the element Owner shows the owner of the element Modifier indicates by whom the change was performed Creation date shows when the element was created Modified date indicates when the change was applied Status shows the current status of the element Validate option to accept or reject the modification Note Here you may enter a comment regarding the validation The comment is automatically sent to the modifier 12 1 Validation filter You may filter the list of validation actions presented in the Validation table There is an Apply filter option at the top right of the Validation module Figure 110 The filter functionality is very useful when there is a long list of issues to be validated Clicking on Apply filter a window opens showing the following specific filter options to facilitate the selection for validation Figure 111 VB v2 1 User Manual Page 96 of 101 Validation filter Filter by user Filter by action Filter by status Administrator A concept crea
11. Show only terms of selected languages under Preferences see Sec 5 2 User languages amp ontologies is unchecked e Definition Shows the definitions available for the selected concept e Note Shows available editorial and scope notes Figure 64 VB v2 1 User Manual Page 67 of 101 Lal genetically modified orqanisms en aa ufzafda aie hi Show inferred and explicit Definition 1 Coe AE Attribute 0 Add new notes Source Glossary of Biotechnology for Food and Agriculture FAQ 2001 http www fao org DOCREP 004 Y 2775E y2T75e00 htm en skos editorialNote Figure 64 Concept term area Note e Attribute Shows the available attributes for the selected concept Figure 65 Gl Asia en Attribute 1 Add new attributes Attributes Value Is part of subvocabulary 9 Geographical above country level Figure 65 Concept term area Attribute e Relationship Shows the relationships between the selected concept and other concepts Figure 66 ii genetic drift en Add new relationship Relationship Concepts Influences en 2 gene frequency en allele frequency en Figure 66 Concept term area Relationship e History VB v2 1 User Manual Page 68 of 101 Shows the history of the selected concept Figure 67 Creation date of concept Date of last update Term status 2 Detailed information on term changes Note This information is automat
12. VB v2 1 User Manual Page 79 of 101 explicitly associated to that scheme the skos inScheme relationship is not inherited along a concept tree According to the above VB filters out those concepts that do not belong to the selected scheme when it expands branches in the concept tree view As a consequence it would be easy to create dangling concepts i e concepts which though belonging to a scheme would never be shown because they are not top concepts for that scheme nor any of their parents belong to it VB prevents these accidental events by performing various checks whenever adding or removing a concept from a scheme If the operation would cause a concept to be dangling with respect to any scheme either the edited concept or one of its narrower concepts then the operation is not allowed An incomplete at the time of writing list of checks associated to each operation is reported in https art uniroma2 atlassian net wiki display OWLART SKOS Cross Scheme Management fe Arable land en Show inferred and explicit Terms 3 Definition 1 Notes 2 Attribute 0 Notation 0 Relationship 0 History 0 Image Add concept to scheme Scheme label Scheme URI http www fao oro landand water http www fao org landandwater http www w fao org landandwater s La http www fao org landandwater s_La http www fao org landandwater s _ y http www fao org landandwater s A Figure 82 Adding
13. Validation module Figure 110 and Figure 112 in order for the system to load the new statuses of the elements Validation Concept Term Refresh validation list Figure 112 Refresh validation list VB v2 1 User Manual Page 98 of 101 16 SPARQL module The SPARQL query module contains e Amenu box for selecting the SPARQL operation QUERY or UPDATE and language version SPARQL 1 0 or 1 143 e Atext area where to write the SPARQL query e An area showing the results in a table 13 since VB can be used with different RDF middlewares restricting the language version to SPARQL 1 0 can be useful for those connected middlewares which do not support SPARQL 1 1 VB v2 1 User Manual Page 99 of 101 VERSION 2 0 1 SNAP SHOT Build 20140221 DEVELOPMENT VocBench SpE Recent changes Concepts Properties Schemes Validation Load data allis SPAROL Concept navigation history Content language SPARQL query Query language SPARQL 1 0 PREFIX lt http aims fao org aos agrovoc gt 2 PREFIX skos http www w3 o0rg 2004 02 skos core PREFIX skosxl http www w3 org 2008 05 skos xl SELECT WHERE c a skos Concept c skosxl prefLabel xl xl skosxl literalForm 1f LIMIT 10 Line 6 Position 1 Query is valid Sa statements e Submit c xl If http aims fao org aos agrovoc c 4788 http aims fao org aos agrovoc x ar 1299485662065 lt ul ar http aims fao org aos agrovoc c 4788
14. actions shown right corner of the Recent changes module Figure 56 The following specific filter options Figure 57 facilitate the search for recent changes term edit term edit term edi term edit term edit term edit termedi term create Action User Yasemn Cevik Yasemn Cevik Yasemn Cevik Yasemn Gevik Yasemin Cevik Yasemin Cevik Yasemin Cevik Yasemin Cevk 21 03 2014 11 01 15 21 03 2014 11 00 42 21 03 2014 11 00 31 21 03 2014 11 00 21 21 03 2014 11 00 03 21 03 2014 10 59 50 21 03 2014 10 59 39 21 03 2014 10 59 22 Click the Apply filter option in the top e Filter by user By default all registered users are unselected To view changes by specific users simply check the check box in front of their name To select all users check the All box at the bottom of the list to uncheck all users check the All box again Note These settings will be saved also for next sessions e Filter by action By default all possible actions are unselected To select actions simply check the appropriate check boxes Note These settings will be saved also for next sessions VB v2 1 User Manual Page 58 of 101 e Filter by date By default all changes are shown since the set up of the VB installation you are looking at You may narrow the time span down by using the options in the Filter by date box To apply the filter click on Submit Filter by user Filter by action Filt
15. agrovoc c 330829 3 http aims fao org aos agrovoc c 6211 17 http aims fao org aos agrovoc c 330705 of http aims fao org aos agrovoc c 330704 21 http aims fao org aos agrovoc c_330998 39 http aims fao org aos agrovoc c_330988 21 http aims fao org aos agrovoc c_4788 36 http aims fao org aos agrovoc c_49904 32 Figure 20 Search option Stats on the structure Select the group Stats on relations and properties Figure 21 to view the following information o number of concept to concept relations o number of term to term relations o number of attributes of concepts o number of attributes of terms for the scheme you are looking at VB v2 1 User Manual Statistics Stats on relations and properties No of C C relations http aims fao org aos agrontology hasPropagationMaterial http aims fao org aos agrontology isBeneficialF or http aims fao org aos agrontology surroundedBy http aims fao org aos agrontology hasCropingSystem http aims fao org aos agrontology has Theme http aims fao org aos agrontologyzspatiallyIncludes http aims fao org aos agrontology hasPhysiologicalF unction http aims fao org aos agrontology hasGenus http aims fao org aos agrontology includesSubprocess http aims fao org aos agrontology isAfflictedBy http aims fao org aos agrontology follows http aims fao org aos agrontology isMeansF or http aims fao org aos agrontology isCompositionOf Page 25 of 101 164 124
16. concept follow these steps 1 Click on Add definition 2 A window opens Figure 74 in which the following pieces of information should be added o Definition o Language select language from drop down list o Source for the definition Possible sources are e g Wikipedia o URL for the source 3 Click Create or Cancel Add definition Definition Language Select gt Mone URL FAOTERM WIKIPEDIA MeSH Other Book Journal Article AGROVOC Wordnet Figure 74 Add definition e Edita definition of a concept It is possible to edit the entire definition or the source VB v2 1 User Manual Page 74 of 101 1 Click on the Edit icon of the item you want to edit 2 Revise definition and submit your changes e Delete a definition of a concept 1 Click on the Delete icon next to the item you wish to delete 2 Delete and confirm e Add a Note to a concept To add a note to a concept follow these steps 1 Click on Add new notes 2 A window opens choose which type of note you want to create and fill in the required fields Note that in the case of Scope note you should choose in the field Datatype the value plain literal Figure 74 subsequently a language field will appear the value typed literal is based on xml schema datatypes xsd which means types like time duration etc 3 Click Create or Cancel Add new notes Relationship skos scopeNote
17. concepts and terms VB v2 1 User Manual Page 60 of 101 E da cius ar vodni rostliny cs Wasserpflanze de aquatic plants en Plantas acu ticas es Plante aquatique fr wearer GMT hi vizin v ny hu Piante Add new term Language Term Di aquastic plants Preferred W English en e m hydrophytes W Pl water plants W e Plantas acu ticas Preferred W Espa ol es ez Vegetaci n acu tica W i Flors scu tics W Francais fr 2 Plante squstique Preferred W Arabic sr e m ada cas Preferred W DN ktg Preferred W SX zh diim sos W Pyockwit ru d scaese pacremua Preferred W m Planta aqu tica Preferred W Portugu s pt x W2 Flora aqu tica W Figure 58 Representation of a concept 9 1 1 User interface The Concepts module displays the top concepts of the concept scheme you selected when you logged in In Figure 59 the top concepts are those of AGROVOC in English VB v2 1 User Manual Page 61 of 101 Recent changes Relationships Concepts rm activities en entities en E events en E factors en El ol fo E Ie lo fol fol lo lo lo lol fo lo features en E groups en E location en EE measure en methods en E objects en E organisms en E phenomena en E processes en E products en El properties en E resources en amp o lee site en E Figure 59 Con
18. date G ar Solanum cs SOLANUM de Solanum en Solanum es cic o fa Mejor ua fa ax fa Solanum fr AAAA hi Solanum hu Solanum it FA ja PEAIS ko Solanum lo Solanum pl Solanum pt Solanum ru 20 11 2011 21 24 22 Solanum sk Solanum th Solanum tr uk amp zh Figure 36 Search result with search option Exact match e Contains With this option you will retrieve the concepts labelled by terms in the languages you selected that contain the word or string typed in Example A search for palm returns all the concepts that are represented by preferred or non preferred terms containing the word palm like Acer palmatum en and macaw palm en Figure 37 Search results Concept iG Acer palmatum en vey Acrocomia aculeata en Acrocomia sclerocarps en macaw palm en LC African fan palm en Borassus aethiopum en Borassus flabellifer sethiopicum en LG African oil palm en Elaeis guineensis en cil palm en ra Ailanthus en ghetto palms en poverty trees en Figure 37 Search result with search option Contains e Starts with With this option you will retrieve the concepts labelled by terms in the languages you selected that start with the search string typed in This search also retrieves composed terms that contain words starting with the string typed in Example In Figure 38 you can see the results of a search for tomato
19. is a living document which will updated as required Still some of the figures may not correspond 100 to the current user interface If you read something that is not clear enough or if you think of something that should be added please write us at aims fao org VB v2 1 User Manual Page 2 of 101 Table of Contents amu issus M 1 TABLE OF CONTENTS csini p E 2 LEGEND oie A a E AE E EA A E A A S 8 FINTRODUCTION est 10 2 REGISTRATION amp LOGIN iaoa enoaan Jac EEE aANT ESENE EOE ER AAE EEEE AN E REEE AARNE a a a 11 PM dci O o PU 12 DZ NOG IN Eta a ron NERO AT 15 S USER INTERFACE Mcr 17 SEP JE 18 FILSON DC 28 3 0 3 ACCESS toO CONTECH Module DAR ri 28 3 1 4 Concept navigation history amp Content language isses enean nennen na nnns sa ansa ansa sa assess aa anna 30 am ppl Esp TION rre mc 31 5 PREFERENCE Sd 33 SL DETAIESOF YOUR USER ACCOUNT rotirea n T un 34 32 USER TANGUAGES amp ONTOLOGIES aaa IA iaa 35 Gs SEARCH A O 37 O ESIMPLE SEARCH A A dos 37 6 2 ADVANCED SEARS 40 62 1 Search Jor relationships between concep Said 41 6 2 2 Search DY both relation AND concept derne ai NUR NS 43 5 2 2 Segre TTE COLES ud esobecalisdsmast dde pecu et tat a basal sb Nee nd E cM esq pcc utl c
20. name Email Affiliation Contact Address Postal code Country URL Work phone Mobile phone Chat Select Chat Types Groups you wish to register for Languages you wish to manage Ontology you wish to manage Comment Max 255 Characters Mandatory field Save Cancel Figure 3 User registration form 1 Fill in the fields Note The fields marked with an asterisk are mandatory 2 Select the groups you wish to register for and the languages and ontologies you wish to manage or contribute to e Select group box Click on the sign and select from the dropdown list the appropriate group s then click on Add Figure 4 Note To select more than one group keep the Ctrl key pressed whilst you click on the groups of your choice VB v2 1 User Manual Page 13 of 101 select group Publisher Validator Ontology editors Term editors Figure 4 Select user group e Select language box Click on the sign select from the dropdown list the language s in which you wish to edit data then click on Add Figure 5 select language Arabic Bengall Al Bosnian L Catalan Czech Danish German Greek Spanish Also known as Farsi Finnish Fijian French Hindi 4 Canes Figure 5 Select language VB v2 1 User Manual Page 14 of 101 Note It is important to make a distinction between settings that determine the languages you want t
21. ra events en o E factors en r features en E rey groups en ie location en E rA measure en ij methods en rA objects en E el organisms en E rA phenomena en il processes en il products en A properties en E Si resources en Figure 17 Export module Top concepts of selected scheme To start the export click Export in the bottom right corner Statistics Statistics is accessible to Ontology Editors Validators Publishers and Administrators It gives you the ability to search for specific facts and numbers of a VB v2 1 User Manual Page 23 of 101 scheme and its editorial status Click on the Statistics dropdown box to select the group of statistical data you are interested in Figure 18 ncepts Properties Schemes Validation SPARQL ICV Select statistical type Select statistical type Stats on the concepts terms languages Please select statistical type from the list Stats on the structure Stats on relations and properties Stats on Agrovoc specific relations and properties Stats on workflow Statistics Figure 18 Statistics Select the group Stats on concepts terms languages Figure 19 to be informed about o total number of concepts o total number of terms preferred and non preferred o total number of top concepts o total number of languages in which the scheme is available o total number of available terms by language for the
22. results B B6 Schemes Validation SPARQL ICV ncept navigation history intent language Figure 11 VB user interface Menu area 3 1 1 General settings The top bar in the menu area marked A in Figure 11 is dedicated to the following general settings e User name Figure 12 1 Signed in as Shows the account name you used for login e Role Figure 12 2 VB v2 1 User Manual Page 19 of 101 Shows the role in brackets you selected when you logged in e g Term Editor see Sec 7 2 User roles e Dataset Figure 12 3 Shows the dataset currently in use e g AGROVOC To change to another dataset click on the arrow and select the desired one from the dropdown box EE 2 Signed in ag User peti ministrator v VocBench MM Figure 12 General settings User name 1 User role 2 Dataset 3 e Global data management Figure 13 Contains data management functionalities working at project scale Global data management Ontology Load data Export IEEE Statistics Refactor Figure 13 Global data management options Ontology Figure 14 This option displays the base URI and namespace of the loaded scheme Default configuration and the vocabularies used in it Namespace management From the Imports box you may import vocabularies for use within the current concept scheme VB v2 1 User Manual Ontology management Default configuration Base URI Default namespace
23. scheme you are looking at Statistics Stats on the concepts terms languages Total no of concepts 32 478 Total no of terms 628 730 Total no of top concepts 25 No of languages available 26 No of terms available in each language Language Term count Arabic ar 25 628 TIT bn 0 bosanski jezik bs 0 Catala ca 0 Cesky cs 40 313 dansk da 0 Deutsch de 30 732 Figure 19 Search option Stats on concepts terms languages VB v2 1 User Manual Page 24 of 101 Select the group Stats on the structure to view the following information about the hierarchical structure Figure 20 O O O O number of concepts under each top concept only up to first level number of concepts under each top concept counting all levels below each top concept depth of branches number of levels underneath each top concept average depth of hierarchy minimum depth of hierarchy maximum depth of hierarchy number of concepts with multiple parentage number of concepts at bottom level leaves of the graph for the scheme you are looking at Statistics Stats on the structure vi No of concepts under each top only first level below top Top concept s Concept count http aims fao org aos agrovoc c_ 13586 15 http aims fao org aos agrovoc c 49874 28 http aims fao org aos agrovoc c 9001017 8 http aims fao org aos agrovoc c 331000 10 http aims fao org aos agrovoc c 7778 6 http aims fao org aos
24. underlying data For instance by hitting CTRL SPACEBAR at the top of a query a list of suggestions will come up through a contextual menu 14 http openuplabs tso co uk demos sparqleditor VB v2 1 User Manual Page 100 of 101 If you select PREFIX normally in Flint you would have to add manually a prefix to the query In VB instead by hitting CTRL SPACEBAR again the list of actual prefixes declared in the current project will be prompted or a generic all prefixes option will immediately copy in the query a multiple PREFIX declaration containing all the prefixes declared in the project
25. use the Term codes field to search for the concept to which the term is related In Figure 44 you can see the term codes currently available in AGROVOC In order to search for a concept with a given term code select the Repository e g skos notation Figure 44 enter the code in the Code search box e g 7698 Figure 45 and click on Search Advanced search options Repository None Search in these language s 2 Term codes None Code agrontology hasCodeTaxonomic English agrontology hasCodelSO3Country Hindi Status TTE agrontology hasCodeF aoterm Telugu agrontology hasCodeAsc skos notation agrontology hasCodeF ishery3Alpha agrontology hasCodeFaoPa agrontology hasCodeAsfa _ Concept scheme Select Concept relationships Term relationships Concept attribute Term attribute Figure 44 Advanced search Search for term codes Select repository Repository skos notation Y Term codes Code 7698 Figure 45 Advanced search Search for term code VB v2 1 User Manual Page 46 of 101 6 2 4 Search for status This option allows you to retrieve all terms concepts having the selected status see Sec 7 1 Status of terms and concepts In order to use this search option select the term concept status from the drop down list e g Proposed or Deprecated Figure 46 and click on the Search button Status All All Classification scheme Proposed by guest Proposed Concept attribut
26. 67 Figure 68 Search options Search result with search option Exact word Search result with search option Exact match Search result with search option Contains Search result with search option Starts with Advanced search interface Advanced search Search by relation Results of Advanced search Search by relation Advanced search Search preferred terms only by Relation AND Word Results of Advanced Search Search by Concept AND Relation Advanced search Search for term codes Select repository Advanced search Search for term code Advanced search Search for status Proposed deprecated Advanced search Search for concept attribute Advanced search Search for Fishery related term Advanced Search Search for term attribute Advanced Search Search for Common name for plants Search area Concept navigation history amp content language Concept navigation history Content language Legend RSS feed VB module Recent Changes Recent changes filter Representation of a concept Concepts module Visualizing the top concepts of AGROVOC Concept hierarchy area A and Concept term area B Buttons on concept hierarchy area Graph visualization of a concept Concept term area Information tabs Concept term area Note Concept term area Attribute Concept term area Relationship Concept term area History Concept term area Hierarchy Page 5 of 101 37 38 39 39 40 41 42 43 44 44 45
27. E n UeE 79 922EgdItOF delete iO SECOS 80 9 2 9 dnftormationdboUt o Term ais aat bata tabu festa vu ore t antes Da dae nr yaa Sos ones site a fad a 81 92 4 Edit information about d LENIN odere uddoe revise cree dde 83 10 PROPERTIES IVIQDULE cine av scecavenineteuavanatovaranetevensoaseanceatavenswesevasecatovatamatabooauate A aE aA 84 INE Ie cade 87 20 1 Properties iierarchy list uisi A ne RET RDUM thee eee peus 88 TOLDO CY EM E A A A A ads 88 TOZ OPERATIONS ON PROPERTIES ronianer R E Ea AE AEE niet even inde EEN A doro aM U UAR iul Dear FU EN iad 90 TOD LAdA NeW DVO CI EY ices sni xt mto o M Pc ut M REM UE 90 11 SCHEMESMODULE cosita ada 92 Ea ADD ANEW CONCEPT SCHEME lt a A a 93 WA VALIDATION MODULE 0 tara iiO 94 ELA AIDA ON TER n 95 12 2 VALIDATE A CHANGE dad 97 16 SPAROE MODULE isis eases dave TERR Sa o dusaussetanesunceacgapedesecabsedsusanens anat E 98 VB v2 1 User Manual List of figures Figure 1 VB entry page Figure 2 Figure 3 Figure 4 Figure 5 Figure 6 Figure 7 Figure 8 Figure 9 Figure 10 Figure 11 Figure 12 Figure 13 Figure 14 Figure 15 Figure 16 Figure 17 Figure 18 Figure 19 Figure 20 Figure 21 Figure 22 Figure 23 Figure 24 Figure 25 Figure 26 Figure 27 Figure 29 Figure 30 Figure 32 Figure 33 User login User registration form Select user group Select language Select ontology Registration confirmati
28. Manual Page 76 of 101 Create a new relationship to another concept Relationship Mane Browse Related concept Mone Browse Create Cancel Figure 77 Create a new relationship between concepts Relationship browser R Is object of activity en IR ls pathogen of en LR ls performed by en IR ls physiological function af en CE practice for en IR ls post production practice for en IRI ls prevented by en j R ls propagation process of ten IRI ls property of en IR ls theme af en IR Performs en IR Prevents en IR Produces en IR Product of fen a R Essive relations en IR Has host or ls vector for en Expand al Collapse all S ubrit Cancel Figure 78 Relationship browser Create a new relationship between concepts VB v2 1 User Manual Page 77 of 101 Concept browser Oryza glaberrima Search View concept tree Search results Concept Last update date r Malignant catarrhal fever virus en 05 11 1998 02 09 00 ra Mycorrhizae en 13 04 2007 19 33 18 ra Endomwycorrhizae en 01 11 2009 17 00 00 ra vam fungi en Vesicular arbuscular mycorrhizae en 11 11 1337 17 00 00 Oryza fatua en Oryza rufipogon en 05 11 1998 02 09 00 Oryza indica en Oryza japonica fen Oryza sativa en 05 06 2009 06 09 43 Oryza longistaminata en 15 05 2009 12 33 27 Oryza perennis en 05 06 2009 05 44 04 Oryza punctata en 18 05 2008 12 34 54 44 stblb Submit
29. Namespace management Namespace prefix eckncyvl Imports http aims fao org aos agrontology Page 20 of 101 http aims fao org aos agrovoc http aims fao org aos agrovoc Namespace http aims fao org aos agrovoc httnc ananw ur nra PONS NS ekns_vwet Figure 14 Global data management Ontology Load data Figure 15 Load data is only accessible to Administrators It is used to bulk load RDF data to the current project This data will be merged with the data currently available in VB This functionality is intended for low level operations carried out by Administrators Import Base URI Format RDF file Figure 15 Load data Select Choose File No file chosen VB v2 1 User Manual Page 21 of 101 Provide the base URI of your data in the Base URI field and upload the RDF file by using the Browse button Upon clicking the Import button in the bottom right corner your data will be uploaded in VB Note Forced selection of file format when importing vocabularies is enabled If not specified it is guessed from the file extension MIME type as usual Note The data you loaded will be visible only if it is compliant with that in the project For example the base uri of the loaded data should be the same as the one of the project into which it is being loaded Export Figure 16 Export is available to all users It is used to export either an entire concept scheme or a single concept fr
30. Ontology you want to work with Figure 8 Select Preferences User group Ontology EI Administrator agrovoc Publisher faotopics Validator Ontology editors Term editors Ontology editors can manage concepts Agrovoc Skos Wersion and relationships They include more experienced terminologists and thesaurus editors Figure 8 Login Select preferences Note If necessary you may add a new existing ontology by clicking on the sign Figure 8 In the pop up window fill in the project ontology name a brief description the Base URI the Semantic Turkey Server URL Figure 9 and click on Add VB v2 1 User Manual Add project Project name Project description Project type SKOS XL a URI Semantic Turkey Server URL Figure 9 Login Add ontology project Page 16 of 101 It is also possible to remove an ontology from the list select the ontology you wish to delete and click on the sign Figure 8 VB v2 1 User Manual Page 17 of 101 3 User interface The language of the user interface for VB is currently available in English default Soanish Dutch and Thai Note You have to decide the language of the user interface on the VB entry page i e the page where you login to access the VB user interface It is a small drop down box at the top right corner of the VB entry page Figure 1 The VB user interface is organized into two different areas Figure 10 1 The menu ar
31. VB v2 1 User Manual Page 40 of 101 Signed in as Administrator Administrator to Agrovoc indexed v Administration About VocBench y A RSSfeed Preferences Help VERSION 1 3 DEVELOPMENT Voc Be nc h Stars win Y tomato Advanced search Last results i Recent changes Relationships Validation Export Statistics Concept navigation history Co Search results Concept Last update date Cherry tomatoes en 24 02 2009 09 46 20 Cyphomandra betacea en Tree tomato en 16 07 2009 09 23 32 Lycopersicon esculentum en Lycopersicon lycopersicum en Solanum lycopersicum en tomato plant en 23 04 2010 04 21 29 Tomato mosaic tobamovirus en Tomato mosaic virus en 23 10 1997 18 00 00 Tomato spotted wilt virus en 30 03 2009 10 35 35 Tomato yellow leaf curl geminivirus en Tomato yellow leaf curl virus en 05 03 2009 07 21 21 Tomatoes en 05 11 1998 02 09 00 44 toi1 gt p gt Figure 38 Search result with search option Starts with e Ends with With this option you will retrieve the concepts labelled by terms in the languages you selected that end with the word typed in 6 2 Advanced search When you click on Advanced search a detailed search form displays Figure 39 In the Search in these language s box you may select languages in which you would like to search during your current session By default it lists the languages you set in Preferences i e the languages you have editing rights in
32. VocBench v2 3 User Manual Last update November 2015 Based on VocBench v2 3 Prepared by Caterina Caracciolo FAO Sarah Dister FAO Sachit Rajbhandari FAO Armando Stellato Food and Agriculture Organization of the United Nations University of Rome Tor Vergata Italy Please contact us at aims fao org VB v2 1 User Manual Page 1 of 101 Executive summary This manual provides instructions on how to use VocBench version 2 3 VB v2 3 a web based vocabulary management tool providing full multilingual support and enabling a formalized workflow It covers editorial operations typically performed by VB Editors Validators and Publishers It also covers functionalities for Administrators but only limited to the management of projects i e not including global system configuration administration The manual first explains how to create a user account Sec 2 Registration amp login specify your user and interface settings Sec 4 Administration and 5 Preferences and interpret the user interface Sec 3 User interface This is followed by sections on how to search VB Sec 6 Search and on the various roles a user may play in the workflow Sec 7 Editorial workflow Subsequently each module is covered in a separate section in the following order Recent changes Concepts Properties Schemes Validation SPARQL the ICV module is not covered for the moment since it is not working due to a bug This
33. ability instead of a Oryza Wen concept URI we use its preferred Oryza en rice plant en term in English in square brackets Oryza en rice plant en marked with followed by three ryze cs dots to indicate the other terms that are representing the concept In case it is useful to show also other preferred or non preferred terms in other languages they are added Everything is in Bold Preferred terms The term plus followed by 9 Oryza en and the ISO language code ARIST ETT hi Everything is in Bold VB v2 1 User Manual Page 9 of 101 Non preferred terms The term followed by and the rice plant en ISO language code Everything is in Bold Relations Italics Bold agrontology hasProducts skos notation Note that all examples are taken from the AGROVOC concept scheme VB v2 1 User Manual Page 10 of 101 1 Introduction VocBenchi VB is a web based multilingual vocabulary management tool developed and hosted by a collaboration between the Food and Agriculture Organization FAO of the United Nations the University of Rome Tor Vergata and the Malaysian research centre MIMOS Berhad VB supports the maintenance of SKOS RDF resources providing support for workflow and editorial processes such as user rights roles validation and versioning that are associated with the development and management of vocabularies VB is adopted by a growing number of user com
34. allValussFrom IR http art uniroma2 it ontologies vocbenchshasSource Figure 96 Example of RDF properties for AGROVOC Figure 97 Concept module Other and Annotation tab 10 1 User interface The Properties module displays the properties of the type selected in the dropdown box i e object datatype annotation ontology properties If present the hierarchy of properties is shown When clicking on a property in the hierarchy a right panel opens same behavior as module Concepts see Figure 98 Properties user interfaceFigure 98 The hierarchy list is shown on the left side while the information relevant to the selected property is shown on the right side VB v2 1 User Manual Page 88 of 101 Recent changes Concepts Export Statistics Properties Object properties we 2 El show URI R agrontology hasTaxonomicLevel R skos hasTopConcept i ah Definition 1 Propery 0 Inverse Property 1 Domains 2 amp Ranges 3 S R skos inScheme asnasa 0 IR skosxl prefLsbel English Has taxonomic level amp R skos semanticRelation IR sxosrelated R agrontology hasParent R agrontology hasAntonym 2 R sgrontology taxonomicRelationship TT agrontology hesTaxonomicve R agrontology hasGrestGroup R sgrontclogy hasSpecies Figure 98 Properties user interface 10 1 1 Properties hierarchy list Starting from the left there are a number of buttons with the following functionalities Properties Object prop
35. cepts module Visualizing the top concepts of AGROVOC If you click on any of the concepts in the concept hierarchy the screen divides into two parts as shown in Figure 60 The entire hierarchy is shown on the left side A Concept hierarchy area while the information relevant to the selected concept i e its terms information about the terms definitions relationships etc is shown on the right side B Concept term area VB v2 1 User Manual Page 62 of 101 Administration AboutVocBench Rh RSSfeed Preferences Help Sign out VERSION 1 3 DEVELOPMENT VocBench Exact word Recent changes Relationships Validation Export Statistics Concept navigation history Content language Concepts C m Show URI Show also i Gaeabionta en life on earth en organisms en e G activities en Gj entities en ig events en Add new term flecos an G features en 2 organisms Preferred y Gaeabionta en life on earth en organisms e G groups en 10 location en English en Gaeabionta y 2 life on earth Y G measure en Espa ol es Organismos Preferred W7 ra methods en Ways of doing en mM objects en Francais fr 2 Organisme Preferred NJ G phenomena en G processes en B PX zh Preferred W ll produce en products en G Properties en Y resources en Cesky cs organismy Preferr
36. displayed Recent changes Concept Term Relationship Users LG Photosyst me tr Fotosistemi it Fotosistemas es PHOTOSYSTEM de Photosystems en IC CHLOROPLAST de Cloroplasti it chloroplasts en Chioropiaste fr Cloroplasto es LG Amiopiasto es AMYLOPLAST de Amylopiast en Amyicolaste fr Amiloplasto t lO PLASTID de Plastidi it Plastidios es Plastids en Piaste fr WG Cell nucieus en Nucieo della celula t N cleo es Noyau cellulare fr ZELLKERN de nucleus en NUCLEUS de Nucleo 1 WC Cell nucleus en Nucleo della celula 2 M cieo es Noyau cellulare fr ZELLKERN de nucieus en NUCLEUS de Nucleo t O Cell nucleus en Nucieo della celula 2 N cleo es Noyau cellulare fr ZELLKERN de nucleus en NUCLEUS de Nucleo 1 UG Miocondris es CHONDRIOSOM de Condrioma es Condriosomi 4 Condriosomas es Chondriome fr Chondriosomes en Mitochondria en Mitacondri 10 T T T Change fotosistem tr kloroplast tr amiopiast tr J plesbt tr h cre ekirde i tr n ukleus lr cekrdek tr kondriyozom tr Figure 56 VB module Recent Changes 8 1 Apply filter options Old value Fotosistemier tr Kicropiast tr Amioplast tr LJ Plasbdier tr H cre ekirde i tr Nukleus ir Cekrdek tr Filters may be used to reduce the number of
37. e Note The search results are based on your language settings In Preferences you may set the languages in which you would like to edit concepts see Sec 5 2 User languages amp ontologies these same languages are then by default used to search and visualize concepts To use other languages for searching concepts click in the top right corner of the VB user interface on the orange box Content language Figure 34 and select the language s which you would like to use for concept search and visualization see Sec 3 1 4 Concept navigation history amp Content language only valid during your current session Note Last Results Figure 34 displays the results of your last search Note All examples are coming from the AGROVOC scheme 6 1 Simple search saci wore N You may choose one of the following search options Figure 34 Exact word maize Go Advanced search Last result Exact match Contains Concept navigation history Content language starts with Ends with Figure 34 Search options e Exact word default With this option you will retrieve the concepts labelled by terms in the languages you selected matching exactly the word typed in VB v2 1 User Manual Page 38 of 101 Example Figure 35 shows the results of a search for Solanum in this example English is the only language selected VERSION 2 0 Build 20131025 Voc Bench I Solanum Advanced search Recent changes Mode Relatio
38. e feotopics gt n Pending ontology request VB v2 1 User Manual Page 34 of 101 5 1 Details of your user account The details of your user account are displayed in the panel on the left Here you may control your personal information e Login User name Note The user name cannot be changed e New password Confirm password You may change and confirm your password in this field e Email Shows your current email address e New email You may change your email in this field confirm it in the next field e Ontology In case you are an editor of more than one ontology you may state here which ontology you would like to be loaded by default e Set your landing Page To set the VB module you want to visualize after logging in e Language of the interface From the drop down list you may select the language in which you would like to visualize the VB interface Note Currently the user interface is available in English default Soanish Dutch and Thai e Show URI By default the URIs of concepts are not displayed This check box corresponds to the check box Show URI in the Concepts module valid for the current session only e Show also non preferred terms VB v2 1 User Manual Page 35 of 101 By default only the preferred terms are displayed To see also the non preferred terms check this box Note The box corresponds to the check box Show also non preferred terms available in the Concepts module Sho
39. e Revised by quest Revised Proposed deprecated Term attribute Deprecated Validated Published Deleted Figure 46 Advanced search Search for status Proposed deprecated 6 2 5 Search for concept scheme Use this option to select the scheme you want to search in 6 2 6 Search for concept attribute Use this search option to find attributes for example concepts belonging to a specific subvocabulary of concepts Figure 47 Click on the icon to open the list and select the desired concept attribute e g agronotology IsPartofSubvocabulary VB v2 1 User Manual Page 47 of 101 Select concept attribute Relationship agrontology isPantOtsubvocabulary agrontology isspatiallyincludedinCity agrontology isHolaBy skos scopeNote skos note skos editorialHote skos example skos changeNote skos historyNote Figure 47 Advanced search Search for concept attribute Example Search for a fishery related term Figure 48 After selecting agrontology IsPartOf Subvocabulary from the drop down list a new window opens in which you may select Fishery related term Select concept attribute Relationship agrontology isPartOfsSubvocabulary E Value Chemicals Chemicals Geographical country level Geographical above country level Geographical below country level Fishery related term Add Cancel Figure 48 Advanced search Search for Fishery related term 6
40. ea Figure 10 I Menu This area is organized into three horizontal menu bars o General settings top menu bar Figure 10 A o Search central menu bar Figure 10 B O Access to different modules bottom menu bar Figure 10 C 2 The content area Figure 10 IIl Content displays the module you selected VB v2 1 User Manual Page 18 of 101 Signed in as Johannsen Administrator to agrovoc Administration AboutVocBench RSS feed C Preferences Help Sign out LA VERSION 2 0 Build 20131025 VocBench Recent changes Relationships Schemes Validation Load data Export Statistics Concepts 2 4 aktivity cs Aktivit t de activities en actividades es activit fr Attivit it Aktiviti ms etkinlik tr ninrieHicre uk 43 zh E celky cs Einheit de entities en entidades es entit fr varl k tr recnonapceko ekonowiuHi ognHnyji uk 3244 zh E charakteristiky cs Merkmal de features en Caratteristiche it nitelik tr puen uk FTE zh faktory cs Faktor de factors en factores es facteur fr Fattori it fakt r tr unnHHuxu uk AIS zh Il Content jevy cs Ph nomen de phenomena en fen menos es ph nom ne fr fenomen tr asuwa uk MER zh lokality cs Lage de location en Luogo it S Al ko Lokasi ms konum tr micuyeshaxopxeHHa uk amp l tky cs Stoff de
41. ected concept to a new child concept VB v2 1 User Manual Page 64 of 101 e Unlink concept To unlink the selected concept from the hierarchy e Add concept to scheme H VB supports the management of multiple schemes inside the same project This functionality allows you to make the concept also belong to another scheme within the same project e Remove concept from scheme The opposite of the above allows you to detach a concept from a given scheme e View graph Opens a new window or tab with a graphical representation of the selected concept and its relations with other concepts Figure 62 8 http www w3 org TR skos reference schemes 2 For now up to a limited extent Works perfectly when schemes are meant have no concept overlap There is limited support for having concepts belong to more schemes VB v2 1 User Manual Page 65 of 101 75 VocBench Version 1 3 C m VocBench Graph Visualizat C 202 73 13 50 enchdew1 3i arat il Zoom ly a Mm Has a related type wmm Is sub concept of E Figure 62 Graph visualization of a concept Next to these buttons there are two check boxes to select what to show in the concept hierarchy Figure 61 e Show URI Shows the URI of the selected concept e Show also non preferred terms Preferred terms are displayed in bold and non preferred terms are shown next to them Concept term area B The concept term area B Error Reference source no
42. ed NJ ra site en G stages en uj state en Bahasa Melayu ms organisma W ra strategies en G subjects en substances en ra systems en LG Technics en technology en Pycckuii ru opraHnu3mbl Preferred NJ Deutsch de Lebewesen Preferred W7 1 time en K Legend Proposed W Validated Bil Published Bill Revised Mi Proposed deprecated Bill Deprecated Show more oe FAO 2011 Figure 60 Concept hierarchy area A and Concept term area B Concept hierarchy area A Starting from the left there are a number of buttons with the following functionalities Figure 61 VB v2 1 User Manual Page 63 of 101 ais Concepts MEE Validation Concepts R kel EHE at 7 X how UBI Show non preterred URI http aims fao_org aos agrovoc c_ 331061 le activities en la entities en lc events en LE le factors en ra groups en tg oL T eX te le location en lc measure en Figure 61 Buttons on concept hierarchy area e Reload concept Refreshes the screen and reloads the selected concept or the entire hierarchy if no concept is selected al e Collapse all This tab collapses the concept or all the concepts when its hierarchy is being expanded e Add new concept To add a new concept to the hierarchy e Delete concept To delete the selected concept TT e Move concept To move the selected concept e Link concept ES To link the sel
43. eme at a time may be displayed in the Concepts module Check in the Schemes module the box of the scheme you want to work with search in Figure 107 Scheme Management Select Y http aims fao org aos agrovoc Figure 107 Schemes Module checked scheme This module contains three buttons with the following functionalities Figure 108 e Reload schemes To refresh the screen e Add a new concept scheme VB v2 1 User Manual Page 93 of 101 e Delete a concept scheme Scheme URI http aims fao org aos agrovoc Op Figure 108 Schemes module Functionalities 11 1 Add a new concept scheme 1 To add a new concept scheme click on in the top right corner of the screen Figure 108 2 Add the Scheme URI the Scheme Label and select the Scheme language from the dropdown box Figure 109 Note Labels may be added only in the languages for which you have editing rights 3 Click Submit or Cancel Scheme URI Scheme label Scheme language Select Figure 109 Add scheme Once you created the new scheme it is added to the list of available schemes VB v2 1 User Manual 12 Validation module Page 94 of 101 The Validation module is available to Validators Publishers and Administrators only The module visualizes all the recent changes that have taken place in VB and need to be validated Recent changes Concepts Relationships mies Validation Load data Export Statistics When entering the Val
44. er Manual Page 51 of 101 7 Editorial workflow VB is a web based multilingual editing tool which implements a formalized workflow to allow for contributions by distributed editors The workflow supported by VB is based on two notions the fact that ontology elements have statuses and that users have editing roles Users may have more than one role assigned but they can play only one role at a time 7 1 Status of terms and concepts When a user creates or edits a term or concept the system assigns it a status of approval in the workflow Possible statuses are Proposed A user has proposed a new concept term The term concept is drafted and has not yet been approved Revised A user has revised an already existing term concept The revision has not yet been approved Validated A proposed revised term concept has been approved by a Validator Only after it has been reviewed by a Publisher will it get published Published A validated term concept has been approved and confirmed by a Publisher Only published terms and concepts are included in the public version of the scheme Proposed Deprecated A user proposes to remove a term concept This needs to be approved by a Validator or Publisher Deprecated A proposed deprecation of a term concept has been approved by a Validator or Publisher The term concept is considered as outdated VB v2 1 User Manual Page 52 of 101 Note The legend for the status of concepts and te
45. er by date Administrator concept create Today andrea concept delete This Week arterisk concept edit relationship create This Month atifah concept edit relationship edit From DD MM YYYY avoc Uk concept edit relationship delete beikzadeh term create To DD MM YYYY bingyan term edit bramangkoun term delete caracciolo term relationship add cklee75 term relationship edit crystalwying term relationship delete cwbong term note create Dister term note edit dlukose term note delete edenizaslani term attribute create ehesse term attribute edit GJohannsen term attribute delete GRFFNPII OT 02 concent edit note create Clear Date Page size 15 Submit Cancel Figure 57 Recent changes filter VB v2 1 User Manual Page 59 of 101 9 Concepts module The Concepts module is available to all roles It is used to e Browse and navigate the hierarchy of concepts e View the information attached to the individual concepts and terms e Add edit delete concepts and terms This section is divided into two parts the first part is dedicated to operations on concepts the second one to operations on terms 9 1 Operations on concepts A concept is anything that is relevant in a given domain A concept is represented by all terms preferred and non preferred and in all languages to which it is associated The entire representation of a concept often includes many terms Figure 58 Both concepts and terms participate in relationships with other
46. erences Figure 25 7 Allows you to manage your account information preferences regarding the user interface and the languages in which you want to edit data see Sec 5 Preferences Note You may also change your password in this section e Help Figure 25 8 Links to this document the VB v 2 1 user manual published on the AIMS and VB project websites 7 http aims fao or VB v2 1 User Manual Page 28 of 101 e Sign out Figure 25 9 To sign out of VocBench Preferences Help Q Sign out 9 Figure 25 General settings Preferences 7 Help 8 Sign out 9 3 1 2 Search The search bar is always available to all users e Simple search Figure 26 Type in the term or phrase you are looking for choosing one of the options from the dropdown list and click GO For a detailed description see Sec 6 1 Simple search Advanced search Exact word Exact match Contains otatistics Concept navigation history Content language Starts with Ends with Figure 26 Menu area B Simple search e Advanced search Opens an advanced search interface that allows you to use more specific search criteria For a detailed description see Sec 6 2 Advanced search 3 1 3 Access to content Module bar The module bar is shown in the bottom menu bar marked C in Figure 11 and Figure 27 Each module is briefly described indicating the user group which is allowed to access it Note Another simple way to find out
47. erties C Show URI Figure 99 Properties buttons e e Reload properties Refreshes the screen and reloads the selected properties or the entire hierarchy list if no property is selected e Add new property To add a new property to the hierarchy list Next to these buttons there is the check box Show URI to show the URI of the selected property 10 1 2 Property area The property area is organized in tabs Figure 100 Each tab provides access to a different piece of information about the selected property For example Figure 100 shows the Label tab for the property has narrower VB v2 1 User Manual Page 89 of 101 IRI skos narrower Label 1 Language Labe English has narrower Figure 100 Properties area Tabs The following other tabs are available IRI skos narrower Definition 1 Language Definition English Narrower concepts are typically rendered as children in a concept hierarchy tree Figure 101 Properties area Definition tab R skos related Property 1 Properties SymmetricProperty Figure 102 Properties area Property tab IR skos narrower Inverse Property 1 Inverse Property R has broader en Figure 103 Properties area Inverse property VB v2 1 User Manual Page 90 of 101 R skos narrower Label 1 Definition 1 Property 0 Inverse Property 1 Seu glace a owl Thing skos Concept Range 5 owl Thing skos Concept
48. ew concept Term Soil horizons Language English me da Concept siresay exis Concept Last update date i Soil horizons en Horizon du sol fr Orizzonti del suolo it 02 09 2013 18 34 54 Figure 71 Create new concept Concept already exists VB v2 1 User Manual Page 71 of 101 If the label does not exist a new window opens Here you choose Figure 72 a The position in the hierarchy where the concept should be added The following possibilities are available i Child of the selected concept ii Same level as the selected concept iii Top level concept b If the new term will be a preferred term by checking the box or not Note Currently the box Preferred is checked by default Figure 72 when a concept is new but if you add more labels it is unchecked Create a new concept Term Language Position Le Ivi Preferred term 3 Show advanced options Figure 72 Create a new concept Select Preferred term 5 Then click Add or Add and repeat if you want to create another term or Cancel to abandon 6 After clicking Add the system takes you to the newly created concept area where you may create other preferred or non preferred terms in other languages by clicking on Add new term see Sec 9 2 1 Add a new term VB v2 1 User Manual Page 72 of 101 9 1 3 Delete a concept This action may be performed by Editors Validators Publishers and Administrators 1 Select the concept i
49. f 101 After this step the selected language will be added to Pending language request box The VB Administrator will receive an email about your language request After approval you will be notified by email Note These language settings refer to editing rights To define the languages in which you would like search and visualize concepts terms use the orange Content language button available in the bottom right corner of the menu area Note The Show only terms of selected languages check box in the left panel refers only to the terms e Pending language request This box lists the languages you requested access to to edit data in these languages e User ontology This box lists the ontologies or datasets you already have access to If you want to remove an ontology select the appropriate ontology and click the button If you want to request managerial rights over a new ontology click on the icon select the available ontology and click on Add The selected ontology will then be added to Pending ontology requests The VB Administrator will receive an email about the ontology request After approval you will be notified by email e Pending ontology requests This box shows the ontologies you requested access to VB v2 1 User Manual Page 37 of 101 6 Search Search functionalities are always available to all users VB allows you to perform a simple search and an advanced search Both are case insensitiv
50. for AGROVOC Example of Annotation properties for AGROVOC Example of Ontology properties for AGROVOC Example of RDF properties for AGROVOC Concept module Other and Annotation tab Properties user interface Properties buttons Figure 100 Properties area Tabs Figure 101 Properties area Definition tab Figure 102 Properties area Property tab Figure 103 Properties area Inverse property Page 6 of 101 69 70 70 71 72 73 74 75 76 76 77 77 78 79 80 80 81 81 82 82 83 83 84 85 85 86 86 87 87 88 88 89 89 89 89 VB v2 1 User Manual Figure 104 Figure 105 Figure 106 Figure 107 Figure 108 Figure 109 Figure 110 Figure 111 Figure 112 Figure 113 Properties area Domains amp ranges tab Create new property Schemes module Scheme management Schemes Module checked scheme Schemes module Functionalities Add scheme Validation module Validation filter Refresh validation list SPARQL querying VB Page 7 of 101 90 90 92 92 93 93 94 96 97 99 VB v2 1 User Manual Page 8 of 101 Legend GUI elements button Bold Click on Add field module form Click on the sign box names Go to the Select language box VB messages on the message Concept already exists Activation of your account on VocBench Statuses of approval of Capitalized Proposed VB elements BEN Deprecated Roles in workflow Capitalized Validator Concepts For read
51. he Browse button Figure 39 in the Concept Relationships field open the Relation browser select the relation you want to search for and click on Submit To perform the search click on the Search button VB v2 1 User Manual Page 42 of 101 In Figure 40 the relation Produces was selected in the Relation browser The search result consists of all pairs of concepts being linked by that relation Figure 41 Relationship browser R ls practice for en IR Is post production practice for en R Is prevented by en R Is produced by en IR Is propagation process of en R Is property of en R Is theme of en R Performs en R Prevents en R en R Product of en a RI Essive relations en R Has host or Is vector for en R Has substitute en R Has symptom en R Has type en R Has vector or Is host for en D Reload relationship Expandall Collapse all Figure 40 Advanced search Search by relation VB v2 1 User Manual Page 43 of 101 VERSION 1 3 DEVELOPMENT VocBench Starts with Recent changes Concepts Relationships Validation Export Statistics Concept navigation history Content language Search results Concept Relationship Concept ul Agricultural machinery industry en o ry Appliances en Equipment en Implements en x Agricultural machinery industry en iR Produces en Installations en Instruments en Machinery en Machinery indu
52. http aims fao org aos agrovoc xl cs 1299485662109 metody cs http aims fao org aos agrovoc c 4788 http aims fao org aos agrovoc xl de 1299485662139 Methode de http aims fao org aos agrovoc c 4788 http aims fao org aos agrovoc xl en 1299485662168 methods en http aims fao org aos agrovoc c 4788 http aims fao org aos agrovoc xl es 1299485662199 M todos es http aims fao org aos agrovoc c 4788 http aims fao org aos agrovoc xl fa 1299485662239 A535 fa http aims fao org aos agrovoc c 4788 http aims fao org aos agrovoc xl fr 1299485662278 M thode fr http aims fao org aos agrovoc c 4788 http aims fao org aos agrovoc xl hi 1299485662314 faerat y iaa hi http aims fao org aos agrovoc c 4788 http aims fao org aos agrovoc xl hu 1299485662353 m dszer hu http aims fao org aos agrovoc c 4788 http aims fao org aos agrovoc xl it 1299485662400 Metodi it FAO 2014 Figure 113 SPARQL querying VB The checkbox at the bottom left of the query area Include inferred statements sets a parameter in the query so that it includes or ignores triples inferred by reasoner from the search space The two buttons at the bottom right Clear and Submit allow respectively for cleaning the query area and for submitting the query The UI engine behind this interface is based on Flint an open source web editor for SPARQL offering syntax completion and highlighting In VB Flint has been customized to interact more deeply with the
53. ically generated E genetic drift en Term 1 Definition 1 Note 0 Attribute 0 Relationship 1 j Image 0 Hierarchy Creation date 1998 09 04 00 00 00 Last update 2011 09 28 19 10 17 Status Published Change Old value Action User Date concept edit ext sour Johannsen 29 09 2011 13 10 Figure 67 Concept term area History e Image Shows if available an image of the concept e Hierarchy Presents in a compact way the hierarchy line from the selected concept to its top term Figure 68 a ACETOBACTER de Acetobacter en Acetobacter es Ac tobacter fr Acetobacter it Show inferred and explicit Terms 20 Definition 0 Note 0 Attribute 0 Notation 0 Relationships 2 History 0 Image 0 Gi Organismus de organisms en Organismos es Organisme fr rm MIKROORGANISMUS de microorganisms en Microorganismos es Micro organisme fr Microrganismi rA BACTERIA de Bacteria en Bacteria es Bacteria fr Bacteria it Figure 68 Concept term area Hierarchy VB v2 1 User Manual Page 69 of 101 In the following we highlight some crucial operations that can be performed on concepts e Alignment Alignments can be set either by Manually specifying the URI of the aligned concept Browsing other thesauri hosted in the same VB instance and searching the concepts to match Free text search is initially powered by the labels of the concept to be mapped though may be freel
54. idation module Figure 110 you will see in ascending chronological order the list of all actions to be validated Validatio Concept Term Rela Change Old value vey actividades es LT activities en 7 activities en activit fr activities en WG Insecta en UE ndlelugu te Insecta fr Insects en Insecte fr INSEKT de Insectos es Insecta es INSECTA de e new term en I new term en e new term en WE new term en T Insects en R Has translation en E AS v Figure 110 Validation module Action term edit term create concept delete concept delete term relationshi Owner Modifier Creation dat Modified dat Administrator Administrator 24 09 2008 Johannsen Johannsen Johannsen lavanya Johannsen Johannsen Johannsen lavanya 18 00 00 05 09 2011 09 36 57 05 09 2011 10 29 16 05 09 2011 10 29 16 05 09 2011 12 46 16 11 08 2011 10 25 12 05 09 2011 09 36 57 05 09 2011 10 30 22 05 09 2011 10 38 12 05 09 2011 12 46 16 Status Validate Revised Accept Reject Proposed Accept Reject Proposed depre Accept Reject Proposed depre Accept Reject Proposed Accept Reject l Accept all L Reject al The validation table contains the following information options in eleven columns 1 Concept Term
55. if a module is accessible to your user role is to check the colors of the module names in the module bar white names are accessible grey ones are not VB v2 1 User Manual Page 29 of 101 Recent changes Properties Schemes Validation SPARQL ICV Figure 27 Menu area C Access to content Module bar e Recent changes All roles Lists recent changes applied to VB such as modifications applied to terms and concepts user registrations etc see Sec 8 Recent changes module e Concepts All roles This module is divided into two panels The left side of the screen shows the browsable concept hierarchy of the concept scheme ontology you selected when you logged in or you selected in the module Schemes see Sec 11 Schemes module the right side visualizes the concept you selected including its terms relationships etc This module is used to add edit delete concepts terms relationships etc see Sec 9 Concepts module e Properties Administrator amp Publisher Shows all the properties available for use in the ontology together with their definitions This module is used to manage properties The actual instances of relationships are visualized in the Concepts module see Sec 9 Concepts module e Schemes Administrator To add or remove concept schemes Note The scheme selected here is the one displayed in the Concepts module see Sec 11 Schemes module e Validation Administrator Publisher am
56. imply check the appropriate check boxes Note These settings will be saved also for your next sessions 4 Filter by date You may narrow the time span down by using the options in the Filter by date box VB v2 1 User Manual Page 97 of 101 5 Page size Figure 111 bottom left corner It allows to enter the number of entries you would like to see displayed per page To apply the filter click on Submit 12 2 Validate a change The following steps are to be followed in the validation process 1 To validate the changes one by one navigate to the Validate column 10th column of table and select from the dropdown box either Accept or Reject Alternatively check at the bottom of the Validation module the checkbox Accept all or Reject all In the Note field last column of table the Validator may enter a comment for example explaining why a change was rejected 2 After accepting or rejecting the issues click on Validate in the bottom right corner 3 After validation by a Validator the element becomes red if it was a revision and green if it was newly created The status of the element is changed to Validated After validation by a Publisher the element becomes blue and its status Published 4 The Modifier will be informed by email that his her changes were accepted or rejected by the Validator Note After each validation you should refresh the validation list by clicking on the refresh button at the top left of the
57. is 45 6 24 Search TOF SEO CNS so toa aactor A a titi 46 62 5 SCORCH TOF CONCEDIT SC NENE s ub Sd 46 6 2 0 SCQICH Tor conceDt att HDUte oa e oe ta ODE en ERE Vea b Dea o ae ete ata ave redu eve Ded e REOR rU 46 Da Segre TOPtermouttHbUte s stitit a ccs van i o Fiunt A 47 6 3 CONCEPT NAVIGATION HISTORY iii 48 Bea CONTENT EAN GUAGE atasco ooo acerco tas acuaneaecncaudde der anteanen sane 49 7 EDITORIAL WORKFLOW m ie ed 51 FAY STATUS TERMS AND CONCEPTS descisssdec assess cota AR darf i euchencdenesscqcusmaaenccouanGenuchsacdouasccsncuen DEOR E 51 DAL USERROLES AT A A da 52 Jan A A nS eig em I UU ale Du ta M TP UE 52 Pz ZAMORA e den UT eddie 53 TDS O igo CNET 54 FUR I eai mH M 54 7 2 5 INS TOTO SS tt Ovis eem der LO dotis dad o Op oom t ales E rou c UD de d e nae tere oe suat ceed 55 S RECENT CHANGES MODULE ias 56 OL APPEL PILTER OP NON Seas 57 S CONCEPTS MODULE e Meere tU 59 S LOPERATIONS ON CONCEPTS 2 ted a diea opel Reais leet ene LIC EE Ue LEM en A epi a ea alae 59 VB v2 1 User Manual Page 3 of 101 TAS aA ot IO ee PCR EE eame bsp Etant A ee ee 60 D 12 AA NEW CONCEP eiii ti A eosdem atas aaa 69 0 14 23 Delete CONCEP s dst E d DE ION VE e Md LUI SEM d LE ETIN eU E ei 72 9 I4 Edit the Information attached to a Concept o oro eaae id 72 ZA I WieTeppi vcce EE 79 9 Did PROG He WE GOIN c aue cuts acest A EA bone MA
58. l es Persian fa suomi suomen kieli fi vosa Vakaviti f Francais fr Qie AN NISN S LANAN On Figure 23 Option on Stats on workflow e Administration Figure 24 4 Gives access to user management such as registered users new user requests Users group management of user groups Groups Configuration of VB Note Users and Groups are available to both Publishers and Administrators Configuration is only available to Administrators see Sec 7 Editorial workflow e About VocBench Figure 24 5 Gives access to information about VB v2 1 User Manual Page 27 of 101 Partners List of partners collaborating in the development of VB Contact us Opens a web form to contact the VB team by email Note The form takes you to the Agricultural Information Management Standards AIMS website which contains a section on VB e RSS feed Figure 24 6 Allows you to subscribe to an RSS feed to be constantly informed about the changes made in a specific dataset i e create edit delete concept terms relationships user accounts and groups new user registrations change of rights By clicking on RSS feed you open the page where you may subscribe for the VB RSS feed simply click on Subscribe Now Administration About VocBench A RSS feed Users 4 Partners 5 6 Groups Contact us Ontology Configuration Figure 24 General settings Administration 4 About VB 5 RSS feed 6 e Pref
59. l the rights of Term Editors Ontology Editors have access to the following VB modules features e Recent changes module e Concepts module e Schemes module e Export e Statistics In the Concepts module Ontology Editors may perform the following e Add edit and delete terms e Add edit and delete relations between terms and any other piece of information for terms e Add edit delete concepts e Add edit and delete relations between concepts and any other piece of information for concepts VB v2 1 User Manual Page 54 of 101 All actions performed by an Ontology Editor get either the status Revised or Proposed depending of the action undertaken and need to be approved by a Validator 7 2 3 Validators Validators are experts that can check and validate the work done by Term Editors and Ontology Editors Validators have all the rights of Term Editors and Ontology Editors Validators may access the following modules features of VB e Recent changes module e Concepts module e Validation module e Schemes module e Export e Statistics In the Concepts module Validators may perform all actions also allowed to Term and Ontology Editors In the Validation module Validators may accept or reject any action that has been proposed by Term and Ontology Editors Those items then get the status Validated or Deprecated in the case of the status Proposed deprecated 7 2 4 Publishers Publishers are those
60. list of changes is presented in reverse chronological order i e latest first Figure 56 A change is split in 6 aspects columns of which each provides a different type of information about the change 1 Concept Term Properties Users Shows the concept when the change belonged to the concept e g the creation of new concept a new term a new concept to concept relationship Shows the term when you add any term term relationship Shows the property when you make any changes in the Properties module 2 Change shows the actual new value e g the new term 3 Old value shows the value before the change took place 4 Action indicates which action was taken e g term create 5 User shows the name of the user who performed the action 6 Date indicates the date and time of the action Other ways to be informed about changes e Subscribe to the RSS feed available in the top menu bar Figure 55 Administration About VocBench Preferences Help Sign out Exact word le Advanced search oncept navigation history Content language Figure 55 RSS feed e Select a concept in the Concepts module and open for concepts the History tab in the concept box and for terms the History tab in the term box see Sec 9 Concepts module VB v2 1 User Manual Page 57 of 101 The information shown in this tab is automatically collected by VB For each concept term the creation date last update and status is
61. munities including FAO s multilingual agricultural thesaurus AGROVOC gt FAO s Fisheries and Aquaculture Department and the data fao org project the European Commission Publications Office the European Environment Agency the Italian Senate and others This manual refers to version 2 3 released April 2015 and is the result of a joint effort between FAO and the ART Artificial Intelligence Research group of Tor Vergata VocBench has been successfully tested on the following browsers Safari Google Chrome Mozilla Firefox and Internet Explorer http aims fao org tools vocbench 2 http vocbench uniroma2 it http www fao org home en 3 http art uniroma2 it http www mimos my gt http aims fao org standards agrovoc about VocBench has been tested on all the recent versions of the reported browsers and seems to work seamlessly VB v2 1 User Manual Page 11 of 101 2 Registration amp login To access VocBench you first need to register as a user Go to the User login area on the VB entry page Figure 1 and click on Create an account Figure 2 3 Home About VocBench Espanol VERSION 2 0 Build 20131025 Nederlands VocBench Welcome to the VocBench The VocBench manages concepts and terms in AGROVOC FAO s agricultural thesaurus and supports ts evolution to an ontology Username Password You must log in or create an account to use the VocBench This is the production ver
62. n the concept hierarchy 2 Click on the icon in the bar above the concept hierarchy 3 A warning message is visualized Figure 73 4 Follow the instruction when ready click Delete Delete concept ATTENTION You are about to delete a concept with all its associated terms new child concept en all its subconcepts and all its relations to and from other concepts Before deleting this concept please make sure that all its sub concepts if any are deleted or moved under a new parent Also make sure that all its relations are to be deleted The new status of the deleted concept will be draft deprecated Delete Figure 73 Delete concept Warning message Note When you delete a concept its status becomes Proposed Deprecated meaning it only becomes deprecated after it has been approved by a Validator or Publisher see Sec 7 2 User roles In the meantime its terms in all languages do not change status 9 1 4 Edit the information attached to a concept This action may be performed by Term Editors Ontology Editors Validators Publishers and Administrators To edit any of the pieces of information attached to a concept 1 Select the concept in the concept hierarchy 2 Click on the appropriate tab VB v2 1 User Manual Page 73 of 101 In the following the most relevant actions on concepts are singled out and explained in detail e Add a definition to a concept To provide a definition for a
63. ncept attribute Term attribute Figure 42 Advanced search Search preferred terms only by Relation AND Word VERSION 1 3 DEVELOPMENT Voc Bench Exact word y Advanced search Recent changes Concepts Relationships Validation Export Statistics Concept navigation history Content language Search results Concept Relationship Concept African horse sickness virus en Causes en African horse sickness en African swine fever virus en Causes en African swine fever en Aujeszky virus en Pseudorabies virus en Causes en Aujeszky s disease en Pseudorabies en Banana bunchy top virus en Causes en Bunchy top disease en Bluetongue virus en Causes en Bluetongue en Borna disease virus en i Causes en Borna disease en Bovine leukaemia virus en m 1 Causes en Bovine leukosis en Bovine leukosis virus en Bovine oncovirus en en en Carre s disease en Carre s disease virus en Distemper virus en Causes en Distemper en Canine distemper en 44 12 gt Figure 43 Results of Advanced Search Search by Concept AND Relation Note You may search for relationships between terms in the same ways as described for concepts using the Browse button of the Term relationships field VB v2 1 User Manual Page 45 of 101 6 2 3 Search for term codes Terms have codes which are shown in the Notation tab of the Term box If you know the code of a term you may
64. nships Schemes Validation Load data Export X Statistics Concept navigation history Con Search results Concept Last update date K European potato plant en Solanum tuberosum en 29 08 2013 23 08 18 r3 egg plant en eggplant en Solanum melongena en 29 08 2013 23 08 18 rey Lycopersicon esculentum en Lycopersicon lycopersicum en Solanum lycopersicum en tomato plant en 29 08 2013 23 08 18 r3 Solanum en 20 11 2011 21 24 22 un Solanum aethiopicum en 20 11 2011 22 02 29 ry Solanum nigrum en 20 11 2011 22 02 29 r Solanum berthaultii en 20 11 2011 21 50 24 US cocona en Solanum hyporhodium en 30 08 2013 01 03 12 ic Solanum khasianum en 20 11 2011 21 47 05 ry Pepino en Solanum muricatum en 20 11 2011 21 36 43 r Solanum chacoense en 20 11 2011 21 50 24 Figure 35 Search result with search option Exact word e Exact match With this option you will retrieve the concepts labelled by terms in the languages you selected matching the exact term typed in Example A search for Solanum will in this case only return one result i e the concept Solanum gen of which the preferred term is exactly Solanum Figure 36 VB v2 1 User Manual Page 39 of 101 VERSION 2 0 Build 20131025 Voc Bench eec maten Je Solanum nt changes Concepts Relationships Schemes Validation Load data Export Statistics Concept navigation history Content language Search results Concept Last update
65. o use for concept search and visualization and settings that determine in which languages you want to edit concepts The languages you select in the registration form are for editing purposes e Select ontology box Click on the sign select from the drop down list the ontology ies you wish to manage or contribute to and click on Add Figure 6 Select ontology agqrowoc faotopics Cancel AAA Figure 6 Select ontology 3 At the bottom of the form there is space for comments 4 After clicking the Save button a message appears confirming your registration Figure 7 You have been registered please check your email for further details Figure 7 Registration confirmation VB v2 1 User Manual Page 15 of 101 5 You will receive an email confirming that your request was sent to the VB 2 3Administrators i e the people performing the role of Administrator for the concept scheme s you are interested in 6 You may start using VB once the Administrator approves your registration and after you receive a second email with the Subject title Activation of your account on VocBench containing your registration details 2 2 Login Once you have created an account you may access VB by entering your username and password in the User login area on the VB entry page Figure 2 After clicking on Sign in a window pops up Select the editorial role User group you wish to play during the current session and the
66. om a concept scheme with or without its children The format of export is SKOS XL format You may specify your export using the following three fields Export SKOS XL v Format Seleci Y Schemes Select a Browse LI clude children Concept None v cude labels of related concepts CY zip compression Export Figure 16 Export Schemes Click on the dropdown box and select the scheme to export If you want to export only one or a few concepts from that scheme specify that in the Concept field below Concept To select the concept to export click on Browse A window opens containing the top concepts of the scheme Figure 17 you selected in the Schemes field Here you have the possibility to include or exclude for faster export the children of the selected concept by checking the children checkbox Figure 16 VB v2 1 User Manual Page 22 of 101 Format Enabled in all notable RDF serialization formats Export to plain SKOS skos core labels and with plain skos definitions is also enabled Options allow to retain the original reified labels definitions together with the plain ones or to remove them from the export Note In the bottom left corner you may want to check the Use zip compression Figure 16 to save time and space You can decide to include or exclude for faster export the labels of related concepts Concept browser Exact word 2 Reload concept Ls activities en E Ls entities en
67. on Login Select preferences Login Add ontology project VB user interface Concepts module menu I and content area II VB user interface Menu area General settings User name 1 User role 2 Dataset 3 Global data management options Global data management Ontology Load data Export Export module Top concepts of selected scheme Statistics Search option Stats on concepts terms languages Search option Stats on the structure Search option Stats on relations and properties option Stats on Agrovoc specific relations and properties Option on Stats on workflow General settings Administration 4 About VB 5 RSS feed 6 General settings Preferences 7 Help 8 Sign out 9 Menu area B Simple search Menu area C Access to content Module bar Top menu bar Administration Administration Groups Administration Configuration User references in VB Page 4 of 101 11 11 12 13 13 14 14 15 16 18 18 19 19 20 20 21 22 23 23 24 25 25 26 27 28 28 29 31 32 32 33 VB v2 1 User Manual Figure 34 Figure 35 Figure 36 Figure 37 Figure 38 Figure 39 Figure 40 Figure 41 Figure 42 Figure 43 Figure 44 Figure 45 Figure 46 Figure 47 Figure 48 Figure 49 Figure 50 Figure 51 Figure 52 Figure 53 Figure 54 Figure 55 Figure 56 Figure 57 Figure 58 Figure 59 Figure 60 Figure 61 Figure 62 Figure 63 Figure 64 Figure 65 Figure 66 Figure
68. on preferred term Attribute 1 1 Add new attributes agrontolagy hasTermType Pl Common name for plants Figure 89 Information about a term Tab Attribute AGROVOC example e Notation In this tab one may see the term code given to the selected term Figure 90 Information for coconut palm en Non preferred term History 0 Relationship 1 Attribute 1 eee ep Add new notation skos notation Al 9965 Figure 90 Information about a Term Tab Notation AGROVOC example 9 2 4 Edit information about a term 1 Click on the term a window opens with the three tabs shown in Figure 83 2 Click on the tab Relationship or Attributes to add edit or delete information VB v2 1 User Manual Page 84 of 101 10 Properties module The Properties module is available to Publishers and Administrators It shows all properties used to describe concepts and terms Applied to specific concepts and terms they are accessible through the tabs in the concept and term areas of the Concepts module For example the tab Relations in the Concepts module corresponds to Object properties in the Properties module the tab Attributes corresponds to Datatype properties Click on the Properties dropdown box to select the type of properties you are interested in Figure 91 Note Imported properties are not editable Note All examples are taken from the AGROVOC concept scheme Properties Objec
69. p Validator Shows all proposed changes applied to the concept scheme to be validated see Sec 12 Validation module VB v2 1 User Manual Page 30 of 101 e SPARQL Administrator To query update all content through the SPARQL query update language for RDF see Sec 16 SPARQL module e ICV This module is not covered at the moment since it is not working due to a bug 3 1 4 Concept navigation history amp Content language Two more buttons Concept navigation history and Content language are available in the bottom menu bar C of the menu area see Figure 26 and Figure 28 Concept navigation history Content lanquage Figure 28 Menu area C Concept navigation history amp content language e Concept navigation history All roles The navigation history shows the list of concepts navigated during your current session see Sec 6 3 Concept navigation history e Content language All roles To select the languages in which you want to search and visualize concepts Note The languages you select here are only related to searching and visualizing and only for the current session In Preferences you may set the languages in which you would like to edit concepts see Sec 5 2 User languages amp ontologies VB v2 1 User Manual Page 31 of 101 4 Administration Administration is available from the top menu bar Figure 29 After clicking on it you have three options e Users e Groups e Configuration
70. ration Configuration VB v2 1 User Manual 5 Preferences Page 33 of 101 The Preferences button is available from the top menu bar Saved preferences be available for future sessions It is used to manage the preferences associated to your user account Figure 33 In particular e Details of your user account e User language to edit data in e Pending language request e User ontology e Pending ontology request Note After changing the Preferences you will need to sign out and login again to have them applied Las Dister Administrator to agrovoc 2015 02 24 core VERSION 2 3 Build 20150423 cBench anges Concepts Properties Schemes Validation SPARQL ICV Preferences Details Login New password Confirm password Email New email Confirm email Ontology sgrovoc 2015 03 24 core Set your landing page Search Language of the interface English en al Show URI E Show also non preferred terms E Show only terms of selected languages T Hide deprecated terms and concepts E Show inferred and explicit Figure 33 User references in VB Global data management Administration About VocBench FAM English y 5 RSS fe User language English Spanish French Arabic Chinese Russian Portuguese Latin Czech Lao Japanese Thai Pending language request 7 ies MM Exact word v Go A Concept navigation history User ontology agrovoc 2015 03 24 cor
71. removing a concept to from a scheme 9 2 Operations on terms Terms associated to concepts are displayed in the concept term area of the Concept module Figure 60 9 2 1 Add a new term 1 To add a new term click on Add new term Figure 83 VB v2 1 User Manual Page 80 of 101 2 In the window that opens add the term select the language from the drop down list and decide if the new term is a Preferred term or not Figure 84 3 Click Submit or Cancel uj coconut palm en Cocos nucifera en Terms 2 Definition 0 Note 0 Attribute 0 Relationships 12 Add new term Language Term ocos nucifera Preferred NJ English en coconut palm W Cocos nucifera Preferred y Espa ol es g Cocotero W Figure 83 Add Edit Delete term Add new term New term vum TERE me EEEE EEEE OEE EEEE eee ae EEEE z PEELE EEE EEE Eee eee Add and Repeat Cancel Figure 84 Add new term 9 2 2 Edit or delete a term To edit a term 1 Click on the edit icon next to the term Figure 83 VB v2 1 User Manual Page 81 of 101 2 In the window Figure 85 that opens revise the term and click Submit or Cancel Edit term Term Cocos nucifera Language English Preferred term Figure 85 Edit term To delete a term 1 Click on the icon next to the term 2 A window opens showing a warning message Figure 86 3 Click on Delete if you are sure to delete
72. rms is always visible at the bottom of the Concepts and Properties modules Figure 54 Legend Proposed W Validated M Published M Revised Proposed deprecated W Deprecated Figure 54 Legend 7 2 User roles Possible roles in the workflow are 1 Term Editor 2 Ontology Editor 3 Validator 4 Publisher 5 Administrator Note The rights for each role are restricted to the user languages the user selected during the registration process Sec 2 1 Register or in Preferences in the menu bar Sec 5 2 User languages amp ontologies 7 2 1 Term Editors Term Editors are the users of VB with the most restricted editing rights They are usually terminologists by background Term Editors may access the following modules and features e Recent changes module e Concepts module e Schemes module e Export VB v2 1 User Manual Page 53 of 101 In the Concepts module Term Editors may perform the following actions e Add edit and delete terms e Add edit and delete relations between terms and any other piece of information for terms e Delete concepts e Add edit and delete relations between concepts and any other piece of information for concepts All actions performed by a Term Editor get either the status Revised or Proposed depending of the action undertaken and need to be approved by a Validator 7 2 2 Ontology Editors Ontology Editors are more experienced terminologists and thesaurus editors and have al
73. sd length R agrontology hasSingular R xsd maxinclusive Figure 93 Example of Datatype properties for AGROVOC e Annotation properties 11 Steven J Miller Introduction to Ontology Concepts and Terminology VB v2 1 User Manual Page 86 of 101 Annotation properties may be used to annotate any entity e g owl versionInfo rdfs label rdfs comment No range is defined for these properties Properties Annotation properties I e IR rdfs seeAlso IR owl deprecated IR rdfs label owl priorVersion R skos note R owl backwardCompatibleWith IR owl versioninfo IR owl incompatibleWith IR rdfs comment Figure 94 Example of Annotation properties for AGROVOC e Ontology properties Ontology properties relate to ontologies their domain and range must be an owl Ontology Properties Ontology properties m A A owl versionIRI E owl imports A owl bacwardCompatibleWith A owl incompatibleWith E owl priorVersion Figure 95 Example of Ontology properties for AGROVOC e RDF properties These are properties which are neither object nor datatype nor annotation properties but just simple RDF properties You may find support for them in the Other tab Figure 97 VB v2 1 User Manual Page 87 of 101 Properties RDF properties w E Show uR R doterm crestor IR owl sameAs IR rof first iR fosf depiction R http art uniroma2 it ontologies vocbench hasStstus IR owl unionOf iR owl imports R owl
74. sion of VocBench used by AGROVOC terminologists If you would like to test Vocbench Pl nene please visit our sandbox version What s new orgot your username or passwogd eu Create an account e VocBench Web Services Beta version has been released for developers of agricultura informaticn management systems o incorporate the VocBench into their applications via web services VocBench Partners A Food and Agriculture Organization of the Kasetsart Thai National Agris MIM MIMOS Berhad Universita degli Studi di United Nations Gy University Center Kuala Lumpur Roma for a world without hunger Bangkok Bangkok Thailand Malaysia Tor Vergata Thailand VocBench is partially funded by the agINFRA project Acknowledgements for the revision of AGROVOC contentto Acknowledgements for the contribution of ICRISAT ae agINFRA 4 ic Ki SAT international Crops Research institute for theProf Dagobert Soergel acintra EC 7th framework program INFRA 2011 1 2 2 Sconce mirta Semi Arid Tropics UNIVERSITY OF MARYLAND Grant agreement no 283770 Figure 1 VB entry page User login Oo Forgot your username or password 4 Create an account Figure 2 User login VB v2 1 User Manual Page 12 of 101 2 1 Register Once you have clicked on Create an account the system will take you to the User Registration form Figure 3 User registration form User Registration Login name Password Confirm password First name Last
75. stry en Tools en m rey Alcoholic beverages en al Alcoholic fermentation en Ethylic fermentation en R Produces en lO Ethanol en Ethyl alcohol en I O Allium ampeloprasum en Allium porrum en R Produces en e Leeks en Oj Allium ascalonicum en R Produces en le Shallots en ra Allium cepa en R Produces en rey Onions en Spring onions en Oj Allium fistulosum en R Produces en ig Japanese bunching onions en Welsh onions en ry Allium sativum en R Produces en y garlic en lO Allium schoenoprasum en R Produces en G chives en iG Amanita en R Produces en G Amanitin en ig American cranberry en Vaccinium macrocarpon en R Produces en G Cranberries en 44 15b Figure 41 Results of Advanced search Search by relation 6 2 2 Search by both relation AND concept Type in the search box the word you want to search for select in the Relation browser the relation you are interested in as described above and click on the Search button Figure 42 shows a search for preferred terms only by word virus AND by relation Causes The results are displayed in Figure 43 VB v2 1 User Manual Page 44 of 101 Exact word Advanced search options Relationship Search in these languac Include notes 2 Search preferred terms only e English Repository None Code Term codes Classification scheme Select i Status All El i Co
76. substances en sustancias es substance fr Sostanze it madde tr peuosuHn uk y zh m sto cs Standort de site en Sito it AFO ko zemin tr micue uk m en cs Ma de measure en Misura it amp ko l tr mipa uk E objekty cs Gegenstand de objects en objetos es objet fr Oggetti it Objek ms nesne tr r3 e c e amp lej kej r1 e r1 organismy cs Organismus de organisms en Organismos es Organisme fr organisma ms opraHu3mb ru amp 3 e te organizma tr opraHismu uk E yf zh amp e e i procesy cs Verfahren de processes en Procesos es Processus fr 4AA ufa hi folyamat hu Processi it pracovn postupy sk s re tr npouyecu uk Ll skupiny cs Gruppe de groups en grupos es groupe fr gruppi it Grupo pt rpynnbt ru eyocres te grup tr rpynn uk v Legend Proposed Bl Validated MB Published W Revised Proposed deprecated Bl Deprecated Show more o Figure 10 VB user interface Concepts module menu I and content area II 3 1 Menu area strator to agrovoc_2015 03 24_core Global data management Administration AboutVocBench Vy f English y RSSfeed 7 Preferences Help 0 Sign out A VERSION 2 3 Build 20150423 Exact word lv genetically modified organisms Go Advanced search Last
77. t found is organized in tabs Each tab provides access to a different piece of information about the selected concept VB v2 1 User Manual Page 66 of 101 For example Figure 63 shows the tab Terms for the concept genetically modified organisms Wen content language English and Hindi LC genetically modified organisms en atar uate ata hi Show inferred and explicit Show hide tabs Definition 1 Attribute 0 Relationship 1 Alignments 23 Note 1 Image 0 Scheme 1 Hierarchy History 0 Add new term in a i a pogo genetically modified organisms Preferred W English en 2 cuoW W genetically engineered organisms W 2 Organismos modificados gen ticamente Preferred W Espa ol es e Organismos logrados geneticamente W Z omc W ai R aus TTE T f amp Organisme genetiquement modifie Preferred W d LI 2 Francais fr 7 Organisme transform g n tiquement W CIERRES Preferred W aci EEISBESW i iresermecki woaitdiuimposssewe opramusme Preferred W Pycciit ru gimimwoW vai f s PEHHO MHXSEHEDHDE Opr8HMSME Ww Om armarios maedifi ade anati amantz Preferreat Wi Figure 63 Concept term area Information tabs The following tabs are available e Terms Shows all terms associated to the selected concept in the selected languages Note To see all available terms in all languages make sure the option
78. t properties A G R skos has Datatype properties Annotation properties R owlinvet Ontology properties __ RDF properties RI owtdifferemrronr Figure 91 Properties module Select the required type of property e Object properties Object properties relate objects to other objects For object properties one may define domain and range Admissible entities in the range of an object property are resource represented with an URI e g an skos Concept In Figure 92 the object properties used for AGROVOC are listed 10 steven J Miller Introduction to Ontology Concepts and Terminology 2013 In International Conference on Dublin Core and Metadata Applications DC 2013 Lisbon Portugal 2 6 September 2013 Tutorial OWL 2 Web Ontology Language Second Edition W3C Recommendation 11 December 2012 VB v2 1 User Manual Page 85 of 101 Properties Object properties w R skos hasTopConcept skos inScheme sxosxl prefL abel skos semanticRelation E m m m skosxl labelRelation sxosxl altLabel p skos member skos member List skosxl hiddenLabel 2D D m m owl bottomObjectProperty Figure 92 Example of object properties for AGROVOC e Datatype properties Data type properties relate objects to data type values so that the value of the corresponding RDF triple is a literal value e g a string Properties Datatype properties m Pa R xsd minExclusive R xsd mininclusive R xsd maxLength R x
79. te E _ Proposed by guest andrea concept delete _ Proposed arterisk concept editrelationship create Revised by quest _ atifah concept edit relationship edit Revised avoc Uk concept editrelationship delete Proposed deprecated beikzadeh term create Validated bingyan term edit bramangkoun tenm delete caracciolo term relationship add cklee75 tenm relationship edit O O Filter by date erystalwying tenm relationship delete LJ Today cwbong term note create _ This Week Dister term note edit This Month dlukose term note delete edenizaslani term attribute create From DD MM Y Y YY ehesse i term attribute edit vre C DDMMYYYY gt term attribute delete t Clear Date Figure 111 Validation filter 1 Filter by user By default all registered users are unselected To validate changes by specific users simply check the check box in front of their name To select all users check the All box at the bottom of the list to unselect all users click the All box again Note These settings will be saved also for your next sessions 2 Filter by action By default all possible actions are unselected To select actions simply check the appropriate check boxes Note These settings will be saved also for your next sessions 3 Filter by status By default all term statuses are unselected To modify the selection s
80. ted permissions and the associations between users and roles Figure 31 Group management Existing groups Ti Group permissions Search Publisher Import Validator Export Ontology editors Validation Term editors Concepts Non logged in users Statistics Unassigned to any group Users Visitor Groups Preferences Relationships Home Configuration Ontology Schemes Group description Administrators have full access to the system Figure 31 Administration Groups e Configuration EE Group members Administrator Johannsen caracciolo yjaques GJohannsen lavanya Group actions CONCEPT CRE CONCEPT DELE CONCEPT EDIT CONCEPT EDIT CONCEPT EDIT TERM CREATE TERM EDIT TERM DELETE TERM RELATIO TERM RELATIO TERM RELATIO TERM NOTE CR TERM NOTE ED TERM NOTE DE TERM ATTRIBU TERM ATTRIBU This option is used to manage the configuration of the present installation Figure 32 VocBench Configuration VERSION DISPLAYVERSION MODE SANDBOXLINK WEBSERVICESINFO VOCBENCHINFO CONTACTUS COPYRIGHTLINK DB CONNECTIONURL DB USERNAME e0600000909209209 20 2 0 Build 20131025 PRO http 202 73 13 50 55481 vocbench http aims fao org tools vocbench access http aims fao org tools vocbench 2 http aims fao org contact http www fao org corp copyright en jdbc mysal localhost 3306 administrator_version20 requireSSL false amp amp useUnicode true amp amp characterEncoding U root Figure 32 Administ
81. the term or click Cancel Term deletion You are deleting the term French new concept Tr Confirm with the Delete button or use the Cancel button Canoe Figure 86 Delete term 9 2 3 Information about a term When clicking on a term a new window opens presenting three tabs containing the information associated to it e History VB v2 1 User Manual Page 82 of 101 Information shown in this tab Figure 87 is automatically collected by VB For each term you can see the following pieces of information Creation date Last update Status Moreover a table shows the sequence of changes applied to the term Information for coconut palm en Non preferred term TES O Relationship 1 Attribute 1 Notation 1 Creation date 1981 01 26 07 30 00 Last update Status Published Change Figure 87 Information about a Term Tab History e Relationship In this tab Figure 88 you can visualize the term to term relationships for the selected term Information for coconut palm en Non preferred term Relationship 1 Attribute 1 Notation 1 Create new relationship agrontology hasScientificName 2 Cocos nucifera en Figure 88 Information about a term Tab Relationship e Attributes In this tab you may see the attributes assigned to the selected term Figure 89 VB v2 1 User Manual Page 83 of 101 Information for coconut palm en N
82. ts see Sec 5 2 User languages amp ontologies Note To visualize the terms of a concept in all languages the check box Show only terms of selected languages should be unchecked If on the other hand you check this box you will only be able to view the terms in the languages you selected VB v2 1 User Manual Select languages to display Use this area to select languages you wish to see when viewing concepts categories and relationships and to use in searching in your current session By default in every next login the content language will be setto the users languages All the changes in the content language will be valid for the current session only You will always see only in user languages when viewing terms associated with concepts and categories To see in all the language use the preferences area to check Show also non selected languages under Administration attop ofthe page Add new language Order T 46 43 38 13 40 19 49 1 15 32 Language arabic Elara bosanski jezik catal cesky E dansk deutsch E EhANVIKG english espanol persian 1 0 Select all Clear all Figure 53 Content language Note arabic bengali bosnian danish german greek english spanish also Known as farsi finnish Code ar l bn A bs ar ca cs Bl da de el A en j es Flies fa ei fi ZZ a Page 50 of 101 VB v2 1 Us
83. w only terms of selected languages Users may choose how many languages to display in tab Terms either all terms available for a given concepts or only those in the languages for which the user has editing rights By checking this box only terms in the selected languages are shown see 5 2 User languages amp ontologies Hide deprecated terms and concepts By selecting this option the concept hierarchy will show only concepts and terms with the following status Proposed Validated Published Revised For detailed information about statuses in VB see Sec 7 2 User roles Show inferred and explicit By default VB shows only explicit information Checking this option reasoned and inferred relationships are constructed based on OWL reasoning using information already explicitly provided by editors and publishers The inferred information will be shown in light grey and will not be editable to make changes one should change the explicit information from which they are derived 5 2 User languages amp ontologies User Language This box lists the languages in which you are allowed to edit the data you have access to In case you want to remove any language s select the appropriate language s and click on the button If you want to request editing rights to a new language for editing concepts terms click on the icon select from the dropdown list the language and click on Add VB v2 1 User Manual Page 36 o
84. who have the total control over the concept scheme and are responsible for publishing the validated entities Publishers have all the rights of Term Editors Ontology Editors and Validators The following describes publishers roles and privileges Publishers have access to the following modules features VB v2 1 User Manual Page 55 of 101 e Recent changes module e Concepts module e Properties module e Validation module e Export e Statistics In the Concepts module Publishers may perform all actions allowed to Term Editors Ontology Editors and Validators plus the following ones Move link and unlink concepts In the Validation module they may validate changes applied by Editors and confirm changes applied by Validators They ultimately change the status to Published They can still reject validated entries and thus remove them again from the model in case of new proposals or reset them to their previous status in the case of Proposed Deprecated In the Properties module they may edit or create new properties Finally Publishers have access to the link Administration in the menu area from where the Users and Groups menus are available 7 2 5 Administrators Administrators have access to all VB modules and have overall rights VB v2 1 User Manual Page 56 of 101 8 Recent changes module This module gives an overview of all changes applied to a given scheme since its loading in VB By default the
85. y edited by the user amp genetically modified organisms en ferra ufvafer site hi Terms 46 Definition 1 Attribute 0 Relationship 1 Add new alignment http lod nal usda gov nalt 17344 skos exactMatch http www w eionet europa eu gemet concept 14602 http eurovoc europa eu 5768 Figure 69 Alignment tab 9 1 2 Add a new concept This action may be performed by all roles To add a new concept take the following steps 1 Choose where in the hierarchy to add the new concept 2 Click on the icon in the bar above the concept hierarchy Figure 61 a window opens with the title Create a new concept 3 In the window add the following pieces of information Figure 70 a Term for the concept b Select Language from the drop down list c Click on the Create button VB v2 1 User Manual Page 70 of 101 Create a new concept Term Langusge English Francais Italiano Nederlands Figure 70 Create a new concept Add term and language 4 The system checks if the suggested term is already present in VB If the label already exists you receive the message Concept already exists Figure 71 and a short link to the existing concept is provided In that case enter a new term and click on Check availability then follow steps 4 to 7 Note Take Care The fact that you receive a message informing you that the term already exists does not stop you to create the term anyway Create a n

Download Pdf Manuals

Related Search

Related Contents

SC_downloads_files/Single RF User Manual 4.2  July 2004 Bulletin - Kernow Hang Gliding & Paragliding Association  999191_D - Vacuubrand.com  User's Manual  Documentation technique APCI-2200 Carte de relais, isolée  LG LMV1680BB User's Manual  Eglo IMENE  VOIR LOIN ET PLUS PROFOND  HiPer SR Operator`s Manual    

Copyright © All rights reserved. Failed to retrieve file