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 :
<source lang=delphi> //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; </source>
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: