Pascal (Lazarus/Delphi)

Process New Email by Scanning for Senders

Scan email and save application-selected emails to EML files with unique filenames. Pascal (Lazarus/Delphi)

program ChilkatDemo;

// Demonstrates using the Chilkat Pascal wrapper via the C bridge DLL.
// Builds as a console application under Lazarus (FPC) or Delphi.

{$IFDEF FPC}
  {$MODE DELPHI}
{$ENDIF}
{$APPTYPE CONSOLE}

uses
  {$IFDEF UNIX}
  cthreads,
  {$ENDIF}
  SysUtils,
  CkDllLoader,
  Chilkat.EmailBundle,
  Chilkat.Imap,
  Chilkat.Email,
  Chilkat.MessageSet;

// ---------------------------------------------------------------------------

procedure RunDemo;
var
  success: Boolean;
  imap: TImap;
  fetchUids: Boolean;
  messageSet: TMessageSet;
  bundle: TEmailBundle;
  headersOnly: Boolean;
  emailHeader: TEmail;
  fullEmail: TEmail;
  i: Integer;
  numEmails: Integer;
  uidStr: string;
  uid: Integer;
  filename: string;

begin
  success := False;

  //  This example assumes the Chilkat API to have been previously unlocked.
  //  See Global Unlock Sample for sample code.

  imap := TImap.Create;

  //  Connect to an IMAP server.
  //  Use TLS
  imap.Ssl := True;
  imap.Port := 993;
  success := imap.Connect('imap.example.com');
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  Login
  success := imap.Login('myLogin','myPassword');
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  Select an IMAP mailbox
  success := imap.SelectMailbox('Inbox');
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  We can choose to fetch UIDs or sequence numbers.
  fetchUids := True;

  //  Fetch messages from the mailbox using a search criteria.
  //  This example finds NEW emails: these are emails that have the RECENT flag set, but not the SEEN flag:
  messageSet := TMessageSet.Create;
  success := imap.QueryMbx('NEW',fetchUids,messageSet);
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  This example will download headers, and then download
  //  the full email for those emails sent from a contact
  //  in our database.

  //  When downloading headers, each email object contains
  //  (obviously) the headers, but the body will be missing.
  //  Also, attachments will not be included.  However, it is
  //  possible to get information about the attachments
  //  as well as the complete size of the email.
  bundle := TEmailBundle.Create;
  headersOnly := True;
  success := imap.FetchMsgSet(headersOnly,messageSet,bundle);
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  Loop over the email objects...
  emailHeader := TEmail.Create;
  fullEmail := TEmail.Create;
  i := 0;
  numEmails := bundle.MessageCount;
  while i < numEmails do
    begin
      bundle.EmailAt(i,emailHeader);

      //  The sender's email address and name are available
      //  in the From, FromAddress, and FromName properties.
      //  If the sender is "Chilkat Support <support@chilkatsoft.com",
      //  then the From property will hold the entire string.
      //  the FromName property contains"Chilkat Support",
      //  and the FromAddress property contains "support@chilkatsoft.com";
      WriteLn(emailHeader.From);
      WriteLn(emailHeader.FromAddress);
      WriteLn(emailHeader.FromName);

      //  Assume at this point your code checks to see if the sender
      //  is one in your contacts database.  If so, this is
      //  the code you would write to download the entire
      //  email and save it to a file.

      //  The ckx-imap-uid header field is added when
      //  headers are downloaded.  This makes it possible
      //  to get the UID from the email object.
      uidStr := emailHeader.GetHeaderField('ckx-imap-uid');
      uid := StrToInt(uidStr);

      success := imap.FetchEmail(False,uid,True,fullEmail);
      if (success = False) then
        begin
          WriteLn(imap.LastErrorText);
          Exit;
        end;

      //  You can use the GenerateFilename method to
      //  generate a unique filename...
      filename := fullEmail.GenerateFilename();

      //  SaveEml saves the entire email, including attachments.
      success := fullEmail.SaveEml(filename);

      WriteLn('--');

      i := i + 1;
    end;

  //  Disconnect from the IMAP server.
  success := imap.Disconnect();


  imap.Free;
  messageSet.Free;
  bundle.Free;
  emailHeader.Free;
  fullEmail.Free;

end;

// ---------------------------------------------------------------------------

begin

  try
    RunDemo;
  except
    on E: Exception do
      WriteLn('Unhandled exception: ', E.ClassName, ': ', E.Message);
  end;

  WriteLn;
  {$IFDEF MSWINDOWS}
  WriteLn('Press Enter to exit...');
  ReadLn;
  {$ENDIF}
end.