Publications de l'équipe projet en charge du développement de Toutatice.

EXEMPLE D'UTILISATION LDAPOMATIC

Dans le cadre de l'utilisation d'LdapOmatic pour une intégration de données Annuaire LDAP, nous avons établi un jeu de test basé sur des exports de l'Annuaire Fédérateur élèves et personnels.

Le but est de transformer les fichiers exports en fichiers 'lisibles' par LdapOmatic pour que ce dernier intègre les informations dans un annuaire.

CONTENU DE L'ARCHIVE

L'extraction ldapomatic-aclimoges.tar.gz contient les éléments suivants :

> Schéma :

- 98toutatice.ldiff : schéma spécifique annuaire ENT regroupant les classes d'objets et les attributs.

> loc.jar : dernière version d'LdapOmatic

> saxon9.jar : processeur XSLT permettant de faire les transformations.

> Drivers :

Liste des drivers permettant de se connecter aux bases des différents systèmes d'information.

> exports-aaf: liste des fichiers exports Annuaire Fédérateur au format xml.

- Eleves : ENTTSSERVICES_Complet_<date>_Eleve_000*.xml

- Personnels : ENTTSSERVICES_Complet_<date>_EtabEducNat_000*.xml

- Établissements / Structures : ENTTSSERVICES_Complet_<date>_PersEducNat_000*.xml

- un fichier modèle de données : ficAlimMENESR.dtd

> xslt :

Deux fichiers XSLT transformant les exports en fichiers XML pivots.

- AAF-eleves.xsl

- AAF-personnels.xsl

> pivots :

Deux fichiers XML formatés et 'lisible' par LdapOmatic

- pivot_AAF-eleves.xml

- pivot_AAF-personnels.xml

> jobs :

Deux fichiers :

- jobs-aaf.xml : contenant les deux tâches d'import dans l'annuaire.

- variables.xml : fichier définissant les variables utilisées dans les divers fichiers.

> script etl.sh :

- Extract Transform Load - LdapOmatic

> 4 scripts à exécuter dans l'ordre 1-2.

- 1-aaf-eleves.sh : script qui converti l'export aaf des élèves en pivot.

- 2-maj-comptes-eleves.sh : script qui utilise le pivot généré pour l'intégration dans l'annuaire via la tâche définie dans le jobs-aaf.xml (eleves-aaf).

- 1-aaf-personnels.sh : script qui converti l'export aaf des personnels en pivot.

- 2-maj-comptes-personnels.sh : script qui utilise le pivot généré pour l'intégration dans l'annuaire via la tâche définie dans le jobs-aaf.xml (personnels-aaf).

UTILISATION

> Ajout des classes d'objets et des attributs lors de la configuration de l'annuaire LDAP.

Via console d'administration ou via lignes de commande.

Schéma définit dans le fichier ./ldapomatic-aclimoges/schema/98toutatice.ldif

> installation d'LdapOmatic

À exécuter dans un terminal avec la commande :

java -jar loc.jar

> Drivers

Les drivers présents dans le dossier ./ldapomatic-aclimoges/drivers sont à copier (après extraction) dans le dossier ./ldapomatic-aclimoges/lib

> Modification du fichier ./jobs/variables.xml

<?xml version="1.0" encoding="ISO-8859-1"?>
<ldapOmatic>
        <variables>
            <variable name="LDAP_DRIVER">com.sun.jndi.ldap.LdapCtxFactory</variable>
       <variable name="LDAP_ENT_URI">ldap://localhost:389</variable>
         <variable name="LDAP_ENT_BASEDN">à ajouter</variable>
             <variable name="LDAP_ENT_LOGIN">cn=Directory Manager</variable>
             <variable name="LDAP_ENT_PWD">à ajouter</variable>
             <variable name="LDAP_ENT_ouProfilsDn">ou=profils,ou=groupes,%LDAP_ENT_BASEDN%</variable>
             <variable name="LDAP_ENT_ouPersonnesDn">ou=personnes,%LDAP_ENT_BASEDN%</variable>
             <variable name="MARQUEUR">20120902</variable>
      </variables>
</ldapOmatic>

NB: Sont à ajouter : Le Base DN, le mot de passe de l'administrateur LDAP.

> Les scripts

etl.sh

DIR=`pwd`
LOC_HOME=$DIR/
LOC_LIB=$DIR/lib
JAVA_HOME=/usr/java/jdk1.5.0_09/bin

echo " SERVEUR EPDIR1 "
echo "--- SCRIPT D'EXECUTION D'UN JOB ---"
echo "Test des variables"

########## TEST DES VARIABLES ##########

if [ $1 = "" ] | [ $2 = "" ];
then
   echo "Les parametres attendus sont <Nom de la tache> <Job utilise>";
else
   echo "Test Ok"
   echo "Nom de la tache : $1"
   echo "Nom du Job : $2"
   echo "Procedure de lancement de la tâche demandee"
#   $JAVA_HOME/java -Xms128m -Xmx1024m -classpath $LOC_LIB/db2jcc.jar:$LOC_LIB/ifxjdbc-2.2.1.jar:$LOC_LIB/jdom-1.0.jar:$LOC_LIB/log4j-1.2.8.jar:$LOC_HOME fr.toutatice.ldapomatic.LdapOMatic --execute-list=$1 --jobs-repository=$2
java -Xms128m -Xmx1024m -jar $DIR/loc.jar -el=$1 -j=$2

fi

- Définir le chemin des binaires java.

Exécutions pour l'intégration des élèves :

./1-aaf-eleves.sh <chemin de l'export eleves> <chemin de l'export établissement>

./2-maj-comptes-eleves.sh

Exécutions pour l'intégration des personnels :

./1-aaf-personnels.sh <chemin de l'export personnels> <chemin de l'export établissement>

./2-maj-comptes-personnels.sh