{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Valid from Datafari v4.0","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"paragraph","content":[{"text":"Datafari gives you the opportunity to link an ontology to it, in order to enrich your documents with the ontology data and then use these additional infos in the search phase.","type":"text"}]},{"type":"paragraph","content":[{"text":"To do so, the first step is to add the ","type":"text"},{"text":"OntologyUpdateProcessor ","type":"text","marks":[{"type":"code"}]},{"text":"as a custom UpdateProcessor in the file ","type":"text"},{"text":"{Datafari_Home}/solr/solr_home/FileShare/conf/customs_solrconfig/custom_update_processors.xml","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The OntologyUpdateProcessor will index, for each document inserted in Solr, the labels of the corresponding node into the specified ontology but also its parents and children labels and URIs.","type":"text"},{"type":"hardBreak"},{"text":"It has several parameters that can be set:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"enabled","type":"text","marks":[{"type":"strong"}]},{"text":" : boolean value to enable/disable the ","type":"text"},{"text":"OntologyUpdateProcessor","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"annotationField","type":"text","marks":[{"type":"strong"}]},{"text":" : ","type":"text"},{"text":"[REQUIRED] ","type":"text","marks":[{"type":"em"}]},{"text":"the field in the input document that contains the annotation URI used as the reference in the ontology.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Note that this field must be added to the document by yourself: Datafari does not provide any plugin or other mechanism to do it. You may want to modify the DatafariUpdateProcessor or make your own UpdateProcessor to do so.","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ontologyURI","type":"text","marks":[{"type":"strong"}]},{"text":" : ","type":"text"},{"text":"[REQUIRED] ","type":"text","marks":[{"type":"em"}]},{"text":"the location of the ontology, such as ","type":"text"},{"text":"http://francelabs.com/ontology/owl.rdf","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"file:///ontology/owl.rdf","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"Datafari only supports OWL ontology format for now, so the ontologyURI parameter has to reference a OWL formated ontology","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"labelField ","type":"text","marks":[{"type":"strong"}]},{"text":": the field in your schema that should be used for the annotation's label(s). Default: ","type":"text"},{"text":"ontology_labels","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"childField ","type":"text","marks":[{"type":"strong"}]},{"text":": the field to be used for child document references. These are direct (ie. single-step) relationships ","type":"text"},{"text":"down","type":"text","marks":[{"type":"em"}]},{"text":" the hierarchy. Default: ","type":"text"},{"text":"ontology_children","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"parentField ","type":"text","marks":[{"type":"strong"}]},{"text":": the field to be used for parent document references. These are direct relationships ","type":"text"},{"text":"up","type":"text","marks":[{"type":"em"}]},{"text":" the hierarchy. Default: ","type":"text"},{"text":"ontology_parents","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"childLabel ","type":"text","marks":[{"type":"strong"}]},{"text":": the field to be used for child documents labels. Default: ","type":"text"},{"text":"ontology_children_labels","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"parentLabel ","type":"text","marks":[{"type":"strong"}]},{"text":": the field to be used for parent documents labels. Default: ","type":"text"},{"text":"ontology_parents_labels","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"useLanguages ","type":"text","marks":[{"type":"strong"}]},{"text":": (boolean) should language distinction for label fields be used ? If this is set to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"em"}]},{"text":", the processor will create additional label fields for each language found, using the language as a suffix, for instance ","type":"text"},{"text":"ontology_parents_labels","type":"text","marks":[{"type":"em"}]},{"text":"_fr, ","type":"text"},{"text":"ontology_parents_labels_en","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"The field format is [Original_Label_Field]_[Language]","type":"text"},{"type":"hardBreak"},{"text":"This is useful if you want to have, in addition to the original label fields which will contain all values, specific label fields containing values of the concerned language. But remember that the more the Ontology contains languages, the more it will create label fields.","type":"text"},{"type":"hardBreak"},{"text":"Default: ","type":"text"},{"text":"false","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"includeIndirect","type":"text","marks":[{"type":"strong"}]},{"text":" : (boolean) should indirect parent/child relationships also be indexed ? If this is set to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"all","type":"text","marks":[{"type":"em"}]},{"text":" ancestor and descendant labels and URIs will also be added to the document. Default: ","type":"text"},{"text":"false","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"descendantsField ","type":"text","marks":[{"type":"strong"}]},{"text":": the field to be used for the full set of descendant references. These are direct AND indirect relationships ","type":"text"},{"text":"down","type":"text","marks":[{"type":"em"}]},{"text":" the hierarchy. Default: ","type":"text"},{"text":"ontology_descendants","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ancestorsField ","type":"text","marks":[{"type":"strong"}]},{"text":": the field to be used for the full set of ancestor references. These are direct AND indirect relationships ","type":"text"},{"text":"up","type":"text","marks":[{"type":"em"}]},{"text":" the hierarchy. Default: ","type":"text"},{"text":"ontology_ancestors","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"descendantsLabel ","type":"text","marks":[{"type":"strong"}]},{"text":": the field to be used for descendant documents labels. Default: ","type":"text"},{"text":"ontology_descendants_labels","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ancestorsLabel ","type":"text","marks":[{"type":"strong"}]},{"text":": the field to be used for ancestor documents labels. Default: ","type":"text"},{"text":"ontology_ancestors_labels","type":"text","marks":[{"type":"em"}]}]}]}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"If you decide not to use the default values for the fields, DO NOT FORGET to add them in the appropriate custom schema file(s) which are located in ","type":"text"},{"text":"{Datafari_Home}/solr/solr_home/FileShare/conf/customs_schema","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Otherwise none of the ontology features will work !","type":"text"}]}]},{"type":"paragraph","content":[{"text":"To implement the OntologyUpdateProcessor, follow these steps:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"open the '","type":"text"},{"text":"custom_libs.xml","type":"text","marks":[{"type":"em"}]},{"text":"' file in ","type":"text"},{"text":"{Datafari_installation_folder}/solr/solr_home/FileShare/conf/customs_solrconfig/","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"add the following line (replace the '') :","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Datafari uses Apache Jena to load an ontology","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"open the '","type":"text"},{"text":"custom_update_processors.xml","type":"text","marks":[{"type":"em"}]},{"text":"' file in the same location","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"add the following lines(still replace the ''):","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\ttrue\n\tontology_annotation\n\n\t\n\tfile:///owl.rdf\n","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Of course you have to replace the values by yours and also add the optional parameters described up above with what you want","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Restart Datafari","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Crawl (again) your documents to add to them the new fields generated by the ","type":"text"},{"text":"OntologyUpdateProcessor","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"Then, you can configure Datafari to use the new Ontology infos on the search requests :","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"open the '","type":"text"},{"text":"datafari.properties","type":"text","marks":[{"type":"code"}]},{"text":"' file in ","type":"text"},{"text":"{Datafari_installation_folder}/tomcat/conf/","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Modify those lines to set the ontologyEnabled property to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"em"}]},{"text":" and the other lines to match with your ontology configuration:","type":"text"}]},{"type":"codeBlock","content":[{"text":"ontologyEnabled=true\nontologyLanguageSelection=true\nontologyNodeLabels=ontology_labels\nontologyChildrenLabels=ontology_children_labels\nontologyParentsLabels=ontology_parents_labels","type":"text"}]},{"type":"paragraph","content":[{"text":"ontologyEnabled : ","type":"text","marks":[{"type":"strong"}]},{"text":"(boolean) Enable or disable the ontology use","type":"text"},{"type":"hardBreak"},{"text":"ontologyLanguageSelection","type":"text","marks":[{"type":"strong"}]},{"text":" : (boolean) should use the Datafari selected language for the ontology labels ? If ","type":"text"},{"text":"true","type":"text","marks":[{"type":"em"}]},{"text":", be sure that you used the ","type":"text"},{"text":"OntologyUpdateProcessor","type":"text","marks":[{"type":"strong"}]},{"text":" with the parameter ","type":"text"},{"text":"userLanguages","type":"text","marks":[{"type":"strong"}]},{"text":" set to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"em"}]},{"text":" during the crawl of the documents by MCF","type":"text"},{"type":"hardBreak"},{"text":"ontologyNodeLabels","type":"text","marks":[{"type":"strong"}]},{"text":" : the field in your schema that contains the annotation's label(s)","type":"text"},{"type":"hardBreak"},{"text":"ontologyChildrenLabels","type":"text","marks":[{"type":"strong"}]},{"text":" : the field in your schema that contains the child documents labels","type":"text"},{"type":"hardBreak"},{"text":"ontologyParentsLabels","type":"text","marks":[{"type":"strong"}]},{"text":" : the field in your schema that contains the parent documents labels","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Your Datafari is now ready to use the ontology additional fields during search queries thanks to the ","type":"text"},{"text":"OntologySuggestion.widget","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DATAFARI/pages/5832716"}}]}]}],"version":1}

Browser not supported