Voir la source de 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===

{|class="wikitable"
|-
!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.

{|class="wikitable"
|-
!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 ([http://fr.wikipedia.org/wiki/Type_MIME MIME]) de la pièce jointe au message
|AttachementContentType,msgAttachementContentType
|}

[[image:dbmqueue_pop3.png]]

===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 [http://fr.wikipedia.org/wiki/Post_Office_Protocol 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.

{|class="wikitable"
|-
!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'''

{{:Paramètres de message POP3}}

'''Voir aussi:'''
* [http://fr.wikipedia.org/wiki/Post_Office_Protocol Protocole POP3]

[[Category:File d'attente]]
[[Category:Gestionnaire de file d'attente]]