M -1.0-

 

Module : PostCard V1.0

Catégorie / Domaine :

CommTools

Compatibilité Scol Engine :

V3.2d et supérieure

Systèmes d'exploitation :

Windows 95/98

 

Windows NT 4.0

Documentation datée du :

06/07/2000

Remplace fiche :

 

Description du module

PostCard est module client permettant d’envoyer des cartes postales via un courrier électronique. 

Les cartes seront envoyées à un module serveur PostCardServer, via une connexion scol, qui se chargera d’enregistrer la carte postale et d’envoyer un mail au destinataire de la carte postale.

 

Description de l'éditeur

·        IP du serveur PostCardServer : adresse IP du module serveur PostCardServer.

Le module PostCard doit transmettre la carte postale élaborée par l’utilisateur à un serveur PostCardServer. Cette transmission est réalisée en interne par une liaison de communication de type scol.

·        Port du serveur PostCardServer : port sur lequel le serveur PostCardServer est ouvert

·        Liste des modèles : cliquer sur « add » pour ajouter un modèle, et « del » pour supprimer un modèle sélectionné dans la liste

·        Mail : texte à ajouter dans le mail qui sera envoyé aux destinataires des cartes postales

 

Actions et évènements

Actions

·        start : démarre le client PostCard

·        choose : affiche l’interface graphique cliente pour envoyer une carte postale

·        edit : affiche l’éditeur de PostCard

 

Evènements

 

Zones

·        choose : interface graphique cliente

 

Interface graphique cliente

·        email :                        adresse email du destinataire de la carte postale

·        liste des modèles :     liste des modèles que l’éditeur du module a mis à disposition du client

·        bouton preview :        cliquer sur preview pour prévisualiser le modèle sélectionné dans la liste, dans un browser html

·        message personnel : message que l’expéditeur de la carte veut intégrer dans sa carte postale

·        bouton send :             cliquer sur send pour expédier la carte postale au module PostCardServer

·        bouton reset :             vide les champs de l’adresse email, du modèle sélectionné et du message personnel

·        bouton cancel :           ferme l’interface graphique cliente

Le flag d’état « connex. Serveur »  s’active lors de l’envoi d’une carte postale. Il affiche « OK » si la transmission de la carte au module PostCardServer s’est bien passée, « ERROR » dans le cas contraire (serveur PostCardServer injoignable par exemple…).

Le flag d’état « envoi mail » s’active en fonction du retour du mail. Le module serveur PostCardServer est lié au module Mail, à qui il transmet le courrier électronique que le destinataire de la carte postale recevra.  Le Module Mail renvoie un événement  permettant de statuer la communication du mail au serveur de mail. Cet événement est récupéré par PostCardServer (si les liaisons ont été correctement faites) et le renvoie au client PostCard qui a expédié la carte postale.

!! Le flag d’état « envoi mail » n’est en aucun cas la confirmation de la bonne ou mauvaise réception du mail par votre destinataire. A l’heure actuelle, le module Mail ne récupère pas cet information depuis le serveur de mail. Ce flag n’est donc que la confirmation de la transmission de la carte au serveur de mail, mais pas au destinataire (donc, faire attention à l’adresse email à qui l’on communique la carte postale).

 

Réalisation des modèles de cartes postales

Les modèles de cartes postales sont des fichiers au format et à la norme HTML. Il doivent cependant contenir 3 flags propres à la syntaxe PostCard, sous forme de commentaires HTML :

·        < !--POSTCARD_MODEL TITLE--> : indique le titre (le nom) du modèle. Le titre du modèle doit être écrit au sein d’un commentaire HTML, à la ligne suivante

·        < !--POSTCARD_MODEL DESCR--> : indique le texte descriptif du modèle. On peut ainsi accompagner chaque modèle d’une description spécifique. La description doit être entrée dans un commentaire HTML, à la ligne suivante.

·        < !--POSTCARD_MODEL MESSAGEBODY--> : la position de ce flag indiquera à PostCardServer à quell endroit il devra insérer le message personnel de l’utilisateur, au sein de la carte postale. Le message personnel sera inséré à la ligne du dessous.

 

·        Exemple de modèle basique :

<html>

 

<!--POSTCARD_MODEL TITLE-->                 è flag du titre du modèle

<!--TestModel01-->

 

< !--POSTCARD_MODEL DESCR-->              è flag de description du modèle

< !--voici la description du modeltest 01-->

 

<H1>POSTCARD MODEL 01</H1>                 è contenu du modèle

<img src=’img1.jpg’></BR>

 

<!--POSTCARD_MODEL MESSAGEBODY--> è flag d’insertion du message personnel

 

</html>

 

·        Si on intègre des images dans le modèle, il les intégrer par le biais du tag <img>, l’attribut « src » indiquant le fichier source de l’image. Le chemin du fichier source doit être un chemin relatif, entré entre côtes ou guillemets. PostCard accepte les fichiers bmp, jpg, gif et png. Le chemin relatif et les côtes sont une condition nécessaire au bon fonctionnement de PostCard : celui-ci parse le fichier html du modèle pour récupérer les noms des fichiers images, afin de les transmettre, si besoin est, au module PostCardServer, en même temps que le fichier de modèle.