M -1.0-

 

Module : PostCard V1.0

Category / Domain :

CommTools

Scol Engine Compatibility :

V3.2d and higher

Operating Systems :

Windows 95/98

 

Windows NT 4.0

Documentation dated :

06/07/2000

Supersedes sheet :

 

Module Description

 PostCard allows a user to send a postcard, by email. The cards are sent to a server (a PostCardServer module), and then, are mailed to the addressee.

To work correctly, a PostCardServer must be opened somewhere, and you have to know its IP and communication port.

Editor Description

·         PostCardServer IP : PostCardServer’s IP address.

The PostCard module has to send the cards to a PostCardServer, in order to mail the cards.

·        PostCardServer port : the communication port of PostCardServer..

·        Models List : click on the « add » button to put a model downto the list. Click on « remove » button to remove a selected model from the list. The models a generally stored in “/Dms/CommTools/PostCard/Models”

·        Mail : this text will be added to the mail that PostCardServer will send.

Actions and Events

Actions

·         start : start the PostCard client

·        choose : show the graphic user interface, in order to send a postcard

·        edit : show the editor module.

 

Events

 

Zones

 choose : graphic user interface (client)

 

Graphic client Interface

·        email :                        adressee’s email

·        liste des modèles :     list of models that the module’s editor allow the client to use.

·        bouton preview :        click on « preview » to preview the model in a HTML browser

·        message personnel : message that the user want to add to the postcard.

·        bouton send :             click on «send » to send the postcard

·        bouton reset :             reset all the text fields.

·        bouton cancel :           close the graphic interface

The « server connex. » state flag is « OK » if the card has been correctly send to the PostCardServer button. It writes “ERROR” if not (wrong ip, or wrong port, or server down, for example…)

The « mail send » state flag takes the value from the Mail module event. The Mail module returns an event, after having send a mail, to tell you if it has been done correctly. Be aware that it does’nt tell you that your correspondent has received your card. It’s just about the connexion to the mails server.

 

Réalisation des modèles de cartes postales

PostCard models are HTML files. They have to contain 3 specific flags :

·        < !--POSTCARD_MODEL TITLE--> : title of the model. This title must be written in a HTML comment, on the line below.

·        < !--POSTCARD_MODEL DESCR--> : description of the model. It must be written in a HTML comment, on the line below.

·        < !--POSTCARD_MODEL MESSAGEBODY--> : tells PostCardServer to insert the message that the user want to add to the card.

 

·        Basic example :

<html>

 

<!--POSTCARD_MODEL TITLE-->                 è title flag

<!--TestModel01-->

 

< ! --POSTCARD_MODEL DESCR-->             è description flag

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

 

<H1>POSTCARD MODEL 01</H1>                 è content of the model

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

 

<!--POSTCARD_MODEL MESSAGEBODY--> è flag to insert the user message

 

</html>

 

·        Images must be inserted by a <img> HTML tag. The « src » attribute precises the image filename. That filename must be written in quotes, in order to be correctly parsed. Actually, all the images are send to PostCardServer, with the model of the card.