Sommaire |
---|
Service SMS-U |
|
| Université de Paris 1 |
|
|
| Manuel d'installation de l'api mail |
...
Installation de l'api mail du service SMS-U
L'application de api mail packagée se trouve dans le dossier /dist du projet.
Dézippez le contenue de la distribution la plus récente de esup-smsuapimail dans un répertoire de travail.
Le paramétrage suivant est à effectuer dans le dossier ainsi créé.
...
Déploiement de l'application api-mail
Le api-mail se déploie en mode servlet.
Il faut tout d'abord vérifier la configuration des fichiers suivant fichiers suivant :
- properties/config.properties properties
- le paramétrage général de l'application.
- build.properties
- le mode quick start doit être activé
- properties/logging/log4j.properties
- Vérifier le chemin d'accès du fichier de log
...
...
Lancement de l'application
L'application se lance par la tache ant start start :
Bloc de code |
---|
ant |
...
start
|
Paramétrage de l'api mail du service SMS-U
Un fichier de propriété permet aux exploitants de paramétrer l'api mail du service SMS-U.
Voici la liste des paramètres disponibles disponibles :
- Le nom du compte d'imputation par défaut qui sera utilisé par le service mail mail :
Ce paramètre défini le compte d'imputation qui sera utilisé pour envoyer des SMS lorsque l'email reçu ne spécifie pas de compte d'imputation.Bloc de code smsuapimail.account.label=
- La taille maximale d'un message message :
Ce paramètre défini la taille maximale (en nombre de caractères) que peut faire le message avant que celui ci ne soit tronqué.Bloc de code smsuapimail.message.maxLength=160
- L'adresse du serveur pop pop :
Ce paramètre défini l'adresse du serveur pop où se trouve la boite email à scruter.Bloc de code smsuapimail.pop.serverAddress=pop.example.fr
- Le login de la boite email sur le serveur pop pop :
Ce paramètre défini le login à utiliser pour se connecter au serveur pop où se trouve la boite email à scruter.Bloc de code smsuapimail.pop.serverLogin=aLogin
- Le mot de passe de la boite email sur le serveur pop pop :
Ce paramètre défini le mot de passer à utiliser pour se connecter au serveur pop où se trouve la boite email à scruter.Bloc de code smsuapimail.pop.serverPassword=aPassword
- Le nom du répertoire où se trouve les emails emails :
Ce paramètre défini le nom du dossier dans lequel sont déposés les emails à traiter.Bloc de code smsuapimail.pop.folderName=INBOX
- La balise qui est attendue dans les emails pour définir les destinataires destinataires :
Ce paramètre défini la balise qui doit se trouver dans les emails reçus et qui définie les destinataires.Bloc de code smsuapimail.pop.recipientsTag=destinataires
- La balise qui est attendue dans les emails pour définir le compte d'imputation:
Ce paramètre défini la balise qui doit se trouver dans les emails reçus et qui définie le compte d'imputation.Bloc de code smsuapimail.pop.accountTag=compte
- La balise qui est attendue dans les emails pour définir le message message :
Ce paramètre défini la balise qui doit se trouver dans les emails reçus et qui définie le message.Bloc de code smsuapimail.pop.contentTag=message
- Le pattern définissant un numéro de téléphone valide valide :
...
Bloc de code smsuapimail.pop.phoneNumerPattern
...
=06
...
[0-9
...
]
...
{8
...
Ce}
...
- paramètre
...
- défini
...
- le
...
- pattern
...
- qui
...
- est
...
- utilisé
...
- pour
...
- définir
...
- ce
...
- qu'est
...
- un
...
- numéro
...
- de
...
- téléphone
...
- valide.
- L'encodage de caractère utiliser dans les emails emails :
Ce paramètre défini l'encodage utilisé dans les emails reçus.Bloc de code smsuapimail.pop.mailCharset=UTF-8
- L'adresse du web service du back office office :
Bloc de code smsuapimail.ws.backOfficeAddress=https://host.domain.fr:8081/xfire
...
Ce paramètre défini l'adresse du web service du back office.- .La localisation du truststore truststore :
Ce paramètre défini la localisation du trustStore de l'application.Bloc de code smsuapimail.ws.trustStore=/an/example/trustStore.jks
- Le mot de passe du truststore truststore :
Ce paramètre défini le mot de passe du trustStore.Bloc de code smsuapimail.ws.trustStorePassword=password
- La localisation du keyStore keyStore :
Ce Ce paramètre défini la localisation du keyStore de l'application.Bloc de code smsuapimail.ws.keyStore=/an/example/keyStore.jks
- Le mot de passe du keyStore keyStore :
Ce paramètre défini le mot de passe du keyStoreBloc de code smsuapimail.ws.keyStorePassword=password
- Fichier de sauvegarde de l'identifiant message message :
...
Bloc de code smsuapimail.ws.messageIdFileName
...
=
...
[Chemin_Accès
...
Ce]/properties/messageId.txt
...
- fichier
...
- conserve
...
- le
...
- dernier
...
- identifiant
...
- d'envoi
...
- de
...
- message
...
- envoyé
...
- en
...
- back
...
- office.
...
- Il
...
- permet
...
- de
...
- regrouper
...
- les
...
- SMS
...
- provenant
...
- un
...
- même
...
- mail.
...
- L'identifiant d'expéditeur envoyé au back office office :
Ce paramètre défini l'identifiant d'expéditeur transmis au back office (ce paramètre peut rester vide)Bloc de code smsuapimail.ws.senderId=
- L'identifiant de groupe d'expéditeur envoyé au back office office :
Ce paramètre défini l'identifiant du groupe de l'expéditeur transmis au back office (ce paramètre peut rester vide)Bloc de code smsuapimail.ws.groupSenderId=
- L'identifiant du service envoyé au back office office :
Ce paramètre défini l'identifiant du service transmis au back office (ce paramètre peut rester vide)Bloc de code smsuapimail.ws.serviceId=
- La fréquence d'exécution de la tache mail vers SMS SMS :
Ce paramètre défini l'expression cron qui définie la fréquence de polling de la boite email et du processus d'envoi.Bloc de code smsuapimailquartz.mailToSmsTrigger.cronExpression= 0 0/10 * * * ?
- La fréquence d'exécution de la tache mail vers SMS SMS :
Ce paramètre défini la localisation du fichier de configuration de Quartz.Bloc de code smsuapimail.quartz.configFileLocation=/example/smsuapimail_quartz.properties