This article demonstrates how to create script that filters a data access page by setting the ServerFilter property. You can use this script even when the page is not stored on a Web server.
Microsoft provides programming examples for illustration only, without warranty either expressed or implied. This includes, but is not limited to, the implied warranties of merchantability or fitness for a particular purpose. This article assumes that you are familiar with the programming language that is being demonstrated and with the tools that are used to create and to debug procedures. Microsoft support engineers 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 requirements.
The following steps demonstrate how to create a page based on the Customers table. When you open the page or click the New Filter button, the script prompts you for a list of countries. The script then limits the number of records returned based on the countries that you entered. You can return all records by leaving the list empty.
CAUTION: If you follow the steps in this example, you modify the sample database Northwind.mdb. You may want to back up the Northwind.mdb file and follow these steps on a copy of the database.
Open the sample database Northwind.mdb.
Create a new page in Design view.
If the field list is not visible, on the View menu, click Field List.
From the Customers table, drag the CustomerID, CompanyName, City, Region, and Country onto the page.
Add a command button to the page and set the following properties:
ID: cmdFilter
Inner Text: New Filter
On the Tools menu, point to Macro, and then click Microsoft Script Editor.
On the HTML menu, point to Script Block, and then click Client. Type the following script:
<SCRIPT language=vbscript>
<!--
Function SetServerFilter()
Dim strFilter, myFilter
strPrmt = "What country do you want to filter by?" & vbCrLf & _
"Separate the list of countries by a semicolon (;)." _
& vbCrLf & "To return all records, leave the box empty."
' Prompt the user for list of countries that are to be returned.
strFilter = InputBox(strPrmt)
If strFilter = "" Then
' Clear the filter criteria when nothing is typed in the input box.
' All records are returned in this case.
myFilter = ""
Else
' Loop through the user's list until there is only one country left.
Do Until InStr(strFilter, ";") = 0
' Add the first country from the list to the filter criteria.
myFilter = myFilter & "[Country] = " & Chr(39) & Left(strFilter, _
InStr(strFilter, ";") - 1) & Chr(39) & " OR "
' Remove the first country from the list.
strFilter = Right(strFilter, Len(strFilter) - InStr(strFilter, ";"))
Loop
' Add the final country from the user's list to the filter criteria.
myFilter = myFilter & "[Country] = " & Chr(39) & strFilter & Chr(39)
End If
' Set the server filter.
MSODSC.RecordsetDefs.Item(0).ServerFilter = myFilter
End Function
-->
</SCRIPT>
Using the Script Outline, insert the following script for the DataPageComplete event of the MSODSC:IMPORTANT: When you create VBScript blocks for MSODSC events, you must add a parameter to the event name as follows:
The <I>oEventInfo</I> parameter returns specific information about the event to the script. You must add this parameter, whether or not it will be used, because the script will not work without it.
Back to the top
