Adobe 38040334 API Reference - Page 64

DREAMWEAVER CS3 59 API Reference 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. Database access functions Database access functions let you query a database. For the collection of functions that manage a database connection, see "Database connection functions" on page 47. The following list describes some of the arguments that are common to the functions that are available: • Most database access functions use a connection name as an argument. You can see a list of valid connection names in the Connection Manager, or you can use the MMDB.getConnectionList() function to get a list of all the connection names programmatically.