Use the AppendOnly Property and the ColumnHistory Method to Keep Historical Data for Memo Fields in Microsoft Access

Provided by Molly Pell, Quality Assurance Specialist

In Access 2007-Format databases (ACCDBs), the AppendOnly property for Memo fields allows you to store a history of the changes made to the field. The history of the Memo field can later be retrieved using the ColumnHistory method, as follows:

Sub GetColumnHistory()
Dim strHistory As String

strHistory = Application.ColumnHistory("Contacts", "Notes", "ID=1")
Debug.Print strHistory
End Sub
 

Using the Microsoft Contacts template for Access 2007, we’ll demonstrate how to enable and use this feature. Start off by creating a new Contacts.accdb file, using the template available from Microsoft Access.

Step 1: Enable collecting data on the Memo field (set AppendOnly property)

First, close all open forms, and then open the Contacts table in Design view. Locate the Notes field, and change the AppendOnly property to Yes:

This enables collecting history on the field.

Step 2: Add sample data

Now open the Contacts table in Datasheet view, and add a new record. Be sure to enter a value in the Notes field. Save the record by clicking on another row in the datasheet.

Now return to the record you just added, and change the value in the Notes field. You can’t see it now, but behind the scenes, Access is still storing the original value, along with the date and time of each data change.

Note the ID value for the record that you added (we’ll assume that ID=1), as we’ll use that in the last step.

Step 3: Retrieve historical data for the field (use the ColumnHistory method)

Press [Ctrl+G] to open the Immediate window, and type or paste the following:

?Application.ColumnHistory("Contacts", "Notes", "ID=1")

Click Enter to see the entire column history for the Notes field, where ID = 1:

You may wish to display the column history on a form or report. For example, you can add a text box to the Contact Details form, and set the following properties:

See also

• AppendOnly Property http://msdn.microsoft.com/en-us/library/bb258179.aspx

• ColumnHistory Method http://msdn.microsoft.com/en-us/library/bb242869.aspx

Return to the tips page