...
Configure JDBC Datalist Binder
Image Added
Figure 1: JDBC Datalist Properties
| Name | Description | Screens (Click to view) |
|---|
| Datasource | Target database to execute SQL statements on. Choices:- - Custom Datasource
- JDBC Connection Parameters are needed for this choice.
- Default Datasource
- Points to the current database your copy of Joget currently connects to.
| 
Image Removed
Figure 1: JDBC Datalist Properties |
| Custom JDBC Driver | JDBC driver name. Example values: - com.mysql.jdbc.Driver (MySQL)
- oracle.jdbc.driver.OracleDriver (Oracle)
- com.microsoft.sqlserver.jdbc.SQLServerDriver (Microsoft SQL Server)
Only applicable to "Custom Datasource" option. |
| Database connection URL. Example: jdbc:mysql://localhost:3306/jwdb Only applicable to "Custom Datasource" option. |
| Database username. Example: root Only applicable to "Custom Datasource" option. |
| Specified database user's password. Only applicable to "Custom Datasource" option.
| Info |
|---|
| title | Test the connection parameters |
|---|
| Click on the "Test Connection" button at the bottom of the page to quickly test out your configurations. |
|
| SQL Select query to populate the datalist.
| Code Block |
|---|
| SELECT * FROM app_fd_myTable |
| Note |
|---|
If a column name contains reserved keywords, do ensure it is encapsulated properly. For example for MySQL, if the column identifier itself contains a dot symbol ( . ), it should be encapsulated like this: | Code Block |
|---|
| SELECT `myAppName.myColumn` FROM app_fd_myTable; |
|
| Info |
|---|
| title | Table & Column Naming |
|---|
| - For database tables created by Joget Forms, Joget adds a "c_" in front of table column names (or "t_" if your column name starts with a number) and "app_fd_" in front of database table names.
- If you use environment hash variables to store SQL query strings, use "?noescape" to escape SQL query strings in JDBC binders to prevent the "<>" "not equal" operator from being converted, i.e. disables XSS prevention checking. Read here for more information..
|
|
| Define the primary key column. By default, it should be "id". |
| Optimize query for paging | When checked, the binder only fetches selected page's items rather than the returning the whole data set to optimize the performance for large dataset paging. Only works for MySQL and Microsoft SQL Server 2012 onwards. |
...