OpenOffice.org BASIC Guide - OpenOffice.org wiki

Data Sources
Command (String)
SQL command (typically a SELECT command)
The following example shows how a query object can be created in a program-controlled manner and can be
assigned to a data source.
Dim DatabaseContext As Object
Dim DataSource As Object
Dim QueryDefinitions As Object
Dim QueryDefinition As Object
Dim I As Integer
DatabaseContext = createUnoService("com.sun.star.sdb.DatabaseContext")
DataSource = DatabaseContext.getByName("Customers")
QueryDefinitions = DataSource.getQueryDefinitions()
QueryDefinition = createUnoService("com.sun.star.sdb.QueryDefinition")
QueryDefinition.Command = "SELECT * FROM Customer"
QueryDefinitions.insertByName("NewQuery", QueryDefinition)
The query object is first created using the createUnoService call, then initialized, and then inserted into the
QueryDefinitions object by means of insertByName.
Database Access
A database connection is needed for access to a database. This is a transfer channel which permits direct
communication with the database. Unlike the data sources presented in the previous section, the database
connection must therefore be re-established every time the program is restarted.
OpenOffice.org provides various ways of establishing database connections. This example shows how to connect
to an existing data source.
Dim DatabaseContext As Object
Dim DataSource As Object
Dim Connection As Object
Dim InteractionHandler as Object
DatabaseContext = createUnoService("com.sun.star.sdb.DatabaseContext")
DataSource = DatabaseContext.getByName("Customers")
If Not DataSource.IsPasswordRequired Then
Connection = DataSource.GetConnection("","")
Else
InteractionHandler = createUnoService("com.sun.star.sdb.InteractionHandler")
Connection = DataSource.ConnectWithCompletion(InteractionHandler)
End If
The code used in the example first checks whether the database is password protected. If not, it creates the
database connection required using the GetConnection call. The two empty strings in the command line stand
for the user name and password.
If the database is password protected, the example creates an InteractionHandler and opens the database
connection using the ConnectWithCompletion method. The InteractionHandler ensures that OpenOffice.org
asks the user for the required login data.
Iteration of Tables
A table is usually accessed in OpenOffice.org through the ResultSet object. A ResultSet is a type of marker
that indicates a current set of data within a volume of results obtained using the SELECT command.
This example shows how a ResultSet can be used to query values from a database table.
Dim DatabaseContext As Object
Dim DataSource As Object
Dim Connection As Object
Dim InteractionHandler as Object
146 OpenOffice.org 3.2 BASIC Guide · March 2010