UltraDev 4
calls this function to detect a connection in the specified HTML source and to parse the connection parameters. If the contents of this source file match the criteria for a valid connection, findConnection() returns a connection object; otherwise, this function returns a null value.
htmlSource
htmlSource is the HTML source for a connection.
A connection object that provides values for a particular combination of the properties that are listed in the following table. The properties for which this function returns a value depends on the document type.
| name | Name of the connection |
| type | If useHTTP is false , indicates which DLL to use for connecting to database at runtime |
| string | Runtime connection string. For ADO, it is a string of connection parameters; for JDBC, it is a connection URL |
| dsn | Data source name used for ODBC or Cold Fusion runtime connections |
| driver | Name of a JDBC driver used at runtime |
| username | Name of the user used for the runtime connection |
| password | Password used for the runtime connection |
| designtimeString | Design-time connection string (see string ) |
| designtimeDsn | Design-time data source name (see dsn ) |
| designtimeDriver | Name of a JDBC driver used at design time |
| designtimeUsername | Name of the user used for the design-time connection |
| designtimePassword | Password used for the design-time connection |
| designtimeType | Design time connection type |
| usesDesigntimeInfo | When false , uses runtime properties at design time; otherwise, uses design-time properties |
| useHTTP | String containing either true or false; which specifies whether to use HTTP connection at design time or use DLL |
| includePattern | Regular expression used to find the file include statement on the page during Live Data and Preview In Browser |
| variables | Object with a property for each page variable which is set to its corresponding value. This object is used during Live Data and Preview In Browser |
| catalog | String containing a database identifier that restricts the amount of metadata that appears |
| schema | String containing a database identifier that restricts the amount of metadata that appears |
| filename | Name of the dialog box used to create the connection |
If a connection is not found in htmlSource, a null value returns.
Note: Developers can add custom properties (for example, metadata) to the HTML source, which applyConnection() returns along with the standard properties.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117