POP3 (Gestionnaire de message)
De Wiki1000
(Différences entre les versions)
(→Messages produits) |
|||
| (5 révisions intermédiaires par 2 utilisateurs sont masquées) | |||
| Ligne 23 : | Ligne 23 : | ||
pop3://serveur/mailbox&?password=xxx | pop3://serveur/mailbox&?password=xxx | ||
pop3://serveur?mailbox=xxx&password=zzzz | pop3://serveur?mailbox=xxx&password=zzzz | ||
| + | |||
| + | {{tip|pour utiliser tls le protocole est pop3s}} | ||
'''Paramètres de l'url''' | '''Paramètres de l'url''' | ||
| Ligne 70 : | Ligne 72 : | ||
|AttachementContentType,msgAttachementContentType | |AttachementContentType,msgAttachementContentType | ||
|} | |} | ||
| + | |||
| + | [[image:dbmqueue_pop3.png]] | ||
===Messages produits=== | ===Messages produits=== | ||
| Ligne 94 : | Ligne 98 : | ||
: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''. | :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|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=== | ===Messages consommés=== | ||
| Ligne 101 : | Ligne 125 : | ||
Ce type de file utilise un serveur POP3 pour consommer les messages. | 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. | + | 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). | 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). | ||
| Ligne 130 : | Ligne 154 : | ||
* Message ID | * 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é. | :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''' | '''Autre Paramètres''' | ||
| Ligne 139 : | Ligne 166 : | ||
[[Category:File d'attente]] | [[Category:File d'attente]] | ||
| + | [[Category:Gestionnaire de file d'attente]] | ||
Version actuelle en date du 18 janvier 2018 à 15: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 :
//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:
