Easy-to-follow video tutorials help you learn software, creative, and business skills.Become a member

Accessing IMAP accounts

From: ColdFusion 9 New Features

Video: Accessing IMAP accounts

In ColdFusion 8, we could access to an e-mail Inbox via the CFPOP tag. Unfortunately that means sucking mail down to cf server and dealing with things locally. We didn't have much control over the Inbox itself. In ColdFusion 9, we can connect to a mailbox via IMAP and have complete control over the Inbox including creating and deleting folders, moving mail around on the server and performing any other action that a user could perform directly on their own Inbox. So, I am going to show you how to connect to an IMAP account, how to pull e-mail out of that account and how to create and delete folders inside of that account.

Accessing IMAP accounts

In ColdFusion 8, we could access to an e-mail Inbox via the CFPOP tag. Unfortunately that means sucking mail down to cf server and dealing with things locally. We didn't have much control over the Inbox itself. In ColdFusion 9, we can connect to a mailbox via IMAP and have complete control over the Inbox including creating and deleting folders, moving mail around on the server and performing any other action that a user could perform directly on their own Inbox. So, I am going to show you how to connect to an IMAP account, how to pull e-mail out of that account and how to create and delete folders inside of that account.

So, in our Chapter9 folder, open up imap.cfm. In this file, the first thing I am doing is opening a connection to the mail server. So in this case I have action equals open, I have specified the server, the username and the password that I want to use to connect, and I am naming this connection. I am going to be reusing this connection throughout the video to perform actions on the mailbox. When I am all done with those actions, I am going to close that connection, so I don't leave any open imap connections on the server. So I am going to switch over to Safari real quick and I am already logged into this mail account, so we can take a look and see what's inside.

So I have two new emails here in the Inbox and in the Test Folder, I have one email that's already been read. So let's go back to cfbuilder and the first thing I am going to do is get a list of folders inside of the mailbox. Using the cf imap tag, we will choose action = and I'm going to list all folders. Now I need to specify the connection that I want to use and I need to specify the name of the variable that this information should be stored in.

So, let's call that FolderList and then I'm going to dump the value of FolderList out to the browser. Let's switch over to preview and we can see it tells us I have the Inbox. This tells me how many new messages I have in my Inbox, the total number of messages and how many of those are unread. So I can see I have Inbox and Test Folder. Let's take a look at the messages in Inbox. Switch over to source and let's do cfimap action = getheaderonly.

So I am only going to get the email headers, not the actual contents of the emails. Again I am going to use the current connection and I am going to put the data in to a variable called email list. I will dump out the email list and let's preview our file again. So now we can see all the headers for the two emails that are sitting in my Inbox. As you can see, I have a lot of information available to me. I have whether or not this particular email has been answered, CC's, whether it's been marked as deleted, draft, flagged, who it's from, the actual full email headers, so I can see who that it came from and how it got there.

If I scroll over to the right, I can see how many lines are in the email, its message ID, the number in the Inbox, a whole bunch of stuff. One of the more important values to notice here is the UID. This is the unique ID for this particular email inside of the mail server itself. So in this case these two email messages have UID's of two and three. So I just want to get just one particular email, if I go back to my source here, I can specify the UID in here.

So I only want to get the email with the UID of three, so we'll save and preview our file again, and now I'm just getting the headers for that single email. You should also notice that here that these messages have now been marked as read. They been pulled into ColdFusion through the cf imap, and during that process they have been marked as read. Now that is all well and good. I can see everything about the email other than the content itself. So if I go back to my source view and choose getall and then preview the file.

Now I am getting everything about that email including information on attachments and the actual content of the body of the email itself. Now, we can do more than just read in emails. I can also go in and create new folders. So let's add a new folder in our mailbox, so I am going to take this and comment out our getall code, and we will do cfimap action = CreateFolder. We use out CurrentConnection again and then I am going to create the folder under Test Folder/New Folder.

So, let's load that page up and we can see it's still dumped our folder list but we don't see our new folder here. Let's check and make sure it actually created it in the mailbox. So we will switch back to Safari and we will reload our page to reload the folder that's over there on the left and we see out plus icon and sure enough there's our New Folder. So in order to get that to display in our ColdFusion query, we will switch back to the source code and I am going to comment out the create folder code now otherwise, I will give an error because it will say that the folder already exists.

And on our listallfolders action, I will say recurse equals true. Now, If I will load this up, it will recurse through and pick up all subfolders as well. So now we can see Inbox, Test Folder and Test Folder/New Folder. Now the last thing we will do is delete the Test Folder we created, so we can clean up our mess, so do cfimap, action = deletefolder, and we will use our CurrentConnection and the specify the folder that we want to delete.

So let's load that file up and sure enough we can see it's no longer in our dump and if we go back to Safari and reload out page, New Folder has disappeared from our left-hand side bar. So, as you can see with the new cfimap tag, I have total control over your email Inboxes directly from ColdFusion. You can now easily manage automated emails in the shared Inbox, or even build your own custom email client with just a few well placed ColdFusion tags.

Show transcript

This video is part of

Image for ColdFusion 9 New Features
ColdFusion 9 New Features

36 video lessons · 2906 viewers

