ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Communication / Managing emails
  • Overview of IMAP protocol
  • Using the IMAP protocol
  • Receiving messages by using the IMAP protocol
  • Specific features in WINDEV
  • Specific features in WEBDEV
  • Remarks
  • Connection to the service provider
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Overview of IMAP protocol
The IMAP protocol is a standard protocol for managing emails. Unlike the POP3 protocol, the principle for using the IMAP protocol consists in leaving the messages on the messaging server in order to read them from several clients. It includes a specified indicator used to find out whether a message was read. Several messaging servers support both the IMAP protocol and the POP3 protocol.
Remarks:
Using the IMAP protocol

Receiving messages by using the IMAP protocol

To receive emails by using the IMAP protocol
  1. Start an IMAP session by using an emailIMAPSession variable and EmailStartSession.
    Example for starting a session by using an emailIMAPSession variable:
    // Start the messaging session
    MySession is emailIMAPSession
    MySession.ServerAddress = "pop.mycompany.us"
    MySession.Name = "user"
    MySession.Password = "secret"
    EmailStartSession(MySession)
  2. Read the messages on the messaging server:
    • with the EmailGetAll function.
    • with a loop such as:
      Example that uses an Email variable:
      MyMessage is Email
      EmailReadFirst(MySession,MyMessage)
      WHILE NOT MyMessage.Out
      // Place the process of the message read...
      ...
      EmailReadNext(MySession, MyMessage)
      END

      Example that uses the Email structure:
      EmailReadFirst(MySession)
      WHILE NOT Email.Out
      // Place the process of the message read...
      ...
      EmailReadNext(MySession)
      END
    • or with a loop such as (the "NOT READ" keywords are optional and they allow you to browse only the unread messages or all the messages):
      MyMessage is Email
      FOR EACH MyMessage NOT READ OF MySession
      // Place the process of the message read...
      ...
      END
  3. Close the IMAP session with EmailCloseSession.
WINDEV

Specific features in WINDEV

You may have to establish a connection by modem before starting the IMAP session.
WEBDEV - Server code

Specific features in WEBDEV

In a WEBDEV site, the messages are received by the Application Server.
Remarks
WINDEVWINDEV Mobile

Connection to the service provider

WINDEV An Internet connection is required to manage the emails. Several cases may occur:
  • The user uses a modem to connect to Internet: NetOpenRemoteAccess establishes the Internet connection.
  • The user uses a direct connection to Internet (cable or ADSL): no specific operation is required.
WINDEV Mobile No specific operation is required to connect to the service provider.
Related Examples:
WD Mail Complete examples (WINDEV): WD Mail
[ + ] This application is an email client developed in WINDEV. It is based on the Email objects.
This email client is used to retrieve and send emails by using the POP, IMAP and SMTP protocols.
You have the ability to apply filters to the incoming emails.

The application can also be used to manage several email accounts. The writing of an email is based on the HTML edit control.
Minimum version required
  • Version 15
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/22/2023

Send a report | Local help