POP3 (Gestionnaire de message)

Ce type de gestionnaire permet d'utiliser un couple de serveurs de messagerie POP3/SMTP comme une file d'attente.

• Consommer un message revient à lire une boite à lettres (POP3).
• Produire un message revient à envoyer un mail (SMTP).

Paramétrage de la file d'attente

Propriété	Valeur
QueueConnectionInfos	URL de définition du service POP3 (voir plus bas)
QueueTopic	Nom de boîte mail si non renseigné dans QueueConnectionInfos.

La chaine QueueConnectionInfos peut utiliser les formats suivant :

pop3://mailbox:password@serveur
pop3://serveur/mailbox&?password=xxx
pop3://serveur?mailbox=xxx&password=zzzz

Tip : pour utiliser tls le protocole est pop3s

Paramètres de l'url

Ces paramètres peuvent être ajoutés à l'URL définissant la file d'attente pour paramétrer le comportement de la file.

Nom	Sens	Usage	Défaut
sndMailToField	production	Nom du paramètre du message contenant l'adresse email de destination du message	MailTo,msgMailTo
snfFromField	production	Nom du paramètre du message contenant l'adresse d'émetteur du message	From,msgFrom
sndSubjectField	production	Nom du paramètre du message contenant le sujet associé au message	Subject,msgSubject
sndContentField	production	Nom du paramètre du message contenant le contenu associé au message	Content,msgcontent
sndReferenceField	production	Nom du paramètre du message contenant la référence associé au message	Reference,msgReference
sndAttachementName	production	Nom du paramètre du message contenant le nom de la pièce jointe au message	AttachementName,msgAttachementName
sndAttachementContentType	production	Nom du paramètre du message contenant le type de contenu (MIME) de la pièce jointe au message	AttachementContentType,msgAttachementContentType

Messages produits

Ce type de file utilise le protocole SMTP pour produire les messages.

Réaliser une opération InQueue sur une file de type POP3 revient à envoyer un mail.

Tip : Le serveur SMTP est celui paramétré dans la console d'administration

• Destinataire

L'adresse de destination est définie par le paramètre MailTo. Si cette valeur est nulle et que le Topic de la queue (TdbmQueue) contient une adresse email valide celle-ci est utilisée. Si la valeur est nulle le mail n'est pas envoyé.

Expéditeur

L'adresse d'expéditeur est définie par le paramètre From.

• Sujet

Le sujet du mail est défini par le paramètre Sujet.

• Contenu

Le contenu du mail est défini par le paramètre Content.

• Pièce jointe

Si le message (TdbmQueueMessage) contient un contenu binaire (BinaryContent) celui est transmis en pièce jointe au mail. Le nom et le type de contenu sont définis respectivement par AttachementName et AttachementContentType.

Tip : Une seule pièce jointe est gérable

Tip : Les nom des paramètres peuvent être substitués par le paramétrage de l'url, voir ci-dessus

Exemple :

//Procedure TestQueueMessage;
var msg:TdbmQueueMessage; idx:Integer;
begin
  for idx:=1 to 1 do
   begin
     msg := TdbmQueueMessage.Create;
     msg.QueueName := 'QUEUEPOP3';
     msg.AddParameter('Subject','le sujet du message');
     msg.AddParameter('Content','le text du message');
     msg.AddParameter('AttachementName','image.jpg');
     msg.AddParameter('AttachementContentType','image/jpeg');
     msg.BinaryContent.LoadFromFile('c:\image.jpg');
     msg.Post;
   end;
end;

Messages consommés

Ce type de file utilise un serveur POP3 pour consommer les messages.

Réaliser une opération DeQueue sur une file de type POP3 revient à lire une boite à lettre par le protocole POP3.

Du fait du principe de fonctionnement d'un serveur POP3 les messages sont automatiquement acquittés (c'est à dire consommés).

Le mail consommé est traduit en message (TdbmQueueMessage), les attributs du mail sont copiés en paramètre du message.

Propriété	Valeur
UniqueID	Message ID
MessageOID	Message ID
MessageID	Message ID
Topic	Sujet du mail
Paramètres	Autres attributs du message

• Message ID

Le message ID est retrouvé de l'entête du message, champ Message-ID. Si cette information n'est pas retrouvé le message UIDL est utilisé.

• Contenu binaire

Le contenu binaire du message est alimenté par la première pièce jointe du mail.

Autre Paramètres

Nom	Usage
From
FromName
FromAddress
FromUser
Recipients
Cc
Subject
Date
Receipt
Organization
Priority
Reply
ReplyName
ReplyAddress
ReplyDomain
ReplyUser
ReplyTo
Content
AttachmentCount
AttachmentName#
AttachmentContentType#

Voir aussi:

• Protocole POP3