...
Paramétrage des propriétés de l'application
Le back front office se déploie en mode servlet ou portlet.
Créez src/main/resources/properties/config.properties en s'inspirant de config.sample.properties. Si vous utilisez git pour l'exploitation et la mise à jour, il est conseillé de faire :
Bloc de code |
---|
ln -s config.sample.properties src/main/resources/properties/config.properties git add src/main/resources/properties/config.properties git commit -m 'utiliser config.sample.properties comme base de configuration' |
...
Vérifier la configuration des fichiers :
...
Adresse web service back office :
Bloc de code smsuapi.ws.address=https://[Nom_De_La_Machine_Back_Office]:[Port_WebService]/smsu-api/
(attention, le "/" à la fin est important)
Paramétrage LDAP
Adresse, login, mot de passe et timeout (en millisecondes) du serveur LDAP :
Bloc de code ldap.url=ldap://localhostnomServeurLdap:389 ldap.userName=cn=sms,ou=admin,dc=univ-paris1,dc=fr ldap.password=xxx ldap.connectTimeout=5000
La base DN du serveur LDAP :
Bloc de code ldap.base=dc=univ-paris1,dc=fr
Le DN sub path pour les utilisateurs :
Bloc de code ldap.dnSubPath=ou=people
L'identifiant d'utilisateur dans le LDAP :
Bloc de code ldap.uidAttribute=uid
Le nom de l'attribut qui caractérise le nom « d'affichage de l'utilisateur » (généralement son nom et prénom concaténé dans un attribut LDAP) :
Bloc de code ldap.displayNameAttribute=displayName
Le nom de l'attribut qui contient le prénom de l'utilisateur :
Bloc de code ldap.firstNameAttribute=givenName
Le nom de l'attribut qui contient le nom de famille de l'utilisateur :
Bloc de code ldap.lastNameAttribute=sn
Le nom de l'attribut qui contient l'adresse email de l'utilisateur :
Bloc de code ldap.emailAttribute=mail
Le nom de l'attribut qui contient le numéro de téléphone portable de l'utilisateur :
Bloc de code ldap.pagerAttribute=pager
Le nom de l'attribut qui contient la liste des conditions d'utilisation qui ont été acceptées par l'utilisateur :
Bloc de code ldap.termsOfUseAttribute=up1TermsOfUse
La valeur qui préfixera les valeurs stockées dans le LDAP à l'attribut défini par ldap.termsOfUseAttribute :
Bloc de code ldap.termsOfUseAttributeEtiquetteSMSU={SMSU}
Ce préfixe à la mode SUPANN permet de partager l'attribut défini par ldap.termsOfUseAttribute avec d'autres applications. Le service SMS-U gardera inchangé les valeurs ne commençant pas par ce préfixe.
La valeur qui sera stockée dans le LDAP à l'attribut défini par ldap.termsOfUseAttribute lorsque l'utilisateur accepte les conditions générales :
Bloc de code ldap.key.cg=CG
NB : cette valeur sera préfixée de la valeur défini par ldap.termsOfUseAttributeEtiquetteSMSU
Le nom de l'attribut sur lequel sont effectuées les recherches d'utilisateurs par nom :
Bloc de code ldap.searchAttribute=cn
L'expression permettant d'effectuer des tests :
Bloc de code ldap.testFilter=cn=*aaron*
Ce paramètre défini l'expression qui sera utilisé pour tester le LDAP par le biais des taches ant livrées par esup-commons
Le nom de l'object dont se sert le serveur LDAP pour définir un utilisateur :
Bloc de code ldap.objectClass=Person
Le DN sub path permettant de caractériser les groupes :
Bloc de code ldap.group.dnSubPath=ou=groups
Le nom de l'attribut utilisé comme identifiant pour les groupes :
Bloc de code ldap.group.idAttribute=cn
Le nom de l'attribut qui contient la liste des membres d'un groupe :
Bloc de code ldap.group.groupMemberAttr=member
Le nom de l'attribut utilisé lors des recherches par nom sur les groupes :
Bloc de code ldap.group.groupSearchAttr=description
Le nom de l'attribut affiché lors des recherches par nom sur les groupes :
Bloc de code ldap.group.groupSearchDisplayedAttr=description
Le nom de l'attribut utilisé pour affiché le nom d'un groupe :
Bloc de code ldap.group.nameAttr=description
NB : supprimé dans esup-smsu 1.1.2
Le nom de l'object dont se sert le serveur LDAP pour définir un groupe :
Bloc de code ldap.group.groupObjectClass=groupOfNames
L'expression permettant d'effectuer des tests sur les groupes :
Bloc de code ldap.group.testFilter=cn=*mati*
Ce paramètre défini l'expression qui sera utilisé pour tester le LDAP par le biais des taches ant livrées par esup-commons
Paramétrage adhésion
Expression régulière Activation/Désactivation de la validation de la forme par SMS du numéro de téléphone d'un adhérent :
Bloc de code adhesion.phoneNumberPattern=(06|07)[0-9]{8}
(10 chiffres commençant par 06)
Ce paramètre peut être vidé (pas de vérification du tout)Activation/Désactivation de la validation par SMS du numéro de téléphone d'un adhérent :
Bloc de code adhesion.activateValidation=false
activateValidation=false
Nombre maximum utilisé dans la Nombre maximum utilisé dans la génération des codes de validation :
Bloc de code adhesion.maxNumberCodeValidation=100000
Compte d'imputation des messages de validation :
Bloc de code adhesion.accountValidation=[compte_de_validation]
Rôle associé au compte de validation (non utilisé, présent pour la cohérence des données en base :
Bloc de code adhesion.roleValidation=[role_compte_validation]
Titre du SMS de validation (corps du message envoyé) :
Bloc de code adhesion.titleSmsValidation=[Titre_SMS_valdidation]
Paramétrage destinataires
Expression régulière de validation de la forme du Liste des champs LDAP pouvant contenir une valeur par défaut de numéro de téléphone d'un adhérent :
Bloc de code adhesionrecipient.phoneNumberAttributes=homePhone,mobile
Les champs sont séparés par une virgule.
préfixe de numéro de téléphone à retirer :
Bloc de code adhesion.phoneNumberPrefixToRemove=\\+33
Ce préfixe sera remplacé par un zéro.
Paramétrage destinataires
Expression régulière de validation de la forme du numéro de téléphone d'un adhérent :
Bloc de code recipient.phoneNumberPattern=(06|07)[0-9]{8phoneNumberPattern=0[67]\\d{8}|\\+33\\s[6|7](\\s\\d\\d){4}
(10 chiffres commençant par 06.
Ce paramètre peut être vidé (pas de vérification du tout)
...
URL serveur CAS :
Bloc de code cas.url=https://[Nom_De_La_Machine_Cas]:[Port_Cas]/cas
nom de la machine et port pour accéder au front-office :
Bloc de code tomcatserver.hosturl=localhost tomcat.port.string=http://localhost:8080
Paramétrage SMTP
L'adresse du serveur SMTP à utiliser :
Bloc de code smtp.host=an.smtp.host
Ce paramètre défini l'adresse du serveur SMTP qui sera utilisé par le front office pour envoyer les emails
Le port du serveur SMTP à utiliser :
Bloc de code smtp.port=25
Ce paramètre défini le port du serveur SMTP qui sera utilisé par le front office pour envoyer les emails
Le login a utiliser pour s'authentifier auprès du serveur SMTP :
Bloc de code smtp.user=
Ce paramètre défini le login a utiliser pour s'authentifier auprès du serveur SMTP qui sera utilisé par le front office pour envoyer les emails
Le mot de passe a utiliser pour s'authentifier auprès du serveur SMTP :
Bloc de code smtp.password=
Ce paramètre défini le mot de passe a utiliser pour s'authentifier auprès du serveur SMTP qui sera utilisé par le front office pour envoyer les emails
L'adresse email qui sera utilisée pour envoyer les emails:
Bloc de code smtp.fromEmail=example@domain.org
Ce paramètre défini l'adresse email qui sera utiliser pour envoyer les emails
Le nom qui apparaitra dans les emails :
Bloc de code smtp.fromName=Name firstName
Ce paramètre défini le nom qui apparaitra comme expéditeur des emails envoyés par le front office.
...
Il faut remplacer la valeur "default account" par le nom du compte par défaut (défini dans le fichier de configuration config.properties par la clef smssmsuapi.defaultAccount
Bloc de code |
---|
INSERT INTO customized_group VALUES (1, 1, 1, "admin", 1, 1, 1); |
...
Bloc de code |
---|
mysql -u root -p smsu < src/main/resources/database/populate_tables_esup-smsu.sql |
...
Bloc de code |
---|
+--------------------------+ | Tables_in_smsu | +--------------------------+ | QRTZ_BLOB_TRIGGERS | | QRTZ_CALENDARS | | QRTZ_CRON_TRIGGERS | | QRTZ_FIRED_TRIGGERS | | QRTZ_JOB_DETAILS | | QRTZ_JOB_LISTENERS | | QRTZ_LOCKS | | QRTZ_PAUSED_TRIGGER_GRPS | | QRTZ_SCHEDULER_STATE | | QRTZ_SIMPLE_TRIGGERS | | QRTZ_TRIGGERS | | QRTZ_TRIGGER_LISTENERS | | account | | b_vers_mana | | basic_group | | customized_group | | fonction | | mail | | mail_recipient | | message | | pending_member | | person | | recipient | | role | | role_composition | | service | | supervisor | | supervisor_sender | | template | | to_mail_recipient | | to_recipient | +--------------------------+ |
...
Soit lancement simple avec jetty
Bloc de code |
---|
mvn jetty:run # ou ant jetty.run |
...
Soit déploiement de l'application
Bloc de code |
---|
mvn package |
puis copiez le war dans webapps (servlet) ou utilisez de commande uPortal "ant deployPortletApp".
ou si vous préférez vous pouvez utiliser ant en configurant préalablement le chemin de déploiement dans build.properties
...
(le contexte peut aussi être configuré dans le fichier tomcat conf/server.xml)
...
Configuration de la
...
langue des mails de modération
Les mails de modération sont traduits, mais la langue utilisée dépend de la locale système. Pour avoir ces messages en français, il faut s'assurer de lancer tomcat/jetty avec la locale système configurée, par exemple en mettant LANG=fr_FR.UTF-8 .
La portlet du front office se déploie par le biais du gestionnaire de canaux.
La configuration utilisée est la suivante :