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.

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.

Versions 17 and later

This feature is now available for iPhone/iPad applications.

New in version 17

This feature is now available for iPhone/iPad applications.

Versions 21 and later

This feature is now available in Universal Windows 10 App mode.

New in version 21

This feature is now available in Universal Windows 10 App mode.

Versions 22 and later

This feature is now available in Android Widget mode.

This feature is now available for Android applications.

New in version 22

This feature is now available in Android Widget mode.

This feature is now available for Android applications.

This feature is now available in Android Widget mode.

This feature is now available for Android applications.

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 send in an Email variable variable 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 is using 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 is using 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: A POP3 session and an SMTP session can be simultaneously started by EmailStartSession.

Principle and specific features in WINDEV

Remark: You may have to establish a connection by modem before starting the SMTP or POP3 session.

Principle and specific features in WEBDEV

Sending and receiving emails in a WEBDEV site

In a WEBDEV site, 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 site if the SMTP server takes time to respond. This function is automatically managed by 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 Internet: NetOpenRemoteAccess is used to establish the connection to Internet.
The user uses a direct connection to Internet (cable or ADSL): no specific operation is required.

Remark: To limit the connection time:

When reading the emails, we advise you to read all the incoming emails and to save them in a 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.