OL97: How to Programmatically Import Outlook Items from Access

Retired KB Content Disclaimer

View products that this article applies to.

This article was previously published under Q170320

SUMMARY

This article provides an overview and example code for creating Microsoft Outlook 97 Contacts from information stored in a Microsoft Access 97 database. The sample code below would be run from an Access 97 global module and provides a starting point for the development of a complete solution.

NOTE: There is also an overview and separate code example available on the Microsoft web site at the following location. It is the first example in the whitepaper.

http://msdn2.microsoft.com/en-us/office/aa905351.aspx (http://msdn2.microsoft.com/en-us/office/aa905351.aspx)

NOTE: Because the Microsoft Web site is regularly updated, the site address may change without notice. If this occurs, link to the Microsoft home page at the following address:

http://www.microsoft.com/ (http://www.microsoft.com/)

Back to the top

MORE INFORMATION

Outlook 97's Import and Export feature does not allow you to import or export information in user-defined fields (or properties). To import information into these fields, you need to create a programming solution that uses Automation to convert the information.

The following example code specifically converts information from Microsoft Access into newly created Outlook Contacts, using Data Access Objects (DAO 3.5). With modifications, you can use this code as a basis for creating other types of Outlook items, such as appointments, notes, tasks, and such.

Microsoft provides programming examples for illustration only, without warranty either expressed or implied, including, but not limited to, the implied warranties of merchantability and/or fitness for a particular purpose. This article assumes that you are familiar with the programming language being demonstrated and the tools used to create and debug procedures. Microsoft support professionals can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific needs.
If you have limited programming experience, you may want to contact a Microsoft Certified Partner or Microsoft Advisory Services. For more information, visit these Microsoft Web sites:

Microsoft Certified Partners - https://partner.microsoft.com/global/30000104 (https://partner.microsoft.com/global/30000104)

Microsoft Advisory Services - http://support.microsoft.com/gp/advisoryservice (http://support.microsoft.com/gp/advisoryservice)

For more information about the support options that are available and about how to contact Microsoft, visit the following Microsoft Web site: http://support.microsoft.com/default.aspx?scid=fh;EN-US;CNTACTMS (http://support.microsoft.com/default.aspx?scid=fh;en-us;cntactms)

Back to the top

Programming Considerations

The code example below uses the Northwind database included with Microsoft Office 97. If you installed Office to a location other than the default, be sure to change the path to the database in the code.
You need to set references to DAO 3.5 and the Outlook 8.0 Object Library.
The fields types used in this example are text, in both Access and Outlook. To convert other types of fields, you must modify the code appropriately.
The contacts are automatically placed in Outlook's default Contact folder, which is at the same level as the Inbox that receives incoming mail.
The CreateItem method used in this example creates a new Outlook contact using the default form for the default contact folder. If you created a custom Outlook Contact form, you must set the MessageClass field for each item to the name of your custom form.
If you programmatically set a contact's e-mail address field, the e-mail addresses do not automatically resolve.

For more information about programmatically resolving e-mail addresses, please see the following article in the Microsoft Knowledge Base:

169750 (http://support.microsoft.com/kb/169750/EN-US/ ) OL97: How to Programmatically Resolve a Contact's E-mail Address

Back to the top

Example Code

   Sub ExportAccessContactsToOutlook()

   'Set up DAO Objects:
   Dim oDataBase As Object
   Dim rst As Object
   Set oDataBase = OpenDatabase _
     ("c:\Program Files\Microsoft Office\Office\Samples\Northwind.mdb")
   Set rst = oDataBase.OpenRecordset("Customers")

   'Set up Outlook Objects:
   Dim olns As Object               ' Outlook Namespace
   Dim cf As Object                 ' Contact folder
   Dim c As Object                  ' Contact Item
   Dim Prop As Object               ' User property
   Dim ol As New Outlook.Application
   Set olns = ol.GetNamespace("MAPI")
   Set cf = olns.GetDefaultFolder(olFolderContacts)

   With rst
      .MoveFirst
      ' Loop through the Access records
      Do While Not .EOF
         ' Create a new Contact item
         Set c = ol.CreateItem(olContactItem)
         ' Specify which Outlook form to use:
         ' Change "IPM.Contact" to "IPM.Contact.<formname>" if you've
         ' created a custom Contact form in Outlook.
         c.MessageClass = "IPM.Contact"
         ' Create all built-in Outlook fields
         If ![CompanyName] <> "" Then c.CompanyName = ![CompanyName]
         If ![ContactName] <> "" Then c.FullName = ![ContactName]
         ' Create the first user property (UserField1)
         Set Prop = c.UserProperties.Add("UserField1", olText)
         ' Set its value
         If ![CustomerID] <> "" Then Prop = ![CustomerID]
         ' Create the second user property (UserField2)
         Set Prop = c.UserProperties.Add("UserField2", olText)
         ' Set it's value, and so on....
         If ![Region] <> "" Then Prop = ![Region]
         ' Save the contact
         c.Save
         .MoveNext
      Loop
   End With
   End Sub

Back to the top

REFERENCES

For more information about creating solutions with Microsoft Outlook 97, please see the following articles in the Microsoft Knowledge Base:

166368 (http://support.microsoft.com/kb/166368/EN-US/ ) OL97: How to Get Help Programming with Outlook

170783 (http://support.microsoft.com/kb/170783/EN-US/ ) OL97: Q&A: Questions about Customizing or Programming Outlook

Back to the top

APPLIES TO

Microsoft Outlook 97 Standard Edition

Back to the top

kbcode kbhowto kbmigrate kbprogramming KB170320

Back to the top

Retired KB Content Disclaimer

This article was written about products for which Microsoft no longer offers support. Therefore, this article is offered "as is" and will no longer be updated.

Back to the top