« POP3 (Gestionnaire de message) » : différence entre les versions

Dernière version du 18 janvier 2018 à 14:38

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:

Protocole POP3

@@ Ligne 1 : / Ligne 1 : @@
-Ce type de gestionnaire permet d'utiliser un serveur de messagerie POP3 comme une file d'attente.
+Ce type de gestionnaire permet d'utiliser un couple de serveurs de messagerie POP3/SMTP comme une file d'attente.
-{{tip|Seule la partie consommation de message utilise le protocole POP3, la partir production de message utilise SMTP}}
+* Consommer un message revient à lire une boite à lettres (POP3).
+* Produire un message revient à envoyer un mail (SMTP).
-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).
+===Paramétrage de la file d'attente===
-'''Paramétrage de [[TdbmQueue]]:'''
 {|class="wikitable"
@@ Ligne 26 : / Ligne 24 : @@
   pop3://serveur?mailbox=xxx&password=zzzz
-{{tip|msgID est l'identifiant du message dans la session POP3, du faite que la connexion est ouverte et fermée à chaque interrogation de la file le numéro du message est toujours 1.}}
+{{tip|pour utiliser tls le protocole est pop3s}}
-'''Messages:'''
+'''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 :
-Ces attributs du message sont copiés en paramètre :
+<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"
@@ Ligne 38 : / Ligne 137 : @@
 |-
 |UniqueID
-|msgId
+|Message ID
 |-
 |MessageOID
-|msgId
+|Message ID
 |-
 |MessageID
-|msgId
+|Message ID
 |-
 |Topic
-|Sujet
+|Sujet du mail
 |-
 |Paramètres
-|Paramètres du message
+|Autres attributs du message
 |}
-'''Paramètres:'''
+* 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}}
@@ Ligne 61 : / Ligne 166 : @@
 [[Category:File d'attente]]
+[[Category:Gestionnaire de file d'attente]]