Managing the emails with the POP3/SMTP protocols

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Communication / Managing emails

Overview of POP3/SMTP protocols
The POP3 and SMTP protocols
Principle
Sending messages by using the SMTP protocol
Receiving messages by using the POP3 protocol
Principle and specific features in WINDEV
Principle and specific features in WEBDEV
Remarks
Connection to the service provider

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Managing the emails with the POP3/SMTP protocols

Overview of POP3/SMTP protocols

The POP3 and SMTP protocols

The POP3 protocol (Post Office Protocol) is used to receive emails.
The SMTP protocol (Simple Mail Transfer Protocol) is used to send emails.

Remarks:

The reception of emails can also be taken into account by using the IMAP protocol.
The SSL connections are supported.

Principle

Sending messages by using the SMTP protocol

To send messages by using the SMTP protocol, you must:

Start an SMTP session:
- by using an emailSMTPSession variable and EmailStartSession.
- by using EmailStartSMTPSession.
Build the message to be sent in a variable of type Email or in the Email structure.
Send the message with EmailSendMessage.
Close the SMTP session with EmailCloseSession.

Receiving messages by using the POP3 protocol

To receive emails by using the POP3 protocol, you must:

Start a POP3 session:

by using an emailPOP3Session variable and EmailStartSession.
by using EmailStartPOP3Session.

Example for starting a session by using an emailPOP3Session variable:

// Ouverture de la session de messagerie
MaSession is emailPOP3Session
MaSession.ServerAddress = "pop.masociete.fr"
MaSession.Name = "utilisateur"
MaSession.Password = "secret"
EmailStartSession(MaSession)

Read the messages on the messaging server:

with the EmailGetAll function.

with a loop such as:

Example that uses an Email variable:

MonMessage is Email
EmailReadFirst(MaSession, MonMessage)
WHILE NOT MonMessage.Out
	// Placer ici le traitement du message lu...
	...
	EmailReadNext(MaSession, MonMessage)
END

Example that uses the Email structure:

EmailReadFirst(MaSession)
WHILE NOT Email.Out
	// Placer ici le traitement du message lu...
	...
	EmailReadNext(MaSession)
END

or with a loop such as:

MonMessage is Email
FOR EACH MonMessage OF MaSession
	// Placer ici le traitement du message lu...
	...
END

Close the POP3 session with EmailCloseSession.

Remark: It's possible to open a POP3 session and an SMTP session simultaneously using the EmailStartSession function.

Principle and specific features in WINDEV

Note: It may be necessary to establish a modem connection before opening the SMTP or POP3 session.

Principle and specific features in WEBDEV

Sending and receiving emails in a WEBDEV website

In a WEBDEV website, the emails are sent and received by the Application Server.

The sending can be performed by a local spooler in order not to slow down a WEBDEV website if the SMTP server takes time to respond. This function is handled automatically by the WEBDEV Application Server.

Remarks

Connection to the service provider

An Internet connection is required to manage the emails. Several cases may occur:

The user uses a modem to connect to the Internet: the NetOpenRemoteAccess function opens the Internet connection.
The user uses a direct connection to Internet (cable or ADSL): no specific operation required.

Note To limit connection time:

When reading the emails, we advise you to read all the incoming emails and to save them in an HFSQL database for example.
When sending the emails, we advise you to prepare the emails beforehand.

Related Examples:

Unit examples (WINDEV): The POP3 Email functions

[ + ] Using the Email functions to manage the POP3 protocol.
This protocol is used to retrieve emails from a server.