Groupe 2 (communication)
Date de création :	23 septembre 2004
Dernière modification :
Diffusion :	internet

Canal Mailto

L'installation

Les librairies utilisées

Aucun librairie non incluse de base dans la distribution esup-portail n'est utilisée.

Mise en place du canal

Préparation du fichier de configuration Mail.properties

Vous pouvez spécifier aussi le nom des champs du formulaire du mail. Ces noms doivent être en adéquation avec ceux précisés dans le CMailTo.xsl.

#Nom des champs du formulaire
nameOfFieldFrom=fromField
nameOfFieldTo=toField
nameOfFieldCc=ccField
nameOfFieldBcc=bccField
nameOfFieldSubject=subjectField
nameOfFieldContent=bodyField
nameOfFieldSmtp=smtpField

Entrez maintenant l'expression régulière qui permet de valider une adresse mail saisie. Au niveau de l'envoi, le canal vérifie l'expression formatMail+"(( )?,( )?"+formatMail+")*", autrement dit, dans les champs destinaires et expéditeurs il est possible d'entrer une liste de mails valides, séparés par des virgules.

#Expression régulière d'un mail
formatMail=\\w[_\\-\\.\\w]*\\@\\w[_\\-\\.\\w]*\\.(\\w){2,3}

Spécification version 2 : Entrez l'adresse du serveur smtp qui sera utilisé par défaut pour l'envoie de mail. Cette valeur peut être modifier par le canal "maître" le cas échéan.

#SMTP par défaut
smtp=mail.univ-nancy2.Fr

Préparation du fichier de configuration build.properties

Précisez les chemins de déploiement :

#Répertoire d'installation de Tomcat
  tomcat.home = C:/esupdev/esupdev-2.3/uPortal_2-3-4-quick-start/Tomcat_5-0-18
#Répertoire d'installation d'uPortal
  uportal.home = C:/esupdev/esupdev-2.3/uPortal_2-3-4-quick-start/uPortal_rel-2-3-4
#Répertoire de déploiement
  deploy.home = C:/esupdev/esupdev-2.3/uPortal_2-3-4-quick-start/webapps/uPortal

Faites ensuite ant.deploy.

Le canal "maître" peut positionner les champs du formulaire d'envoi. Ces paramètres doivent être positionnés dans les "RuntimeData". Un attribut du mail peut avoir 3 caractéristiques :

1 => sa valeur
2 => si l'utilisateur peut modifier cette valeur
3 => si l'utilisateur peut voir cette valeur

Un attribut est donc un tableau de 3 chaînes de caractères. Par exemple, pour forcer le destinataire d'un mail, vous devez écrire le canal maître :

String[] att = new String[3];
   //destinataire
   att[0] = "sgaudin@univ-nancy2.fr";
   att[1] = "false";
   att[2] = "true";
   runtimeData.setParameterValues(Mail.TO,att);

Pour faire afficher la case "Recevoir une copie", il faut passer dans les staticData le paramètre "allowCopyBox" avec la valeur "true".

Particularités du canal Mailto

Algo de recherche d'un attribut

1 - Dans un premier temps, les attributs du mails sont créés automatiquement. Chaque attribut n'a pas de valeur, est modifiable et est visible.
Exception pour le serveur smtp qui lui a la valeur remplie dans le fichier de configuration, n'est pas modifiable et n'est pas visible.

2 - On remplace les spécificités de chaque attributs définis par le canal "maître". C'est-à-dire que pour chaque attribut, vous pouvez, selon le cas, rendre un attribut visible, modifiable ou lui forcer une valeur.

3 - La saisie utilisateur va mettre à jour la valeur de chaque attribut modifiable.

Définition automatique du champs "from"

Si vous n'êtes pas connecté en tant qu'"invité", le champ expéditeur est valué automatiquement avec l'adresse mail de l'utilisateur connecté et n'est pas modifiable.

Création : 23 septembre 2004 - Sébastien GAUDIN (N2)
Modifications :