MACROMEDIA DREAMWEAVER 8-DREAMWEAVER API, Reference

Page: 85 / 628

Database connection functions 85
Arguments
catalog, schema
■
The
catalog
argument is the initial catalog value.
■
The
schema
argument is the initial schema value.
Returns
An object that contains the new values in the
catalog
and
schema
properties. If either
property is not defined, it indicates that the user cancelled the dialog box.
MMDB.testConnection()
Availability
Dreamweaver UltraDev 4.
Description
This function tests connection settings. It displays a modal dialog box that describes the
results.
Arguments
serverPropertiesArray
This function expects a single argument, an array object that contains values from the
following list, which are appropriate for the current server model. For properties that do not
apply to the connection being tested, set them to empty (
""
).
■
The
type
argument indicates, when
useHTTP
is a
false
value, which DLL to use for
connecting to a database at design time to test connection settings.
■
The
string
argument is the ADO connection string or JDBC URL.
■
The
dsn
argument is the data source name.
■
The
driver
argument is the JDBC driver.
■
The
username
argument is the user name.
■
The
password
argument is the password.
■
The
useHTTP
argument is a Boolean value. A value of
true
specifies that Dreamweaver
should use an HTTP connection at design time; otherwise, Dreamweaver uses a DLL.
Returns
A Boolean value:
true
if the connection test is successful;
false
otherwise.
000_DW_API_Print.book Page 85 Wednesday, July 20, 2005 11:58 AM