Table of Contents | ||||||||
---|---|---|---|---|---|---|---|---|
|
1ère étape : préparer la configuration
Depuis le module ORI-OAI-quick-install, lancez la commande suivante :
Code Block |
---|
ant init-config-vocabulary
|
Ceci va créer l'arborescence des dossiers et fichiers servant à personnaliser le module dans le dossier [PATH_CUSTOM_CONFIG]/ori-oai-vocabulary.
Note | |||||
---|---|---|---|---|---|
| Avant de procéder à la configuration avancée, il est conseillé de consulter le document "Navigation dans les fichiers" pour mieux comprendre la structure des différents fichiers.
| ||||
C'est au sein de ce dossier, et uniquement dans ce dossier que vous devrez personnaliser le module. Le dossier a été créé avec les propriétés et les fichiers de configuration couramment modifiés par les exploitants. Si d'autres fichiers devaient être modifiés pour une configuration encore plus poussée, il suffit de copier le fichier de configuration d'origine depuis les sources du module vers le dossier config en respectant la même arborescence. Lors du déploiement, le fichier du dossier [PATH_CUSTOM_CONFIG] écrasera celui fourni par défaut dans les sources. |
Structure du dossier [PATH_CUSTOM_CONFIG]/ori-oai-vocabulary
Depuis la version 2.0 de ORI-OAI, toutes les configurations et la personnalisation se font depuis le dossier [PATH_CUSTOM_CONFIG] (avec 1 sous-dossier par module).
Voyons la structure du module qui nous concerne ici :
Panel |
---|
|
Configurations avancées
Afin de personnaliser la configuration des vocabulaires, vous devrez également modifier les fichiers présents dans le répertoire conf[PATH_CUSTOM_CONFIG]/ori-oai-vocabulary/config/properties/domain/ , par exemple le fichier conf[PATH_CUSTOM_CONFIG]/ori-oai-vocabulary/config/properties/domaindynamic-vocabularies/custom-ldapVocabulary.xml pour configurer le vocabulaire des VCards issues du Ldap.
Publication de vocabulaires statiques
Reportez-vous à la documentation suivante : Publication de vocabulaires statiques
Publication de vocabulaires dynamiques
Reportez-vous à la documentation suivante : Publication de vocabulaires dynamiques
Cas de l'utilisation du LDAP
Info |
---|
Concernant la réalisation du vocabulaire des VCards via le LDAP, notez qu'à ce jour le service permettant de récupérer ces vocabulaires réalise un certain nombre de requêtes consécutives sur votre LDAP. Ce nombre correspond au nombre de personnes que vous rapatriez. Suivant la configuration de votre LDAP et le nombre de personnes rapatriées, votre serveur LDAP peut donc subir une forte charge lors de la création de votre vocabulaire. Vous devez également filtrer les résultats via un filtre ldap, ce paramètre correspond à la propriété ldapFilter du bean spring peopleLdapLocalProvider qui est déclarée dans conf[PATH_CUSTOM_CONFIG]/ori-oai-vocabulary/config/properties/domaindynamic-vocabularies/custom-ldapVocabulary.xml. Ces vocabulaires vont être utilisés dans l'éditeur de métadonnées pour la saisie des vcards via un système d'autocomplétion. Si le vocabulaire est trop gros, il se peut que cela pose des problèmes à l'éditeur (il faudra notamment lui allouer énormément de RAM), l'autocomplétion risque de ne pas être très fonctionnelle. Rapatrier les 40.000 étudiants et personnels de votre établissement n'est donc pas recommandé d'où la présence de ce filtre. |
Pour réaliser une configuration avancée, les fichiers de configuration "métier" de ce module sont les fichiers placés dans le répertoire conf/properties/domain/. Ces fichiers sont des fichiers de configuration Spring et correspondent à la paramétrisation des différents Services décrits dans les spécifications donc notamment et surtout les fournisseurs de vocabulaires ("provider"). Les configurations vont vous permettre d'ajouter de nouveaux vocabulaires, de modifier pour certains leur construction, d'en générer de nouveaux en catégorisant ou fusionnant ceux existants, etc. Ces fichiers de configuration sont très verbeux mais les configurations en elles-mêmes restent relativement simples et compréhensibles (et reposent entièrement sur Spring).
Pour ajouter de nouveaux vocabulaires, vous pouvez : * déclarer un nouvel import (tag import) d'un fichier xml dans domain.xml
Code Block |
---|
<import resource="monVocabulaire.xml" />
|
- créer ce fichier monVocabulaire.xml en copiant/collant le fichier oriVocabulary.xml par exemple : vous supprimez tous les beans et en recréez d'autres en prenant exemple sur les différents bean de type "Provider" : XmlStaticVocabularyProvider, SqlProvider, LdapVocabularyProvider, etc (cf la partie spécifications).
...
. |