Search code examples
ms-accesshyperlinklinked-tables

Preserving linked tables for Access DBs in same folder when the folder changes


I've got two Access databases that share linked tables. They are deployed together in a directory and accessed via code in a Word form.

How can I make sure that the links are preserved when the two databases are copied (together) to a different folder? Since I'm not "opening" the database, per se (it's being accessed via ADO), I don't know how to write code to refresh the links.


Solution

  • Update 14APR2009 I found that the previous answer I gave here was erroneous, so I updated it with new code.

    How to proceed

    • Copy the code below to a VBA module.
    • From code or from the Immediate window in the VBA IDE, simply type:

      RefreshLinksToPath Application.CurrentProject.Path
      

    This will now relink all the linked tables to use the directory where your application is located.
    It only needs to be done once or whenever you relink or add new tables.
    I recommend doing this from code every time you start your application.
    You can then move your databases around without problems.

    Code

    '------------------------------------------------------------'
    ' Reconnect all linked tables using the given path.          '
    ' This only needs to be done once after the physical backend '
    ' has been moved to another location to correctly link to    '
    ' the moved tables again.                                    '
    ' If the OnlyForTablesMatching parameter is given, then      '
    ' each table name is tested against the LIKE operator for a  '
    ' possible match to this parameter.                          '
    ' Only matching tables would be changed.                     '
    ' For instance:                                              '
    ' RefreshLinksToPath(CurrentProject.Path, "local*")          '
    ' Would force all tables whose ane starts with 'local' to be '
    ' relinked to the current application directory.             '
    '------------------------------------------------------------'
    Public Function RefreshLinksToPath(strNewPath As String, _
        Optional OnlyForTablesMatching As String = "*") As Boolean
    
        Dim collTbls As New Collection
        Dim i As Integer
        Dim strDBPath As String
        Dim strTbl As String
        Dim strMsg As String
        Dim strDBName As String
        Dim strcon As String
        Dim dbCurr As DAO.Database
        Dim dbLink As DAO.Database
        Dim tdf As TableDef
    
        Set dbCurr = CurrentDb
    
        On Local Error GoTo fRefreshLinks_Err
    
        'First get all linked tables in a collection'
        dbCurr.TableDefs.Refresh
        For Each tdf In dbCurr.TableDefs
            With tdf
                If ((.Attributes And TableDefAttributeEnum.dbAttachedTable) = TableDefAttributeEnum.dbAttachedTable) _
                   And (.Name Like OnlyForTablesMatching) Then
                    collTbls.Add Item:=.Name & .Connect, key:=.Name
                End If
            End With
        Next
        Set tdf = Nothing
    
        ' Now link all of them'
        For i = collTbls.count To 1 Step -1
            strcon = collTbls(i)
            ' Get the original name of the linked table '
            strDBPath = Right(strcon, Len(strcon) - (InStr(1, strcon, "DATABASE=") + 8))
            ' Get table name from connection string '
            strTbl = Left$(strcon, InStr(1, strcon, ";") - 1)
            ' Get the name of the linked database '
            strDBName = Right(strDBPath, Len(strDBPath) - InStrRev(strDBPath, "\"))
    
            ' Reconstruct the full database path with the given path '
            strDBPath = strNewPath & "\" & strDBName
    
            ' Reconnect '
            Set tdf = dbCurr.TableDefs(strTbl)
            With tdf
                .Connect = ";Database=" & strDBPath
                .RefreshLink
                collTbls.Remove (.Name)
            End With
        Next
        RefreshLinksToPath = True
    
    fRefreshLinks_End:
        Set collTbls = Nothing
        Set tdf = Nothing
        Set dbLink = Nothing
        Set dbCurr = Nothing
        Exit Function
    
    fRefreshLinks_Err:
        RefreshLinksToPath = False
        Select Case Err
            Case 3059:
    
            Case Else:
                strMsg = "Error Information..." & vbCrLf & vbCrLf
                strMsg = strMsg & "Function: fRefreshLinks" & vbCrLf
                strMsg = strMsg & "Description: " & Err.Description & vbCrLf
                strMsg = strMsg & "Error #: " & Format$(Err.Number) & vbCrLf
                MsgBox strMsg
                Resume fRefreshLinks_End
        End Select
    End Function
    

    This code is adapted from this source: http://www.mvps.org/access/tables/tbl0009.htm.
    I removed all dependency on other functions to make it self-contained, that's why it's a bit longer than it should.