Daniel Short
Author

 
Expand all | Collapse all
  1. 4m 30s
    1. Welcome
      53s
    2. Using the exercise files
      3m 37s
  2. 7m 48s
    1. Adding managing and comparing servers
      5m 26s
    2. Monitoring server health
      2m 22s
  3. 22m 10s
    1. Setting the default data source and SMTP
      5m 6s
    2. Getting programmatic debugging and exception handling
      5m 54s
    3. Reviewing the new onCFCRequest method
      5m 29s
    4. Using ApplicationStop()
      2m 24s
    5. Working with Server.cfc and onServerStart
      3m 17s
  4. 17m 45s
    1. Using ternary and chained operations
      5m 46s
    2. Using New and Import
      4m 2s
    3. Reviewing CFScript enhancements
      7m 57s
  5. 20m 23s
    1. Building with implicit getters and setters
      4m 26s
    2. Working with LOCAL scope in functions
      4m 35s
    3. Serializing objects
      6m 6s
    4. Writing components in CFScript
      5m 16s
  6. 19m 27s
    1. Getting started with ORM
      5m 51s
    2. Logging ORM activity
      2m 13s
    3. Saving objects to the database
      6m 10s
    4. Defining table relationships
      5m 13s
  7. 16m 59s
    1. Caching page fragments
      5m 29s
    2. Managing the cache
      4m 48s
    3. Working with in-memory files using VFS (RAM disks)
      6m 42s
  8. 12m 39s
    1. Working with Excel spreadsheets
      4m 56s
    2. Working with Word documents
      4m 4s
    3. Working with PowerPoint presentations
      3m 39s
  9. 28m 58s
    1. Loading Google maps with markers onto a page
      4m 53s
    2. Adding a Flash movie with the built-in FLV player
      2m 14s
    3. Using multi-file upload control
      6m 7s
    4. Building a progress indicator
      3m 37s
    5. Working with accordion layouts
      3m 18s
    6. Showing information with data grid enhancements
      5m 1s
    7. Informing users with Confirm Alert and Prompt dialog boxes
      3m 48s
  10. 9m 8s
    1. Accessing IMAP accounts
      6m 31s
    2. Working with the new array functions
      2m 37s
  11. 15s
    1. Goodbye
      15s

Start learning today

Get unlimited access to all courses for just $25/month.

Become a member
Sometimes @lynda teaches me how to use a program and sometimes Lynda.com changes my life forever. @JosefShutter
@lynda lynda.com is an absolute life saver when it comes to learning todays software. Definitely recommend it! #higherlearning @Michael_Caraway
@lynda The best thing online! Your database of courses is great! To the mark and very helpful. Thanks! @ru22more
Got to create something yesterday I never thought I could do. #thanks @lynda @Ngventurella
I really do love @lynda as a learning platform. Never stop learning and developing, it’s probably our greatest gift as a species! @soundslikedavid
@lynda just subscribed to lynda.com all I can say its brilliant join now trust me @ButchSamurai
@lynda is an awesome resource. The membership is priceless if you take advantage of it. @diabetic_techie
One of the best decision I made this year. Buy a 1yr subscription to @lynda @cybercaptive
guys lynda.com (@lynda) is the best. So far I’ve learned Java, principles of OO programming, and now learning about MS project @lucasmitchell
Signed back up to @lynda dot com. I’ve missed it!! Proper geeking out right now! #timetolearn #geek @JayGodbold
Share a link to this course

What are exercise files?

Exercise files are the same files the author uses in the course. Save time by downloading the author's files instead of setting up your own files, and learn by following along with the instructor.

Can I take this course without the exercise files?

Yes! If you decide you would like the exercise files later, you can upgrade to a premium account any time.

Become a member Download sample files See plans and pricing

Please wait... please wait ...
Upgrade to get access to exercise files.

Exercise files video

How to use exercise files.

Learn by watching, listening, and doing, Exercise files are the same files the author uses in the course, so you can download them and follow along Premium memberships include access to all exercise files in the library.


Exercise files

Exercise files video

How to use exercise files.

For additional information on downloading and using exercise files, watch our instructional video or read the instructions in the FAQ.

This course includes free exercise files, so you can practice while you watch the course. To access all the exercise files in our library, become a Premium Member.

Join now "Already a member? Log in

Are you sure you want to mark all the videos in this course as unwatched?

This will not affect your course history, your reports, or your certificates of completion for this course.


Mark all as unwatched Cancel

Congratulations

You have completed ColdFusion 9 New Features.

Return to your organization's learning portal to continue training, or close this page.


OK
Become a member to add this course to a playlist

Join today and get unlimited access to the entire library of video courses—and create as many playlists as you like.

Get started

Already a member?

Become a member to like this course.

Join today and get unlimited access to the entire library of video courses.

Get started

Already a member?

Exercise files

Learn by watching, listening, and doing! Exercise files are the same files the author uses in the course, so you can download them and follow along. Exercise files are available with all Premium memberships. Learn more

Get started

Already a Premium member?

Exercise files video

How to use exercise files.

Ask a question

Thanks for contacting us.
You’ll hear from our Customer Service team within 24 hours.

Please enter the text shown below:

The classic layout automatically defaults to the latest Flash Player.

To choose a different player, hold the cursor over your name at the top right of any lynda.com page and choose Site preferencesfrom the dropdown menu.

Continue to classic layout Stay on new layout
Exercise files

Access exercise files from a button right under the course name.

Mark videos as unwatched

Remove icons showing you already watched videos if you want to start over.

Control your viewing experience

Make the video wide, narrow, full-screen, or pop the player out of the page into its own window.

Interactive transcripts

Click on text in the transcript to jump to that spot in the video. As the video plays, the relevant spot in the transcript will be highlighted.

Are you sure you want to delete this note?

No

Your file was successfully uploaded.

Thanks for signing up.

We’ll send you a confirmation email shortly.


Sign up and receive emails about lynda.com and our online training library:

Here’s our privacy policy with more details about how we handle your information.

Keep up with news, tips, and latest courses with emails from lynda.com.

Sign up and receive emails about lynda.com and our online training library:

Here’s our privacy policy with more details about how we handle your information.

   
submit Lightbox submit clicked
Terms and conditions of use

We've updated our terms and conditions (now called terms of service).Go
Review and accept our updated terms of service.