AIP v 1.0 - Manuel Technique _V1.4_
Contents
1. est pas obligatoire que le serveur LDAP soit lui m me install sur le m me serveur partir du moment o le LDAP est accessible via une url de la forme ldap serveur port A titre d illustration nous avons r alis les d veloppements sur un serveur OpenLDAP 2 0 27 3 1 2 Le montage r seau d acc s aux photos agent Au CG33 l AIP s appuie sur le r f rentiel des photos fichiers jpg g r par le logiciel EDIGRAPH Il conviendra donc de r aliser un montage r seau CIFS du r pertoire photo dans la distribution AIP voir plus loin dans ce document vers le r pertoire srvphoto DRH EDIGRAPH CG33 Images en mode lecture seule 3 1 3 Param trage Tomcat sp cifique au CG33 3 1 3 1 Fichier CATALINA_HOME conf web xml Uniquement pour le CG33 qui utilise une interface avec l application Abyla de la Direction de Patrimoine il est n cessaire d ajouter les l ments suivants en fin du web xml avant le dernier tag lt web app gt lt Datasource ABYLA gt lt resource ref gt lt description gt ABYLA Oracle Datasource lt description gt lt res ref name gt jdbc abyla lt res ref name gt lt res type gt javax sql DataSource lt res type gt lt res auth gt Container lt res auth gt lt resource ref gt 3 1 3 2 Fichier CATALINA_HOME conf context xml Uniquement pour le CG33 qui utilise une interface avec l application Abyla de la Direction de Patrimoine il est n cessaire d ajouter les l men2. par un nom balise lt nom gt avec une valeur associ e balise lt valeur gt De mani re synth tique le fichier params xml est format comme suit lt xml version 1 0 gt lt Parametres gt lt Param gt lt nom gt param tre N 1 lt nom gt lt valeur gt valeur du param tre N 1 lt valeur gt lt Param gt lt Param gt lt nom gt param tre N n lt nom gt lt valeur gt valeur du param tre N n lt valeur gt lt Param gt lt Parametres gt Lors de l enregistrement du fichier params xml modifi il faut imp rativement red marrer tomcat pour que les changements soient pris en compte En effet ce fichier est charg par les servlets uniquement au moment du d marrage et une fois pour toute R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 12 30 AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 4 1 2 Le param trage global du logiciel Param tre Exemple de valeur Commentaire Param trage des tailles des pools de connexion l annuaire LDAP xxxxxConnectionPoolSizexxxx Il y a 8 servlets dans AIP v 1 0 et donc 8 param trages de pool soit 1 pour chaque cran IdapConnectionPoolSizeFormulaireRechercher IdapConnectionPoolSizeListeResultats IdapConnectionPoolSizeListeResultatsXLS IdapConnectionPoolSizeOrganigramme IdapConnectionPoolSizeExplorateur ldapConnectionPoolSizeFicheAg
3. 2212 2009 17 21 16 22 12 2009 17 21 16 22 12 2009 17 21 16 22 12 2009 17 21 16 22 12 2009 17 21 16 22712 2009 17 21 16 2212 2009 17 21 16 2212 2009 17 21 16 22 12 2009 17 21 16 22 12 2009 17 21 16 22 12 2009 17 21 16 2212 2009 17 21 16 2212 2009 17 21 16 2212 2009 17 21 16 22 12 2009 17 21 16 22 12 2009 17 21 16 22 12 2009 17 21 16 2212 2009 17 21 16 2212 2009 17 21 16 2212 2009 17 21 16 22 12 2009 17 21 16 22 12 2009 17 21 16 R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 25 30 EC AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 6 Comment modifier des composants c ur 6 1 Introduction S il est possible de modifier les fichiers params xml AlP css AIlP js web xml aip_ xxx properties et log j properties de mani re simple sans passer par un environnement de d veloppement il en va autrement des 13 servlets principales et des fichiers sources contenus dans le r pertoire AIP HOME src puisque ce sont des composants java et qu ils n cessitent une recompilation Ce chapitre d crit le mode op ratoire de modification de ces composants 6 2 Etape 0 Pr requis Pour pouvoir modifier les composants c ur java vous devez disposer de l environnement de d veloppement Eclipse install sur votre poste de d veloppement avec un JDK 1 6 dans la version actuelle de l AIP Pour tester vos modifications vous devez disposer e D un serve
4. n ration des class par s lection du menu Project gt build all 6 5 Etape 3 Cr ation du fichier AlP jar Une fois toutes vos modifications effectu es sur les objets g n riques 1 Fermer Eclipse 2 Cr ez un r pertoire AIP sous un r pertoire de travail exemple AIP_HOMEY temp 3 D placez couper coller tous les fichiers compil s class list s au paragraphe Librairie AlP jar cf plus haut dans ce document de AIP_HOME WEB INF classes AIP vers AIP_HOMEY temp AIP 4 Cr ez un fichier AIP jar en s lectionnant le r pertoire AIP_HOME temp AIP 5 Remplacez l ancienne version de AlP jar sous AIP_ HOMEY WEB INF lib par le nouveau fichier que vous venez de cr er 6 Supprimer AIP _ HOME temp AIP et tout ce qu il contient Pensez galement faire suivre les fichiers source sous AIP_ HOMEY src AlP java 6 6 Etape 4 G n ration du fichier AIP war Une fois vos composants modifi s et valid s si vous souhaitez les d ployer ailleurs VA et ou production enchainez les op rations suivantes 1 S lectionnez tous les fichiers sous AIP_HOME ET PAS LE SEUL REPERTOIRE AIP HOME lui m me 2 Avec votre outil de compression cr ez le fichier AIP war ATTENTION si vous avez test avec le Tomcat local votre poste de travail pensez 1 Purger le r pertoire AIP_HOME logs MAIS laissez le fichier ASupprimer txt 2 Purger le r pertoire AIP_HOME temp MAIS laissez le fi
5. contenant tous les libell s de tous les Ea a erties crans 1 fichier par langue Param tr dans la balise p en prop ficLang dans le fichier global de param trage params xml Conservation Utilis uniquement pour l installation initiale e Du sch ma modifi d annuaire Open LDAP de l AIP e Du fichier de param trage OpenLDAP Fichier de log principal du logiciel Fichiers de log historis s 1 par jour Fichier standard d une application sommairement l application Fichier standard d une application web avec d claration des servlets applicatives via les tags standards lt servlet gt et lt servlet mapping gt Fichier de param trage des m canismes de tra age de l application bas s sur le standard log4j R pertoire vide mais qui recueille lors du d veloppement les classes du package AIP issues de la compilation des sources dans le r pertoire AIP HOME src et partir desquelles on cr le fichier AIP_HOMEY lib AIP jar AnalyseDonnees jsp inetorgperson schema slapd conf AlPLog log AlPLog log yyyy mm dd MANIFEST MF Web d crivant web xml log4j properties AlP jar Librairie du logiciel code java classes compil es activation jar Librairie standard utilis e pour le d v Des Web Services AIP WEB INF lib axis jar Librairie standard utilis e pour le d v Des Web Services AIP log4j 1 2 14 jar Librairie standard de trace log4j mail jar Librairie standard d envoi de mail Le r pert
6. de gauche pour aller chercher l entr e modifier puis l onglet Editeur de table gt sur celui de droite pour visualiser toutes les donn es de l entr e choisie 3 3xplorer loj x Fichier Editer Voir Bookmark Chercher LDIF Options Outils S curit Aide s s s s x ofe 4 etage z SA Recherche rapide H Explorateur g R sultats Sch ma Vue HTML F3 Editeur de Table World attribute type 9 cy33 cn C3 objectClass Zoo celtes RE Tarama DGAD objectClass sn E e E 311545 STURBOIS VALERIE description D 313208 LEBEAU JACKY destinationindicator pO gt Sa DGAF_DASJ employeeNumber QOZ oo DGAF DA etage Zi T CRE DGAF_DITS functionalMail iiaiai soutat sre E DGAF DSI givenName H gt EH 310853 MAGIE NICOLE mail D ES gt 3 9602335 LAURENT NATHALIE manager si 9604618 MILLET DOMINIQUE numcompBat RS S DGAF_DSI_PINC numcompEtage US ES gt DGAF DSI_SPEC numcompPiece Es o numcompSite D z 4 5 311522 BEVIA FREDERIC ou En 2 315102 BOEBION PASCALE roomNumber O a 9603158 CHATOR OLMIER serviceAdress1 US EE TT 603889 REGU serviceAdress2 Oooo o DGAF_DSI_SRSSI serviceCodePostal 6 DGAJ serviceLong sh DGAS serviceVille ES EE 7 4 DGAT 1 Aller chercher l entr e t
7. syst me de log dans le seul fichier params XML gt un seul fichier de param tres pour toute l application Variable dans Log4j properties Variable dans Valeur initiale Commentaire Params xml Deux niveau de trace principaux e INFO standard e TRACE pour debug tr s verbeux log level log4JLogLevel d yyyy MM dd HH mmi ss SSS log4JPatternLayout 5D m n log4JRepLogs logs log4JLogFileName AlPLog log log pattern Au format log4j standard R pertoire de stockage du log Nom du fichier de log log chemin S log fichier R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 19 30 AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 4 3 3 Structure et contenu du fichier de log L AIP utilise deux types de fichier de log e De mani re globale le fichier AIP_HOME logs AlPLog log e De mani re exceptionnelle le fichier de log Tomcat standard CATALINA HOME logs catalina out 4 3 3 1 Fichier AlPLog log En mode de tra age INFO variable log4JLogLevel dans params xml et en mode de fonctionnement nominal tout appel un cran de l A I P g n re minima 2 lignes de traces qui sont horodat es e Une trace de d but appel e Une trace de fin fin d affichage d une page HTML l cran Illustration 2009 02 26 e 0 0 1 AfficherFormulaireRecherc
8. 3 DSI SPSI CONSEIL GENERAL Gironde Niveau de Distribution ome 2 mee fe Annuaire Interne des Personnels v 1 0 Manuel Technique V1 4 V rification DE CC E Nom Nom Dae fogot oto pe fa e 3 AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 1 Historique et documents de r f rence 1 1 Historique PELC Version Nom Description 27 02 09 vi Olivier CHATOR Cr ation du document 04 03 09 V1 1 Laurent CHELET Relecture 09 03 09 V1 2 Olivier CHATOR Ajout d un paragraphe Cas particulier de la balise mailMappingChampsModifies 06 05 09 V1 3 Olivier CHATOR Mise jour suite e Changement de JDK 1 4 2 vers 1 5 e Evolution des copies d cran e D marrage sans les photos agent en Juin 2009 04 01 10 V14 Olivier CHATOR Mise jour suite de nombreuses volutions et modifications 1 2 Documents de r f rence Document Nom Manuel d installation du logiciel A I P v 1 x AIP v 1 0 Manuel Installation version doc Manuel d administration du logiciel A I P v 1 x AIP v 1 0 Manuel Administration version doc Manuel de l utilisateur du logiciel A l P v 1 x AIP v 1 0 Manuel Utilisateur version doc Manuel d exploitation du logiciel A I P v 1 x AIP v 1 0 Manuel Exploitation version doc R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 2 30 AIP v 1 0
9. CAMETA INF 21 08 2009 121 rwxr xr x aip photos 16 09 2009 15 rwxr xr x aip Csrc 25 09 2009 101 rwxr xr x aip Ctemp 15 12 2009 17 rwxrwxr x aip CD WEB INF 21 08 2009 12 rwxr xr x aip ss index jsp 61 26 02 2009 09 rwxr xr x aip R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 10 30 3 AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 3 3 Contenu de chaque r pertoire de l application Dans les r pertoires list s ci dessus on trouve tous les fichiers de l application R pertoire ou fichier Fichiers Descriptions Commentaires conf css images js jsp lang LDAP Schema logs META INF WEB INF WEB INF classes WEB INF classes AIP params xml params xml template Fichier global de param trage du logiciel Fichier mod le de param trage du logiciel en cas de pb log4j properties template Fichier mod le du fichier WEB INF classes log4j properties AIP css Feuille de style globale du logiciel cadres fontes etc Images ic nes etc Contient toutes les fonctions Javascript du logiciel Fichier pouvant tre supprim et qui ne sert qu fournir un tat des lieux de compl tude de certaines donn es de l annuaire Il nest jamais utilis par les autres composants mais peut aider fournir une analyse des donn es pour les administrateurs aib ftDrop ities Fichiers de langue
10. L lnterface class E ABYLAModifierLocalisation class E AfficherCarte class E AfficherEsplorateur class E fficherFichedgent class E AfficherFiche gentModifiable class E AfficherFicheElu class E AfficherFormulaireRecherche class E AfficherListeResultats class E fficherDrganigramme class E AfficherPlan class E EnvoyerFicheParMail class E Explorateur class E ExporterListeResultats class E Fonction class E Interface nnuaire class E ListeDeNoeuds class E ListeParametres class E MyLogger class E Noeud class E Organigramme class E Outils class fo Parametre class E Personne class E Photo class E Service class E ServiceNomCourtComparator class E ServiceNomLongComparator class Pour acc der aux fichiers source d compressez AlP jar dans un r pertoire de travail E ABYL fficherFiche gentModifiable class Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS Fichier CLASS 2212 2009 17 21 16 2212 2009 17 21 16 2212 2009 17 21 16 22 12 2009 17 21 16 22 12 2009 17 21 16 22 12 2009 17 21 16 22712 2009 17 21 16 2212 2009 17 21 16
11. LAEnvoyerFicheParMail class OO Oi O O ABYLAlinterface class U Oi O O ABYLAModifierLocalisation class OOo Oi O O AfficherCarte class AfficherExplorateur class AfficherFicheAgent class AfficherFicheAgentModifiable class AfficherFicheElu class AfficherFormulaireRecherche class AfficherListeResultats class AfficherOrganigramme class AfficherPlan class Non 5 2 1 1 D claration des Servlets Comme pour toute application web les Servlets sont d clar s dans le fichier web xml localis sous S AIP HOME WEB INF au travers des balises servlet name et servlet mapping On pourra se r f rer au paragraphe sur ce fichier Fichier web xml plus haut dans ce document 5 2 1 2 Structure des Servlets Elles sont toutes b ties sur le m me mod le et suivent le standard Java en terme d laboration 3 m thodes principales e init Initialisation des pools de connexion initialisations globales e service g n ration de la page HTML suite appel par un navigateur e destroy vide R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 24 30 S AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 5 3 Librairie AlP jar Cette librairie localis e sous AIP_HOME WEB INF lib contient tous les objets compil s class et leur code source java utiles aux Servlets vues ci dessus Son contenu Nom Type Date de modification E ABYLAEnvoyerFicheParMail class E ABY
12. Manuel Technique V1 4 doc Annuaire Interne Table de mati res 1 HISTORIQUE ET DOCUMENTS DE REFERENCE 2 1 1 Historique 2 1 2 Documents de r f rence 2 2 INTRODUCTION 5 2 1 Objectifs du document 5 2 2 Limite de la v 1 0 5 3 ARCHITECTURE LOGICIELLE DE L APPLICATION 6 3 1 Pr requis 6 3 1 1 Les produits logiciels indispensables 6 3 12 Le montage r seau d acc s aux photos agent 6 3 1 3 Param trage Tomcat sp cifique au CG33 6 3 1 3 1 Fichier CATALINA_HOME conf web xml 6 3 1 3 2 Fichier CATALINA_HOME conf context xml 6 3 1 4 Param trage standard OpenLDAP 7 3 15 Sp cification du niveau de log OpenLDAP 8 3 2 L arborescence g n rale du logiciel AIP v 1 0 10 3 3 Contenu de chaque r pertoire de l application 11 4 COMPOSANTS HORS TRAITEMENT C UR 12 4 1 Fichier params xml 12 4 1 1 Structure 12 4 1 2 Le param trage global du logiciel 13 4 1 3 Cas particulier de la balise mailMappingChampsModifies 17 4 2 Fichiers properties 18 4 2 1 Objectifs 18 4 2 2 Multilinguisme 18 4 2 3 Structure d un fichier properties 18 4 3 Fichiers Jog amp log yyyy mm dd 19 4 3 1 Objectifs 19 4 3 2 Param trage 19 4 3 2 1 WEB INF classes log4j properties 19 4 3 2 2 conf params xml 19 4 3 3 Structure et contenu du fichier de log 20 4 3 3 1 Fichier AIPLog log 20 4 3 4 M canisme d historisation automatique 21 4 3 5 Les erreurs 21 4 3 5 1 Fichier AIPLog log 21 4 3 5 2 Fic
13. V1 4 doc Page 22 30 AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 4 9 Fichier slapd conf Ce fichier se situe dans le r pertoire AIP_ HOMEY LDAP Schema I n est d aucune utilit pour le logiciel AIP v 1 0 lui m me mais int gre une copie du fichier de param trage OpenLDAP Il est consid rer en quelque sorte comme une sauvegarde li e la structure de l annuaire lui m me mais pas l interface de consultation objet de ce document 4 10 Fichiers ASupprimer txt Ils sont au nombre de 2 et localis s dans les r pertoires e S AIP_ HOME logs e S S AIP HOME temp Question Pourquoi laisser un fichier vide ASupprimer txt dans ces r pertoires R ponse Certains outils de compression n embarquent pas les r pertoires vides dans les archives compress es Nous verrons plus loin au sein du paragraphe Etape 5 G n ration du fichier war toute l utilit de ces fichiers 4 11 Fichier MANIFEST MF Ce fichier se situe dans le r pertoire AIP HOMEY META INF Il est au format standard pour une application web et ne contient aucune particularit d clarative Manifest Version 1 0 AIP_CG33 1 0 Created By O CHATOR CG33 2009 4 12 Fichier web xml Ce fichier se situe dans le r pertoire AIP_HOMEY WEB INF Il est au format standard d une application web et contient la d claration des 8 servlets utilis es dans le logiciel Exemple pour un
14. aille nb D enregistrements ramen s du serveur ABYLAFicModifs ABYLAModifs csv Fichier dans le r pertoire d fini par le param tre repPourAbyla qui contient les donn es pour modification de localisation des agents ABYLANbEISDansListes Nombre d l ments affich s dans les listes de sites b timents tages et pi ce Envoi ou non d une demande de validation la BAL fonctionnelle de la direction de rattachement de l agent URLs des applications externes SIG affichage de plans etc appel es par l AIP ABYLAValidationSecretariat Il urlSig Dans ces URLS au sein du fichier urlAbyla params xml urlAnnuaireElus http e Les caract res sont remplac s urlOmnivista http dynamiquement par le code au moment de l ex cution e Les s quences amp amp remplacent les caract res amp rencontr s dans les URLs Param trage des envois des fiches agents modifi es la demande de l utilisateur mailSupportDestinataire Adresse mail du support qui faire l envoi lors de modifications de fiche agent N est plus utilis cf m canismes du param tre mailMappingChampsModifies explicit s ci dessous R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 16 30 AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne Param tre Exemple de valeur Commentaire mailMappingChampsModifies S
15. ation de fiche Ce tag est un param tre pass entre les servlets qui g rent les demandes de modification de fiche annuaire Nom du fichier de langue utilis localis dans le r pertoire d fini par le param tre repLang Nom du fichier css localis dans le r pertoire d fini par le param tre repCss Nom du fichier de fonctions javascript utilis localis dans le r pertoire repJs dn dn A I P dn LDAP matricule employeeNumber Matricule A I P employeeNumber LDAP A i e a a numCanton departmentNumber numCanton A I P departmentNumber LDAP R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 14 30 9 AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne Param tre Exemple de valeur Commentaire Activation inhibition de certains crit res de recherche sur le formulaire principal filtrerFonction filtrerService filtrerServiceLong filtrer MotCle Inhib en v 1 0 au CG33 demande DRH Activ en v 1 0 au CG33 Activ en v 1 0 au CG33 Activ en v 1 0 au CG33 Activation inhibition d affichage de certaines informations dans les crans ou exports de donn es afficherFonction afficherMailFonctionnel afficherBtnExporter afficherSecretaires afficherPhotos afficherListePersonnesTopLevelDans Organigramme activerAppelTelAutomatique autoriser ModificationsFicheAgent autoriser DemandeModifPhotos autoriserCommentaire
16. chier ASupprimer txt amp Remarque Question Pourquoi laisser un fichier vide ASupprimer txt dans ces r pertoires R ponse Certains outils de compression n embarquent pas les r pertoires vides dans les archives compress es 6 7 Etape 5 Mise disposition du fichier AIP war Par analogie avec ce qui est d crit dans le manuel d installation cit en r f rence pensez mettre le nouveau AIP war disposition via winSCP ou autre mode de transfert de votre choix sur le serveur de VA ou de production dans le r pertoire de d p t de packages d installation par exemple home aip installers Concernant l installation suivre le mode op ratoire fourni dans le document cit en r f rence qui concerne cette phase R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 28 30 AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 7 Annexe Intervention directe sur les donn es de l annuaire 7 1 Introduction Ce chapitre n est mettre en uvre qu en cas d urgence lev e o une modification en direct sur les donn es s av re n cessaire I ne doit tre utilis dans aucun autre cas puisque l alimentation en donn es est issue d interface automatis es partir des applications m tier amont 7 2 L outil JExplorer C est un outil Open Source qui peut tre d ploy sur un client Linux ou Windows puisqu il est ent
17. de opt openldap etc openldap schema inetorgperson schema Define global ACLs to disable default read access Do not enable referrals until AFTER you have a working directory service AND an understanding of referrals referral ldap root openldap org pidfile opt openldap var slapd pid argsfile opt openldap var slapd args Load dynamic backend modules moduleload back_ldap la moduleload back_ldbm la moduleload back_passwd la moduleload back_shell la RE EE H Sample Access Control faccess to j by self write by users read by anonymous auth F F F if no access controls are present j Allow read by all F F rootdn can always write modulepath home oc openLdap2027 libexec openldap j j j Allow read access of root DSE j Allow self write access j Allow authenticated users read access F Allow anonymous users to authenticate j access to dn by read the default is FERREE EE ldbm database definitions FE AE AE AE AE AE AE FE FE AE AE FE AE FE FE AE FE FE AE FE FE AE FE TE AE FE TE AE FE EAE HE EEH EAEE EAE EAH H EAE RE EAE H EAH H database ldbm suffix dc cg33 dc cg33 rootdn cen cg33 dc cg33 dc cg33 rootdn cn Manager o My Organiza
18. e des Servlets lt servlet gt lt servlet name gt AfficherFormulaireRecherche lt servlet name gt lt servlet class gt AIP AfficherFormulaireRecherche lt servlet class gt lt servlet gt lt servlet mapping gt lt servlet name gt AfficherFormulaireRecherche lt servlet name gt lt url pattern gt AfficherFormulaireRecherche lt url pattern gt lt servlet mapping gt Le caract re devant leur nom dans la balise url pattern traduit le fait que leur URL d appel est toujours de la forme http serveur port AIP CG33 servlet R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 23 30 EC AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 5 Composants traitement c ur 5 1 Introduction Le logiciel A I P v 1 0 utilise les composants c ur int gr s au package java AIP_HOMEY WEB INF lib AIP jar Les servlets de l IHM de consultation sont au nombre de 13 dont 4 sp cifiques au CG33 de part l utilisation de l application Abyla 5 2 Servlets La bascule entre mode sp cifique CG33 et mode standard de traitements effectue vie valorisation O ou N du param tre utiliser AbylaPourLocalisations dans le fichier AIP_HOME conf params xmi Utilis e si le param tre TES S HEGUTUEMERE utiliser AbylaPourLocalisations Servlet au CG33 vaut ABYLAA ficherFicheAgentModifiable class Oui O ABY
19. elephoneNumber _ La Sh DGS modifier dans l arbre visiteAdress1 3 Soumettez la modification US EE gt Sh ELU MisiteAdress2 gt di PAY MisiteCodePostal QOZ oOo O gt RPRES visiteville E ne audio businessCategory canton R initialiser Changer une Classe Propri t s Connected To Idap srymv aymar cg33 fr 6669 aussit t sur l IHM de consultation de l annuaire Le fait de cliquer sur le bouton Soumettre implique une modification imm diate des donn es qui est r percut e 7 5 D connexion S lectionnez Fichier gt Se d connecter GD Jxplorer Options Outils S curit Aide x ole amp Imprimer Se d connecter du serveur AltD AR Rafraichir l arborescence o7 Sch ma Vue HTML Editeur de attribute t R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 30 30
20. ent IdapConnectionPoolSizeFicheElu IdapConnectionPoolSizeFicheAgentModifiable IdapConnectionPoolSizeEnvoyerFicheParMail Donn es de connexions l annuaire LDAP initialContextFactory com sun jndi ldap Contexte d acc s au serveur LDAP mode JNDI LdapCtxFactor providerURL URL LDAP d acc s au serveur d annuaire securityAuthentication Type d authentification sur le serveur le LDAP baseRecherche Racine de base de recherche dans le LDAP securityPrincipal Utilisateur de consultation de l annuaire LDAP securityCredentials Mot de passe de l utilisateur topLevel Libell de la racine de haut niveau dans le LDAP topLevelLong CONSEIL GENERAL DE Libell long de la racine de haut niveau dans le LA GIRONDE LDAP defaultSearchScope Scope de recherche par d faut dans l annuaire Param trage des charsets xxxxxxCharsetEncoding ISO 8859 1 ou UTF 8 4 param trages de charset sont possibles selon que l l ment param trer se situe dans un environnement windows ISO 8859 1 ou Linux UTF 8 IdapServerCharsetEncoding celui de l annuaire LDAP serveurCharsetEncoding celui du serveur qui fait tourner PAIP exportCharsetEncoding celui du fichier XLS export ISO 8859 1 puisque vers le monde Windows mailCharsetEncoding celui du fichier joint au mail de demande de modification de la fiche agent qui est envoy au support g n ralement ISO 8859 1 puisque vers le monde Windows R pertoires de l application rela
21. er la fin Log slapd opendlap local4 var log slapd log 3 Relancer syslog etc init d syslog restart 4 Relancer openidap etc init d syslog restart R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 8 30 AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne Pour info 1 Niveaux de log OpenLDAP number hex value log name Logging description i OXFFFF enable all logging 0 0x0000 logging inhibited no logging occurs including critical errors Not recommended 1 foxi acl E trace function calls 2 0x2 packets debug packet handling 4 0x4 args heavy trace debugging 8 0x8 conns connection management 16 0x10 BER print out packets sent and received 32 0x20 filter search filter processing 64 0x40 config configuration file processing 128 0x80 ACL access control list processing 256 E 0x100 stats stats log connections operations results 512 0x200 stats2 stats log entries sent 1024 0x400 shell print communication with shell backends 2048 0x800 parse print entry parsing debugging 4096 0x1000 cache caching unused g 8192 0x2000 index indexing unused 16384 0x4000 sync print syncrepl replica logging 32768 0x8000 none A misnomer it will log message that are not categorized including curial messages On les positionne dans le slapd conf avec loglevel v o v peut
22. er le nom du fichier de langue donc de remplacer dans la balise ci dessus aip_fr properties par aip_en properties 4 2 3 Structure d un fichier properties Chacune des lignes utiles du fichier est de la forme attribut valeur o e attribut est le nom interne manipul par les servlets du libell afficher dans un cran e valeur est la valeur r elle du libell affich sur l cran On aura par exemple pour le formulaire de recherche principal frmRecherche titre Rechercher frmRecherche critere 1 label Nom contient frmRecherche critere 2 label Pr eacute nom contient frmRecherche critere 3 label T amp eacute l amp eacute phon num amp eacute ro de poste frmRecherche critere 4 label DGA ou Direction ou Service frmRecherche critere 5 label Libell seacute long de Service contient frmRecherche critere 6 label Fonction frmRecherche critere 7 label Mot cl amp eacute frmRecherche explorateurEtorganigramme label Organigramme et explorateur des services Pour viter tout probl me de transcodage ISO08859 1 vers UTF 8 par exemple les valeurs des libell s sont exprim es au format HTML Ainsi par exemple le sera repr sent sous sa forme HTML amp eacute Comme pour toute modification dans le fichier params xml modifi il faut imp rativement red marrer tomcat pour que les changements int gr s dans les
23. ervice stackTrace com sun jndi ldap LdapPoolManager getLdap Client LdapPoolManager java 291 x SJ intranet local Kioo 2 4 4 Fichier AIP css Ce fichier se situe dans le r pertoire AIP HOME css Il est au format standard pour une application web et ne contient aucune particularit 4 5 Fichier AIP js Ce fichier se situe dans le r pertoire AIP_ HOME js Il est au format standard pour une application web et ne contient aucune particularit 4 6 Fichier params xml template Ce fichier se situe dans le r pertoire AIP HOME conf Il est une copie initiale du fichier params xml et peut servir de base pour la cr ation d un nouveau fichier de param trage 4 7 Fichier log4j properties template Ce fichier se situe dans le r pertoire AIP HOME conf Il est une copie initiale du fichier log4j properties qui doit se trouver sous AIP HOME WEB INF classes et peut servir de base pour la cr ation d un nouveau fichier de param trage 4 8 Fichier inetorgperson schema Ce fichier se situe dans le r pertoire AIP HOMEY LDAP Schema Il n est d aucune utilit pour le logiciel AIP v 1 0 lui m me mais int gre une copie du sch ma d annuaire modifi au format LDAP Il est consid rer en quelque sorte comme une sauvegarde li e la structure de l annuaire lui m me mais pas l interface de consultation objet de ce document R f rence AIP v 1 0 Manuel Technique
24. fichiers properties soient pris en compte En effet ils sont galement charg s au moment du d marrage et une fois pour toute R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 18 30 AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 4 3 Fichiers log amp log yyyy mm dd 4 3 1 Objectifs Ces fichiers sont accessibles dans le r pertoire logs lls permettent de conserver la trace des appels de chacune des servlets qui sont autant d cran du logiciel Les m canismes de tra age s appuie sur le standard log i 4 3 2 Param trage 4 3 2 1 WEB INF classes log4j properties Ce fichier qu il n est pas n cessaire de modifier normalement contient les l ments suivants norm s log4j rootLogger log level AIPLog appender AIPLog org apache log4j DailyRollingFileAppender appender AIPLog DatePattern yyyy MM dd appender AIPLog layout org apache log4j PatternLayout appender AIPLog layout ConversionPattern log pattern appender AIPLog file log chemin log fichier Les variables de la forme sont des variables issues du fichier params xml cf paragraphe suivant 4 3 2 2 conf params xml Pour assurer une prise en compte souple des modifications sans se disperser et par soucis de centralisation des op rations l utilisation des variables permet de d porter le param trage du
25. ge 21 30 AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 4 3 5 3 Cas particulier Si l erreur se produit au moment de l initialisation des servlets comme par exemple l impossibilit de trouver le serveur LDAP au d marrage l erreur est restitu e directement l cran lors de l appel au premier cran mais pas dans un des fichiers 10 xi gt http Fichier Edition amp ffichage Favoris Outils 2 Liens p E Sha je http jlocalhost 6666 AIP_CG33 AfficherFormulaireRecherche z X Pi to H i Page O Outils localhost 6666 AIP_CG33 AfficherFormulaireRecherche Windows Internet Explorer ir d httpiilocahost 6666 AIP_CG33 AfficherFormulaireR 6 Afficher FormulaireRecherche service Exception localhost 9998 Afficher FormulaweRecherche service stackTrace com sun jndi ldap Connection Connection java 204 Afficher FormulaweRecherche service stackTrace com sun jndi ldap LdapClhent LdapClent java 119 Afficher FormulareRecherche service stackTrace com sun jndi idap LdapClentFactory create PooledConnection LdapClentFactory java 44 AfficherFormulaweRecherche service stackTrace com sun jndildap pool Connections Connections java 97 Afficher FormulaweRecherche service stackTrace com sun jndiidap pool Pool getPooledConnection Pool java 114 AfficherFormulaweRecherche s
26. glet source G Source le Projects Libraries 2o Order and Export Source folders on build path j Add Folder 2 Included Al 0 Excluded None Link Source a Native library location None Edit Remove J Allow output Folders For source folders Default output Folder GP _CG33 WEB INFfclasses Browse Ongjlet librairies LS Source L Projects o Order and Export JARs and class folders on the build path Eld activation jar AIP_CG33 WEB INF lib Add JARS H lue axis jar AIP_CG33 WEB INF lib H eg jsp api jar C Program Files Apache Software Foundationi Tomcat 6 0ib Add External JARs 0 log4j 1 2 14 jar AIP_CG33 WEB INF lib I mail jar AIP_CG33 WEB INF lib Eee E fa ojdbc5 jar C Program Files Apache Software Foundationi Tomcat 6 0ib Add Library E fg servlet api jar C Program Files Apache Software Foundationi Tomcat 6 0 lib E A JRE System Library jre6 __ Add Class Folder Add External Class Folder Edit Remoye Migrate JAR Filer 4 S lectionnez Project gt build all pour v rifier que tout est correct la compilation R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 27 30 3 AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 6 4 Etape 2 Modification amp test des composants Modifiez les composants recompilez g
27. h servic Debut 2009 02 26 0 0 1 AfficherFormulaireRecherch servic Fin 2009 02 26 0 0 1 AfficherListeResultats service Debut 2009 02 26 0 0 1 AfficherListeResultats service Fin Chaque ligne du fichier de log variable log4JLogFileName dans params xmil est structur selon la norme log4j et le format d crit via la variable log4JPatternLayout dans params xml galement Ainsi si l on d taille la structure de chaque ligne on obtient illustration concr te avec la premi re fournie dans l illustration ci dessus Valeur Description 2009 02 26 Date au format yyyy mm dd 16 36 30 463 Heure avec les centi mes de seconde INFO Niveau de trace Num ro d appel s quentiel de la page Il est incr ment de 1 chaque appel 1 ce qui permet de retrouver rapidement le nombre d appel de chaque page et ainsi d ajuster ventuellement les pools de connexion Adresse IP ayant effectu l appel Ceci permettra terme de suivre des fins statistique le profil des transactions effectu es IL NE S AGIT EN AUCUN CAS DE SURVEILLER CE QUE FONT LES AGENTS VIA L AIP 127 0 0 1 D ailleurs les param tres pass s ce qu ils recherchent ne sont pas restitu s Le seul int r t est de savoir par o passe une transaction pour optimiser les pools de connexion mais galement mettre l accent sur tel ou tel am lioration dans le futur AfficherFormulaireRecherche Nom de la servle
28. hier catalina out 21 4 3 5 3 Cas particulier 22 R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 3 30 AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 4 4 Fichier AIP css 22 4 5 Fichier AIP js 22 4 6 Fichier params xml template 22 4 7 Fichier logdj properties template 22 4 8 Fichier inetorgperson schema 22 4 9 Fichier slapd conf 23 4 10 Fichiers ASupprimer txt 23 4 11 Fichier MANIFEST MF 23 4 12 Fichier web xml 23 5 COMPOSANTS TRAITEMENT C UR 24 5 1 Introduction 24 5 2 Servlets 24 5 2 1 1 D claration des Servlets 24 5 2 1 2 Structure des Servlets 24 5 3 Librairie AIP jar 25 6 COMMENT MODIFIER DES COMPOSANTS C UR 26 6 1 Introduction 26 6 2 Etape 0 Pr requis 26 6 3 Etape 1 Cr ation du projet Eclipse 27 6 4 Etape 2 Modification amp test des composants 28 6 5 Etape 3 Cr ation du fichier AIP jar 28 6 6 Etape 4 G n ration du fichier AIP war 28 6 7 Etape 5 Mise disposition du fichier AIP war 28 7 ANNEXE INTERVENTION DIRECTE SUR LES DONNEES DE L ANNUAIRE29 7 1 Introduction 29 7 2 L outil JExplorer 29 7 3 Connexion au Ldap 29 7 4 Modification de donn es 30 7 5 D connexion 30 R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 4 30 EC AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 2 Introduction 2 1 Objectifs du document L Annua
29. i rement crit en langage Java Il est directement t l chargeable sur le site http jxplorer org 7 3 Connexion au Ldap Etape 1 Sur l interface graphique de l outil s lectionner Fichier gt Se connecter iol xj ark Chercher LDIF Options Outils S curit Aide Se connecter un serveur Aite imprimer Recherche rapide Rafraichir l arborescence unter simple htmi v pas d entr es Welcome to JXplorer Java This panel will display the results of your directory browsing and searches If you need any assistance use the help option on the menu bar above Not Connected i Etape 2 Remplir les donn es de connexion l annuaire Open LDAP puis cliquer sur le bouton OK 3 Ouverture d une connexion LDAP DSML Fi x Hote C Por BL Protocole LDAP vs x Service DSML Valeurs optionnelles Base DN dc cg33 dc c933 S curit Niveau Utilisateur Mot de Passe ar Utilisateur DN cn cg33 dc cg33 dc cg33 Mot de passe Use a Template Sauvegarder AIP Production v Supprimer L D faut OK Abandonner Aide L R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 29 30 AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 7 4 Modification de donn es Utilisez l arbre
30. ibe l acc s l organigramme Active inhibe l acc s l explorateur Active inhibe l acc s la liste des agents rattach s un manager Active inhibe l acc s l application Abyla au CG33 via appel d URL d affichage du plan du bureau de l agent Active inhibe l acc s l application Google au CG33 via appel d URL d affichage du plan de quartier pour se rendre au b timent de l agent Active inhibe l acc s l application portail institutionnel au CG33 via appel d URL d affichage de la fiche Canton d un lu Si positionn O permet d inhiber temporairement l appel URL l application de restitution des plans de bureau et affiche un message alternatif param tr dans le fichier de langue aip_xxx properties gt Relance Tomcat Si positionn O permet d inhiber temporairement l appel URL l application de restitution des plans de quartier et affiche un message alternatif param tr dans le fichier de langue aip_xxx properties gt relance Tomcat R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 15 30 S AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne Param tre Exemple de valeur Commentaire afficherMessageAlternatifFicheCanton N Si positionn O permet d inhiber temporairement l appel URL l application de restitution des fiches canton d un lu et affiche un message alterna
31. ire Interne des Personnels d sign par l acronyme A I P s inscrit dans le cadre du projet global Annuaires du CG33 qui regroupe galement les annuaires applicatifs internes et externes SSO Dans ce contexte le pr sent document vise d crire tous les aspects techniques relatifs au logiciel A I P en v 1 0 pour ce qui concerne les points suivants e Architecture interne du logiciel e Description des composants applicatifs 2 2 Limite de la v 1 0 Dans sa forme actuelle la v 1 0 ne dispose pas d un IHM web d administration La modification des fichiers de param trage doit donc se faire de mani re manuelle R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 5 30 AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 3 Architecture logicielle de l application 3 1 Pr requis 3 1 1 Les produits logiciels indispensables Pour pouvoir tre ex cut de mani re satisfaisante le logiciel A l P v 1 0 n cessite de disposer sur le serveur machine virtuelle Linux par exemple avec 4Go de RAM si possible qui l h berge 1 D un serveur d application web de type Tomcat en version 6 0 20 racine d installation S CATALINA HOME 2 D un JDK 1 6 les composants logiciels ayant t compil s avec la version 1 6 0 16 3 D un acc s l annuaire LDAP qui h berge les donn es de l annuaire lui m me On parle bien ici d un acc s car il n
32. nt tagToutesFonctions Toutes tagSplitSecretaires tagSplitOU tagPhoto photo tagCommentaires commentaires Param trage des fichiers de ressource de l application ficLang aip_fr properties ficCss AIP css AIP jS Mapping entre le nom interne l application et les champs de donn es de l annuaire LDAP Texte contenu dans le champs description du sch ma d annuaire LDAP qui permet de faire la distinction entre agents et lus Texte repr sentant toutes les fonctions en t te de la liste des fonctions si elle est affich e dans les crit res du formulaire de recherche d braill en v 1 0 au CG33 via le param tre filtrerFonction positionn N Tag permettant de s parer dans le champs secretary du sch ma d annuaire LDAP les secr taires qui sont not es sous la forme EmployeeNumber xxx EmployeeNumber yy y d braill en v 1 0 au CG33 via le param tre afficherSecretaires positionn N Tag permettant de s parer les services sous forme hi rarchios e dans le champs ou du sch ma d annuaire LDAP Exemple CG33 DGAF DSI Tag technique repr sentant la photo d un agent ou d un lu lors de sa demande de modification de fiche Ce tag est un param tre pass entre les servlets qui g rent les demandes de modification de fiche annuaire Tag technique repr sentant le commentaire que peut laisser un agent ou un lu lors de sa demande de modific
33. oire photos est un montage r seau vers photos NOM_PRENOM_employ srvphoto DRH EDIGRAPH CG33 Images pour acc der eeNumber jpg aux photographies des agents au format sp cifi dans l exemple ci contre gauche et sous forme de fichiers jpg je AIP_WS java Code source des Web Services de consultation de l AIP AIP java Code source des servlets amp objets IHM de consultation src javadoc Javadoc de tous les fichiers source du package AIP temp R pertoire de travail utilis par le logiciel Index jsp Fichier global de d marrage du logiciel de consultation AIP amp Remarque L AIP est une application Full Open Source e Toutes les librairies utilis es sont compl tement Open Source aucune n est propri taire e Le serveur d application Tomcat l est galement e M me constat pour Open LDAP R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 11 30 EC AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 4 Composants hors traitement c ur 4 1 Fichier params xml 4 1 1 Structure C est le fichier principal de param trage global du logiciel A l P v 1 0 o tout le param trage est centralis accessible dans le r pertoire conf On notera que 1 La liste des param tres est fournie entre les balises lt Parametres gt et lt Parametres gt 2 Chaque param tre est d crit entre des balises lt Param gt et lt Param gt et repr sent
34. omcat standard CATALINA HOME logs catalina out 4 3 5 1 Fichier AlPLog log amp A noter Toute erreur laisse 2 types de traces e Celle de haut niveau comme par exemple une Exception g n ralement r sum e sur la premi re ligne e La stack trace java si le param tre debug dans le fichier AIP_HOME conf params xmil est O La structure des lignes de trace est quasiment identique hormis l ajout du type d erreur ou de StacKTrace derri re le nom de la fonction de la servlet seul le niveau de trace INFO si tout va bien passe ERROR Par exemple 2009 02 27 10 43 30 007 ERROR 1 127 0 0 1 InterfaceAnnuaire setSearchScope String NamingException LDAP error code 32 No Such Object 2009 02 27 10 43 30 007 ERROR 1 127 0 0 1 InterfaceAnnuaire setSearchScope String NamingException stackKTrace com sun jndi ldap LdapCtx mapErrorCode LdapCtx java 3013 2009 02 27 10 43 30 007 ERROR 1 127 0 0 1 InterfaceAnnuaire setSearchScope String NamingException stacKTrace com sun jndi ldap LdapCtx processReturnCode LdapCix java 2934 2009 02 27 10 43 30 007 ERROR 1 127 0 0 1 InterfaceAnnuaire setSearchScope String NamingException stacKTrace com sun jndi ldap LdapCtx processReturnCode LdapCix java 2740 4 3 5 2 Fichier catalina out M me chose que pour le fichier de log principal AlPLog log m me formalisme des lignes de trace R f rence AIP v 1 0 Manuel Technique V1 4 doc Pa
35. ployeeNumber 9603158 R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 9 30 AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne Jan 12 12 08 19 serveur slapd 13639 conn 0 op 6 SRCH base dc cg33 dc cg33 scope 2 filter employeeNumber 311522 Jan 12 12 08 19 serveur slapd 13639 conn 0 op 5 SEARCH RESULT tag 101 err 0 text Jan 12 12 08 19 serveur slapd 13639 conn 0 op 6 SEARCH RESULT tag 101 err 0 text Ce loglevel ne semble pas p naliser les perfs mais attention au volume du fichier de log compte tenu du nombre de requ tes pas jour 3 2 L arborescence g n rale du logiciel AIP v 1 0 En se r f rant au manuel d installation nous avons vu que tous les composants sont install s sous le r pertoire racine du logiciel A I P v 1 0 i e sous le r pertoire CATALINA HOME webapps AIP_CG33 On admet que ce r pertoire racine de l application sera d sign par la variable AIP_ HOME dans tout ce qui suit Ainsi partir de cette racine d installation principale on trouvera l arborescence suivante e E 30 10 2009 14 rwxr xrx AiP O conf 14 12 2009 17 rWxr xr x aip Bess 14 12 2009 16 rwxr xr x aip images 10 12 2009 17 rwxr xr x aip Qis 14 12 2009 121 ruxr xr x aip Bisp 23 11 2009 09 rwxr xr x aip Blang 17 11 2009 16 rwxr xr x aip LDAP Schema 14 09 2009 15 ruxr xr x aip Clogs 16 12 2009 08 rwxrwxr x aip
36. s experimentation exportDetaille debug activerControleMatriculePourModif accederOrganigramme accederExplorateur accederEquipe accederPlan accederCarte accederFicheCanton afficherMessageAlternatifPlan afficher MessageAlternatifCarte Inhib en v 1 0 au CG33 demande DRH z 5 D D lt v en Q Q re ar Active inhibe la possibilit d export XLS Inhib en v 1 0 au CG33 demande DRH Active inhibe l affichage des photos Inhibe l affichage des listes de personne sous les service pour le niveau le plus haut de l organisation probl me de performance sinon Active inhibe l appel tel Automatique sur clic Active inhibe la possibilit de demander la modification de la fiche agent Active inhibe la possibilit de demander la modification de sa photo Active inhibe la possibilit de laisser un commentaire dans la fiche agent modifiable Active inhibe l affichage d un cartouche en t te du formulaire de recherche en cas de version d exp rimentation de l AIP Active inhibe l export des colonnes num ros de matricule des agents EmployeeNumber b timent tage amp pi ce Active inhibe le mode de d bogage affichage en direct des stack trace java si probl me Active inhibe la demande de saisie du num ro de matricule EmployeeNumber pour donner l acc s la fiche agent modifiable Utilis tant que pas de SSO disponible contr le minimaliste Active inh
37. ste de diffusion en copie adresses s par es par des virgules derri re le texte cc Ainsi si on tablit 3 r gles de routage par exemple e R gle R1 e R gle R2 e R gle R3 Elles peuvent se traduire ainsi photo departmentNumber commentaires sn givenName ou organizationalUnitName title manager secretary to o chator cg33 fr cc p1 cg33 fr telephoneNumber mobilePhone destinationindicator fax to a cg33 fr mail functionalMail to o chator cg33 fr cc 0 chator cg338fr street postalCode postOfficeBox physicalDeliver yOfficeName etage piece roomNumber to o chator cg33 fr cc 0 chator cg33 fr R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 17 30 S AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 4 2 Fichiers properties 4 2 1 Objectifs Ces fichiers sont accessibles dans le r pertoire lang Ils permettent e De ne jamais avoir diter de code servlets pour modifier un libell de zone d cran ou le texte d un bouton e De g rer le multilinguisme 4 2 2 Multilinguisme Le nom du fichier de langue choisi est r f renc dans le fichier global de configuration params xml au travers de la balise lang Dans l illustration ci dessous on utilise le fichier aip_fr properties lt Param gt lt nom gt lang lt nom gt lt valeur gt aip_fr properties lt valeur gt lt Param gt Pour passer en langue anglaise il suffit de chang
38. t effectuant la trace service Nom de la fonction dans la servlet effectuant la trace Debut Contenu du message de trace R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 20 30 AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 4 3 4 M canisme d historisation automatique La ligne log4j appender AIPLog org apache log4j DailyRollingFileAppender du fichier log j properties permet de d finir que l on souhaite tous les jours et automatiquement que le fichier 1og fichier soit historis sous la forme log fichier yyyy mm dd Illustration concr te B AIPLog log El AIPLog log 2009 02 17 E AIPLog log 2009 02 18 E AIPLog log 2009 02 19 El AIPLog log 2009 02 20 Ainsi e Chaque AlPLog log est historis sous la forme AlPLog log yyyy mm dd lhistorisation tant bas e sur la date de cr ation initiale du AlPLog log courant e l devient possible d archiver ou de supprimer les anciens AlPLog log yyyy mm dd selon des modalit s d finies avec les quipes de production Remarque Plus l on peut conserver de AlPLog log yyyy mm dd plus l on pourra faire des statistiques sur une p riode tendue cf structure amp contenu du fichier de log plus loin 4 3 5 Les erreurs Rappel L AIP utilise deux types de fichier de log e De mani re globale le fichier AIP_HOME logs AlPLog log e De mani re exceptionnelle le fichier de log T
39. tif param tr dans le fichier de langue aip_xxx properties gt N cessite un red marrage Tomcat pour prise en compte Param trage de la cryptographie pour crytage des matricules agent dans les pages HTML algorithmeDeCrypto PBEWithMD5AndTripleDE Utilis pour le cryptage des num ros de S matricule EmployeeNumber dans les diff rents crans Les valeurs possibles sont Blowfish DES DESede PBEWithMD5AndDES PBEWithMD5AndTripleDES ou TripleDES cleDeCrypto Cl de cryptage d cryptage Sp cifique au CG33 Laisser les valeurs N ou vides en standard Utilisation de l application m tier Abyla utiliser AbylaPourLocalisations Mise en uvre des m canismes de validation des demandes de modification de localisation envoyerMailSiLocalisationinconnue __ Sp cifie si l on envoie un mail la Direction du Patrimoine si un agent ne trouve pas sa localisation dans les listes propos es mailDestinataireLocalisationinconnue xxxxx cg33 fr Mail la Direction du Patrimoine si un agent ne LE trouve pas sa localisation dans les listes propos es mailCopieLocalisationinconnue Mail en copie si un agent ne trouve pas sa localisation dans les listes propos es ABYLADriverType Driver JDBC d acc s au SGBD d Abyla ABYLAHost Hostname de l application Abyla ABYLAPort Port de l application Abyla ABYLASid Sid Oracle ABYLALogin Login sur la base Abyla ABYLAPassword Mot de passe sur la base Abyla ABYLAFetchSize 200 T
40. tion Name c US R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 7130 S AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne Cleartext passwords especially for the rootdn should be avoid See slappasswd 8 and slapd conf 5 for details Use of strong authentication encouraged rootpw cg33 The database directory MUST exist prior to running slapd AND should only be accessible by the slapd tools Mode 700 recommended directory opt openldap var openldap labm Indices to maintain index default pres eq index uid cn sn givenName pres eq sub index ou serviceLong pres eq sub index employeeNumber eq index manager eq index destinationIndicator pres eq sub index objectClass eq cache cachesize 10000 dbcachesize 2000000 LogLevel Loglevel 256 ATTENTION bien positionner les index pour viter les probl mes de performance dans la restitution des informations et l affichage des crans Les index positionn s ci dessus paragraphe Indices to maintain semblent imp ratifs pour garantir de bonnes performances 3 1 5 Sp cification du niveau de log OpenLDAP Il est possible d activer les logs OpenLDAP qui sont d sactiv s par d faut 1 Editer le fichier opt openlidap etc openidap slapd conf et ajouter la fin Niveau de Log opendlap loglevel 256 2 Editer le fichier etc syslog conf et ajout
41. tivement la racine AIP_ HOME repimages R pertoire des images repJsp R pertoire de la JSP de contr le des donn es repCss R pertoire du fichier css repJs R pertoire du fichier javascript repLib lib Non utilis dans la version industrielle servlets repLang R pertoire des fichiers de langue properties repPhotos R pertoire des photos montage r seau repTemp R pertoire de travail cr ation du fichier joint au mail de demande de modification de fiche agent repPourAbyla temp Sp cifique CG33 R pertoire de travail cr ation du fichier de mise jour des localisations dans l application Abyla de la Direction du Patrimoine R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 13 30 gt AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne Param tre Exemple de valeur Commentaire Param trage du syst me de trace log4ij log4JRepLogs R pertoire du fichier de log courant et des logs historis s nomLog yyyy mm dd log4JLogLevel Niveau de log nomenclature log4j log4JLogFileName Nom du fichier de log courant log4JPatternLayout d yyyy MM dd Format des lignes du fichier de log HHimmi ss SSS 5p m nomenclature log4j en log4JStackTraceDepth Non utilis par l IHM de consultation AIP qui est l objet de ce document mais par le batch global d int gration de donn es Param trage divers tagEstAgent Age
42. tre la somme de diff rents niveaux Exemple loglevel 255 sets 1 2 4 8 16 32 64 and 128 adds all the numbers 2 Par exemple avec un loglevel 256 le fichier var log slapd log contient apr s red marrage et une recherche Jan 12 12 05 48 serveur slapd 21601 slapd shutdown waiting for 0 threads to terminate Jan 12 12 05 49 serveur slapd 21601 slapd stopped Jan 12 12 05 50 serveur slapd 13639 slapd starting Jan 12 12 08 02 serveur slapd 13639 daemon conn 0 fd 7 connection from IP 0 0 0 0 40135 IP 0 0 0 0 0000 accepted Jan 12 12 08 02 serveur slapd 13639 conn 0 op 0 BIND dn CN CG33 DC CG33 DC CG33 method 128 Jan 12 12 08 02 serveur slapd 13639 conn 0 op 0 RESULT tag 97 err 0 text Jan 12 12 08 03 serveur slapd 13639 conn 0 op 1 SRCH base dc cg33 dc cg33 scope 2 filter ou Jan 12 12 08 07 serveur slapd 13639 conn 0 op 1 SEARCH RESULT tag 101 err 0 text Jan 12 12 08 15 serveur slapd 13639 conn 0 op 2 SRCH base dc cg33 dc cg33 scope 2 filter sn chator Jan 12 12 08 15 serveur slapd 13639 conn 0 op 2 SEARCH RESULT tag 101 err 0 text Jan 12 12 08 18 serveur slapd 13639 conn 0 op 3 SRCH base ou DGAF_DSI_ SPSI ou DGAF_DSI ou DGAF dc cg33 dc cg33 scope 2 filter employeeNumber 9603158 Jan 12 12 08 18 serveur slapd 13639 conn 0 op 3 SEARCH RESULT tag 101 err 0 text Jan 12 12 08 18 serveur slapd 13639 conn 0 op 5 SRCH base dc cg33 dc cg33 scope 2 filter manager em
43. tructuration des envois de mail des fiches agent modifi es cf plus loin mailEmetteur Adresse mail metteur g n rique mailServeur Serveur de mail utiliser mailServeurUsername Utilisateur de connexion au mailServeur mailServeurPassword Mot de passe de connexion au mailServeur mailDebugMode Laisser N SupprimerFichierTrvApresEnvoiMail SE Supprimer ou non les fichiers g n r s dans repTemp apr s envoi du mail au support Param trage descriptif de la structure du fichier params xml XML_XXXXXXXXXXXXXXX D crit chacune des 9 balises de la structure du fichier params xmIl NE PAS MODIFIER SVP 4 1 3 Cas particulier de la balise mailMappingChampsModifies Cette balise sert d crire pour chaque champs modifi de la fiche agent si on le souhaite vers qui un ou plusieurs ont doit envoyer un mail en destinataire principal et ou en copie pour actions ventuelles de mise jour dans les applications m tier qui sont les source de donn es de l AIP Sur une seule ligne entre les balises lt valeur gt et lt valeur gt on d finit toutes les r gles de routage des mails Chaque r gle est s par e de la suivante par un point virgule Chaque r gle se compose elle m me de 3 l ments e La liste des champs 1 ou plusieurs s par s par des virgules pour lesquels s applique la r gle e La liste de diffusion principale adresses s par es par des virgules derri re le texte to e La li
44. ts suivants en fin du context xml avant le dernier tag lt Context gt lt Datasource ABYLA gt lt Resourc name jdbc abyla auth Container type javax sql L DataSource driverClassName oracle jdbc OracleDriver url jdbc oracle thin serveur 0000 SID username user password password maxActive 20 maxIdle 10 maxWait 1 gt R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 6 30 AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 3 1 4 Param trage standard OpenLDAP On se r f rera au manuel d installation mais on rappelle pour m moire 1 Qu il convient de rechercher le fichier LDAP Schema inetorgperson schema dans la distribution AIP et de la d tacher le dans le r pertoire LDAP_HOME etc openidap schema en remplacement du fichier original du m me nom 2 Qu il faut ensuite adapter le contenu du fichier LDAP_HOME etc openidap slapd conf au serveur et l environnement 3 Qu l convient enfin d ajouter les 2 lignes d index index employeeNumber eq et ou eq en fin de fichier Exemple 0OpenLDAP pkg ldap servers slapd slapd conf v 1 8 8 7 2001 09 27 20 00 31 kurt Exp See slapd conf 5 for details on configuration options This file should NOT be world readable include opt openldap etc openldap schema core schema include opt openldap etc openldap schema cosine schema inclu
45. ur Tomcat 6 0 20 e D un JDK 1 6 e D un acc s un annuaire LDAP Open LDAP dans la version actuelle On se r f rera au manuel d installation cit en r f rence qui d crit compl tement l installation des pr requis en environnement Linux Sous Windows on utilisera les installeurs adapt s cet OS On suppose dans tout ce qui suit que vous disposez des pr requis cit s ci dessus et nous partirons de l hypoth se que vous disposez d un tomcat en local dans lequel vous avez d ploy cf galement manuel d installation l application AIP war Les sources java des objets utilis s par les 13 servlets principales sont regroup s dans le r pertoire S AIP_ HOME src Si vous devez en modifier au moins un enchainez les actions suivantes R f rence AIP v 1 0 Manuel Technique V1 4 doc Page 26 30 AIP v 1 0 Manuel Technique V1 4 doc Annuaire Interne 6 3 Etape 1 Cr ation du projet Eclipse Enchainez les op rations suivantes 1 Lancez Eclipse 2 Cr er un nouveau projet java file gt New gt Java Project en allant e Chercher le r pertoire AIP_ HOME comme r pertoire initial e Nommer le projet AIP CG33 e S lectionner le JDK 1 6 3 V rifier ou mettez jour dans Project gt Properties sous le chemin de compilation java que vous avez bien les l ments suivants de positionn s dans les onglets Source et Librairies On
Download Pdf Manuals
Related Search