Last Update: 2018 - 02 - 27
Issues with the Hyperlink data type in Microsoft Access
by Philipp Stiefel, originally published May 23rd, 2016
Storing data such as email and web addresses (URLs) in an Access database sounds ridiculously simple. - And it can be.
However, if you studied some of the example databases provided by Microsoft, you might be tempted to use a Hyperlink datatype in your table to store those addresses. This makes them instantly clickable. Convenient, isn’t it? – Don’t do that!
What is behind the Hyperlink data type?
Storing data in a Hyperlink column will change the data you entered. The Hyperlink datatype is not plain text. It is a composite data type consisting of a DisplayText, the Address and optionally a SubAddress and a ScreenTip (Tool tip).
If you enter text manually or paste it into the field from the clipboard, the text entered gets analyzed by Access and, depending on the actual link text, additional info is added and the data is stored internally in a concatenated string in the format of DisplayText#Address#SubAddress#ScreenTip.
Here are some examples of this. I highlighted the parts of the stored data added by Access.
Pay attention to line 4. It is unchanged. More on that in a second.
Why is that so and what’s wrong with it?
The additional protocol information is required to make the contents of the field an actual working hyperlink. While on one hand it is convenient to have all this structured info in just one column, on the other hand it creates three problems at least.
I strongly recommend to use the plain (Short) Text data type to store your email addresses or URLs. The maximum length of a Short Text field can be up to 255 characters. There might be cases where an URL’s address is longer than that, but usually this should be enough.
If you expect longer link addresses you might want to use a Memo/Long Text column. Just be aware there are some limitations with that data type too.
But I want my hyperlink to be clickable!
Ok, I convinced you to go with my recommendation. You are storing your hyperlink addresses in a plain text format. That’s good. J
Now you want your email addresses or URLs to be clickable and look like a link when displayed in a form in your applications GUI. You can still achieve that with formatting properties and a few lines of VBA in your form.
The formatting part is pretty easy in current versions of Microsoft Access (Access 2010 and newer). Just go to the Property Sheet for the textbox control that is displaying the hyperlink and set the DisplayAsHyperlink property to “Screen Only” and the ForeColor property to “Hyperlink Color”. – Done.
If you want your hyperlink-textbox to respond to single clicks, as a built-in hyperlink would do, just write an event procedure for it’s On Click-Event. Call the Application.FollowHyperlink method in your procedure and pass the value of the textbox as argument.
Here is a working sample for such an event procedure.
Private Sub txtHyperlinkFullAddress_Click() On Error GoTo txtHyperlinkFullAddress_Click_Err If Not IsNull(Me.txtHyperlinkFullAddress.Value) Then Application.FollowHyperlink Me.txtHyperlinkFullAddress.Value End If Exit Sub txtHyperlinkFullAddress_Click_Err: Call MsgBox("Error " & Err.Number & " - " & Err.Description & " (in " & Me.Name & ".txtHyperlinkFullAddress_Click)") End Sub
If that textbox is not only used for displaying the hyperlink but for editing it as well, I would rather recommend to use the On Dbl Click-Event (double click) to invoke the hyperlink.
So we are all set now with the GUI.
But what do I do with existing Hyperlink columns?
You came here, because you created a table with a hyperlink column in the past and you struggle with exporting the data or using it in VBA code now. – I understand.
All is not lost.
I created a VBA module with 3 fairly simple functions to extract the relevant data from a Hyperlink column in a query in Access.
The first function is GetHyperlinkRawData. It just returns the unprocessed hyperlink data. You can use it in an Access Query to show the data that is really stored in your hyperlink column. – There is a sample query that shows how to use this later on.
Public Function GetHyperlinkRawData(ByVal hyperlinkData As Variant) As Variant GetHyperlinkRawData = hyperlinkData End Function
This function just extracts the DisplayText from the hyperlink column. If there is no DisplayText explicitly defined, it will return the full address including the sub-address.
Public Function GetHyperlinkDisplayText(ByVal hyperlinkData As Variant) As Variant Const SEPARATOR As String = "#" Dim retVal As Variant Dim tmpArr As Variant If IsNull(hyperlinkData) Then retVal = hyperlinkData Else tmpArr = Split(hyperlinkData, SEPARATOR) If Len(tmpArr(0)) > 0 Then retVal = tmpArr(0) Else retVal = tmpArr(1) If Len(tmpArr(2)) > 0 Then retVal = retVal & "#" & tmpArr(2) End If End If End If GetHyperlinkDisplayText = retVal End Function
Finally, GetHyperlinkFullAddress this the most important function. It extracts the hyperlink target address including the sub-address. For email addresses the function has an optional Boolean argument removeMailto to strip out the mailto:-part of the link and just return the plain email address.
This function will return the DisplayText if it is the only part of the hyperlink stored in the field and so fix links that are broken because a plain link was imported or written with VBA.
The function can however not fix the issue illustrated in line 4 of my sample table above. That type of broken link can only be fixed manually.
Public Function GetHyperlinkFullAddress(ByVal hyperlinkData As Variant, Optional ByVal removeMailto As Boolean) As Variant Const SEPARATOR As String = "#" Dim retVal As Variant Dim tmpArr As Variant If IsNull(hyperlinkData) Then retVal = hyperlinkData Else If InStr(hyperlinkData, SEPARATOR) > 0 Then ' I append 4 separators at the end, so I don't have to worry about the ' lenght of the array returned by Split() hyperlinkData = hyperlinkData & String(4, SEPARATOR) tmpArr = Split(hyperlinkData, SEPARATOR) If Len(tmpArr(1)) > 0 Then retVal = tmpArr(1) If Len(tmpArr(2)) > 0 Then retVal = retVal & "#" & tmpArr(2) End If End If Else retVal = hyperlinkData End If If Left(retVal, 7) = "mailto:" Then retVal = Mid(retVal, 8) End If End If GetHyperlinkFullAddress = retVal End Function
You can download all three functions in a VBA module here: modHyperlinkHelper
Extract the hyperlink data in a query
So now let me show you a simple example of you to uses these function to remedy you hyperlink troubles.
You just create a new select query, add the table containing the Hyperlink column, and add up to three expressions calling the function. Here is a screenshot of the design view:
The SQL of this query looks like this.
SELECT HyperlinkColumn, GetHyperlinkDisplayText([HyperlinkColumn]) AS DisplayText, GetHyperlinkFullAddress([HyperlinkColumn]) AS HyperlinkFullAddress, GetHyperlinkRawData([HyperlinkColumn]) AS HyperlinkRawData FROM tblHyperlinkTest;
Why not use Application.HyperlinkPart?
You may ask, why parse the text of the hyperlink and not use the built-in Application.HyperlinkPart method? If you closely at my function, you see that they are somewhat more sophisticated and return useful output even if the hyperlink data was not parsed and stored in the exact format Access expects for a hyperlink.
If you explicitly want to keep the Address and SubAddress part of the Hyperlink separate, you will need to write your own function for this. In that case the HyperlinkPart method may work well for you.
Thank you for reading
So this is all for now. If you enjoyed reading this article or it did save you time dealing with your hyperlink troubles, please share it on your favorite social network.
If want to receive updates on new content on codekabinett.com, subscribe to my newsletter.
© 1999 - 2017 by Philipp Stiefel