REM MS Access Reader by Gary Roberts 08/30/2000
REM Copyright Gary Roberts, 2000 (e-mail: groberts@carolina.rr.com)
REM
REM Application Name: MS Access Reader
REM View Name: Customers
REM Action Name: Read MS Access Database
REM
REM Purpose:
REM Read a Microsoft Access (MS Access) MDB file and create a Notes Document for
REM each record in the MS Access Database. The newly created documents will be
REM displayed in the "By Company Name" view in THIS Notes Database.
REM
REM IMPORTANT NOTES:
REM You do NOT have to have MS Access installed on your PC to run this program.
REM You DO have to have the Northwind.mdb file (comes with MS Access)
REM You DO have to register Northwind.mdb as an ODBC Data Source (System)
REM You DO have to have nlsxodbc.dll in your Notes directory (NOT the Data Directory)
REM You DO have to have lsconst.lss in your Notes directory (NOT the Data Directory)
REM You DO have to have lsxbeerr.lss in your Notes directory (NOT the Data Directory)
REM The ODBC LSX File is declared in the FORM's (Globals) (Options) section
REM I used the fully qualified filename of the DLL in case yours isn't registered
REM LotusScript and Error constants are "Included" in the FORM's (Globals) (Declarations) section
REM
REM Change Log:
REM ------------------------------------------------------------------------------------------------------
REM 08/30/2000 Gary Roberts Placed into production
REM
REM Notes Objects Declarations
Dim session As New NotesSession
Dim ws As New NotesUIWorkspace
Dim db As NotesDatabase
Dim view As NotesView
Dim doc As NotesDocument
Dim con As New ODBCConnection ***rot***
Dim qry As New ODBCQuery ***rot***
Dim result As New ODBCResultSet ***rot***
REM Miscellaneous module variables
Dim msg As String
Dim FieldCount As Integer
Dim Status As Integer
REM MS Access Database declarations
Const adbFileName = "FrankiermaschineA" ' This is the DSN Name as registered in ODBC
Const adbTableName = "CostAccounts" ' This is a table in the northwind database
REM Notes Database declarations
Const ndbViewName = "CA" ' This is an existing View in the target database
Const ndbFormName = "CostAccounts" ' This is an existing Form in the target database
REM Instantiate the major Notes objects
Set db = session.CurrentDatabase
Set view = db.GetView( ndbViewName )
REM Connect to the MS Access Database. Throw an error if it fails
status = con.ConnectTo( adbFileName ) ***rot***
If Not con.IsConnected Then ***rot***
Messagebox "Could not connect to " & adbFileName & " database -- Did you register the ODBC Data Source???",, "Error"
Exit Sub
End If
If con.GetError <> DBstsSUCCESS Then
Messagebox con.GetExtendedErrorMessage,, "Connection Error - " & con.GetError & " " & con.GetErrorMessage
Exit Sub
End If
Print "Connected to " & adbFileName & " database" ' Update the Notes Client Status Bar if we're okay
REM If we got this far, we must be connected, so just for grins, let's show the user all the fields in this table.
REM Note: "fields" has not been declared, so it will be a Variant Array -- that's what we want
fields = con.ListFields( adbTableName )
msg = adbTableName & " contains the following fields:" & Chr(10)
For FieldCount = Lbound( fields ) To Ubound( fields )
msg = msg & Chr(10) & fields( FieldCount )
Next
REM Okay, let's display the Field List to the User...
Messagebox msg,, "Fields from the " & adbFileName & " database"
REM We made it this far, so let's setup the SQL Query. Throw an error if it fails
Set qry.Connection = con
Set result.Query = qry
qry.SQL = "SELECT * FROM " & adbTableName ' Grab all of the fields (columns) from the specified table
If qry.GetError <> DBstsSUCCESS Then
Messagebox qry.GetExtendedErrorMessage,, "Query Error" & qry.GetError & " " & qry.GetErrorMessage
Exit Sub
End If
REM Update the Notes Client Status Bar
Print "Reading " & adbFileName & " database" ' Update the Notes Client Status Bar if we're okay
REM Must be okay -- Get the Data
result.Execute
REM See if we have data. If so, loop through the ResultSet. If not, throw an error
If result.IsResultSetAvailable Then
Do
result.NextRow
REM Create a Notes Document, assign values, save the document. Do it until we're done.
Set doc = db.CreateDocument ' Create a new Notes Document for this record
doc.Form = ndbFormName
REM Okay -- Let's get serious -- We'll use the MS Access Database field (Column)
REM names for the field names in the Notes Documents
doc.CAID = result.GetValue( "ID" )
doc.CAReference = result.GetValue( "CostAccountReference" )
doc.CAName = result.GetValue( "CostAccountName" )
doc.CACreation = result.GetValue( "DateTimeCreation" )
Call doc.save( True, False )
Loop Until result.IsEndOfData
REM We're done, so let's clean up the mess we've made and bail out
result.Close( DB_CLOSE )
Print "Finished" ' Update the Notes Client Status Bar if we're okay
Else
REM If we got here, it means there was no data in the table, so throw an error (Informational)
Messagebox "No data retrieved for " & adbTableName & " table", MB_ICONINFORMATION, "No data"
Print "DOH!!!!! Got no data -- Bummer!!!!" ' Update the Notes Client Status Bar if we're NOT okay
Exit Sub
End If
REM Give up the ODBC Connection like a good little boy
con.Disconnect
REM Update the view so the new documents will show up without having to press the F9 key
Call view.Refresh
Call ws.ViewRefresh