Évolution d'un catalogue uniform de la version 3.4  vers la version 4.0

Versions des documents de formations : un format cdmfr et un générateur

A partir de la version 4.0, Uniform est livré avec le support de plusieurs versions de format de dossiers de formations.

Avant la version 4.0, Uniform utilisait implicitement la version cmmfr dont la schéma avait été fixé en 2006. Le seul générateur reconnu par uniform était l'éditeur SOF. Par convention, nous avons nommé cette version de dossier : cdmfr-2006-sof

Des adaptations locales ont été réalisées dans les différentes organisations et par convention dans ce document nous la nommons : cdmfr-2006-sof-custom. Bien entendu, vous pouvez définir un nom qui permet d'identifier votre établissement. A l'université Lille 1, le générateur de documents de formation est rimbaus nous avons nommé cette version cdmfr-2006-rimbaus-lille1.

La version 4.0 est livrée avec le support du cdmfr correspondant au schéma validé en 2011. Le seul générateur testé actuellement est ROF et nous l'avons donc nommé cdmfr-2011-rof

Installation de la version 4.0

A'aide d'un client svn, se positionner dans le dossier parent qui va accueillir le nouveau dossier du logiciel esup-uniform puis  lancer la commande:

svn export https://subversion.renater.fr/esup-uniform/trunk esup-uniformv4.0-2011

Copiez le fichier build.cdmfr-2006-sof.properties en build.properties et modifiez le pour adapter le logiciel à votre environnement.

Voici la liste des variables à adapter :

• log.file : chemin absolu du fichier de log d'uniform (reprendre la valeur existante dans le fichier de votre version courante)
• stat.file: chemin absolu du fichier de statistique d'uniform (reprendre la valeur existante dans le fichier de votre version courante)
• tomcat.home: chemin absolu du dossier racine  de tomcat (reprendre la valeur existante dans le fichier de votre version courante)
• deploy.home : chemin absolu du dossier webapps de tomcat (reprendre la valeur existante dans le fichier de votre version courante)
• ws.base : url du serveur uniform (reprendre la valeur existante dans le fichier de votre version courante)
• rne : valeur du code rne de l'établissement (reprendre la valeur existante dans le fichier de votre version courante)
• admin.email: email de l'administrateur d'unform (reprendre la valeur existante dans le fichier de votre version courante)
• cmdfr-release : nom de votre version de docuemnts de formation (cdmfr-2006-sof-custom)
• customoai : nom de l'adaptation locale pour la génération des enregistrements oai (reprendre la valeur existante dans le fichier de votre version courante)

Adapter vos dossiers et fichiers

Adapter le dossier properties

Copiez respectivement vos fichiers actuels dans le dossier properties:

• uniform-config.xml vers uniform-config.cdmfr-2006-sof-custom.sample.xml
• search-engine-config.xml vers search-engine-config.cdmfr-2006-sof-custom.sample.xml
• urlrewrite.xml vers urlrewrite.cdmfr-2006-sof-custom.xml

Déplacez y un fichier :

• ../common/variablesExt.xml vers variablesExt.cdmfr-2006-sof-custom.xml

Reinjectez vos fichiers actuels en écrasant les fichiers de la version 4 :

• log4j.properties
• oaicat.properties

Adapter le dossier webpages/stylesheets

Dans le dossier webpages/stylesheets :
- Copiez tous vos fichiers actuels dans un nouveau dossier appelé "xml2xml/cdmfr-2006-sof-custom"
- Dans ce dossier "xml2xml/cdmfr-2006-sof-custom" copiez aussi le dossier commun/ avec son fichiers "variables_PDF.xml"
- Copiez le dossier ainsi que ses sous-dossiers et tous les fichiers de votre "profil" (lycen ou unrnpdc par exemple) actif actuel (ce profil est activé dans uniform-config.xml (/uniform/view/profil-name)
- Si vous avez fait évoluer le contenu des fichiers inclus dans rome, écrasez les fichiers du dossier  rome de la livraison 4.0

Dans le dossier import :
- créer un dossier cdmfr-2006-sof-custom et y déplacer éventuellmentvos les fichiers que vous souhaitez importer manuellment par la commande ant import_dir

dans le dossier initdb :
- copier votre fichier actuel définissant vos constantes et nommer le constantes.cdmfr-2006-sof-custom.xml
- copier votre fichier actuel définissant votre "orgunit" et nommer le orgunit-universite.cdmfr-2006-sof-custom.xml

Editer le fichier properties/uniform-config.cdmfr-2006-sof-custom.sample.xml
- pour y remplacer les occurences de :
     - xml2xml/ par xml2xml/cdmfr-2006-sof-custom/
     - search-engine-config.xml par search-engine-config.cdmfr-2006-sof-custom.xml
 
- ajouter un élément /uniform/site/site-mobile avec la valeur de l'url du site mobile (élément vide si pas de site mobile)
- modifier le nom de la base de données modifier la valeur de /uniform/data-base/init-base/orgUnit-name de orgUnit-universite en orgUnit-universite.cdmfr-2006-sof
- modifier la valeur de /uniform/data-base/import-path de import à import/cdmfr-2006-sof-custom
- ajouter l'attribut /uniform/xsl/sof-to-cdm/@nameSpace="http://cdm-fr.fr/2006/CDM-frSchema"
- modifier la valeur de /uniform/lucene-config/file-name de search-engine-config.xml en search-engine-config.cdmfr-2006-sof-custom.xml
- ajouter l'élément /uniform/view/useLangToBuildFileName avec la valeur true