Publication de vocabulaires dynamiques
La modification des différents vocabulaires dynamiques se fait dans les fichiers présents dans le dossier [PATH_CUSTOM_CONFIG]/ori-oai-vocabulary/config/properties/dynamic-vocabularies :
- custom-alphabetVocabulary.xml : permet de définir de nouveaux vocabulaires alphabétiques ou de surcharger ceux fournis par défaut
- custom-indexingVocabulary.xml : permet de définir de nouveaux vocabulaires à partir de données provenant du module indexing ou de surcharger ceux fournis par défaut
- custom-ldapVocabulary.xml : permet de définir de nouveaux vocabulaires à partir d'un annuaire LDAP ou de surcharger ceux fournis par défaut
- custom-mergingVocabulary.xml : permet de définir de nouveaux vocabulaires de fusion ou de surcharger ceux fournis par défaut
- custom-sqlVocabulary.xml : permet de définir de nouveaux vocabulaires à partir d'une base de données SQL ou de surcharger ceux fournis par défaut
Ces fichiers servent à surcharger les fichiers d'origine présents dans le dossier [ORI_HOME]/src/ori-oai-vocabulary-svn/src/main/resources/properties/dynamic-vocabularies :
- alphabetVocabulary.xml
- indexingVocabulary.xml
- ldapVocabulary.xml
- mergingVocabulary.xml
- sqlVocabulary.xml
Pour surcharger un vocabulaire fourni par défaut, ou ajouter un vocabulaire, il faut donc ouvrir le fichier d'origine (par exemple : ldapVocabulary.xml), copier-coller le vocabulaire concerné vers le fichier de surcharge (dans notre exemple : custom-ldapVocabulary.xml).
Pour prendre en compte les nouveaux vocabulaires ou les modifications sur les vocabulaires existants, il faut redéployer le module de vocabulaires :
ant all-vocabulary
et relancer le Tomcat correspondant au module de vocabulaires
Le plus simple pour tester la récupération d'un vocabulaire (et donc vérifier qu'il a bien été configuré, bien pris en compte par le module) est de consulter depuis votre navigateur ce type d'URL : http://\[HOST_INSTALL\]:8183/ori-oai-vocabulary/exist/rest/db/ori-oai-vocabularies/people_vcard/people_vcard.xml
Cela devrait vous renvoyer le XML correspondant.
Vous pouvez également désactiver un ou plusieurs vocabulaires dynamiques depuis les fichiers custom-xxxVocabulary.xml. Pour cela, il suffit de déclarer un "bean" ayant pour identifiant le vocabulaire à désactiver (exemple : indexed_dcfr_years) :
<bean id="indexed_dcfr_years" class="org.orioai.vocabulary.domain.providers.InactiveVocabularyProvider"/>
Note : Le module de vocabulaires utilise un système de cache évolué.
Lorsque vous modifiez un vocabulaire, il se peut que cette modification ne soit pas prise en compte immédiatement dans l'IHM du module.
Le plus simple est de cliquer sur le lien "FORCER LA MISE A JOUR DE TOUT LE CACHE" dans l'IHM du module.