JDONREFv4 Plugin

L'intérêt du plugin JDONREFv4 pour ElasticSearch est multiple. Il fournit :

• les mappings utilisés par JDONREF ;
• un fichier de synonymes adapté à la norme Française ;
• une requête qui permet un calcul de note adapté à l'homme comme à la machine ;

Releases

JDONREFv3ES plugin	elasticsearch	release date	detail
0.1beta	1.0.0.RC1	2014-04-30	POC
0.2beta	1.1.X	2014-08-25 (see 0.2)	adress based score with integration tests
0.2	1.3.X	2014-10-30 (still improving performances)	production version : adress based score with production test.
0.3	1.3.X	2015-03-31	score tuning

Includes

name	type	disponibilité
jdonrefv4	query/scorer	0.2beta (weights and term can't be changed). Read PayloadCheckerSpanQuery.
PayloadCheckerSpanQuery	query/scorer	0.2beta (grammar filter based on payloads used by jdonrefv4).
POI et Zones	mapping	0.2beta
adresse	mapping	0.2beta
troncon	mapping	0.2beta
voie	mapping	0.2beta
commune	mapping	0.2beta
departement	mapping	0.2beta
pays	mapping	0.2beta
jdonrefv3es_synonym.fr.txt	French Synonyms'file	0.1beta
jdonrefv4-settings.json	settings	0.2beta jdonrefv4_index, jdonrefv4_search, jdonrefv4_codes_index
JDONREFv4TermSimilarity	similarity	0.2beta
EdgeNGramWithPayloadsFilter	token filter	0.2beta (edgengram with payloads support)
TokenCountPayloadFilter	token filter	0.2beta (insert in payload the count of token with given payload - for use by PayloadVersusTypeSpanQuery).
GroupedPayloadSpanQuery	query	0.2beta (already deprecated see payloadcheckerspanQuery, remove results where payloads are not grouped together).
PayloadVersusTypeSpanQuery	query	0.2beta (already deprecated see payloadcheckerspanQuery, remove results where all payloads term matches for given types).
jdonrefv3es_adresse	type
jdonrefv3es_adresse	tokenFilter
combosynonym	TokenFilter
test_0.html test_1.html	site	0.1beta (simple test)
JDONREFv3Test.html	site	0.2beta (site for jdonrefv3es and index jdonref)

See also todo list.

Plugin installation

Simply run at the root of you ElasticSearch v1.3+ installation :

bin/plugin --install elasticsearch-jdonrefv3es-0.2beta --url http://sourceforge.net/p/jdonref/code/HEAD/tree/Dev/JDONREF_ES_PLUGIN_POC/dist/elasticsearch-jdonrefv3es-0.2beta.zip?format=raw

This will download the last beta version plugin from sourceforge.

Don't forget restart elasticsearch.

There is an embedded site in order to test the query like this :

http://url_elasticsearch:port/_plugin/jdonrefv4-0.2beta/JDONREFv3Test.html

Prérequis avant d'utiliser le plugin

Le site fonctionne uniquement avec un index de nom "jdonref" qui respecte le mapping proposé par le plugin. Par contre, la requête peut être utilisée sur n'importe quel index qui respecte le mapping.

Avant de créer cet index, le fichier jdonrefv3es_synonym.fr.txt doit être déployé dans /etc/elasticsearch ou dans la chaîne du path.

Utilisation du plugin

Voir notamment le guide de première utilisation.

Mise à jour du plugin

Il s'agit de le désinstaller, puis de le réinstaller.