You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 15 Next »

Introduction

JDBC Options Binder allows you to retrieve form option records from Joget or a custom database via user-defined SQL query statements.


JDBC Datalist Properties

Configure JDBC Datalist Binder

Figure 1: JDBC Options Binder Properties

NameDescriptionScreens (Click to view)
Datasource
  • Custom Datasource
  • Default Datasource

By selecting Default Datasource, the database your Joget is currently using will be selected.


Figure 1: JDBC Option Binder
Properties

Custom JDBC Driver

Custom JDBC Driver. This field is required when Custom Datasource is selected in Datasource above. Example: com.mysql.jdbc.Driver

Custom JDBC URL 

Custom JDBC URL. This field is required when Custom Datasource is selected in Datasource above.
Example: jdbc:mysql://localhost/jwdb?characterEncoding=UTF8&useSSL=false

Custom JDBC Username 

Custom JDBC Username. This field is required when Custom Datasource is selected in Datasource above.

Custom JDBC Password

Custom JDBC Password. This field is required when Custom Datasource is selected in Datasource above.

Test the connection parameters

Click on the "Test Connection" button at the bottom of the page to quickly test out your configurations.

Use AJAX for cascade options?

When checked, this allows these fields to dynamically load available options based on the other field value (grouping column) when dealing with tremendous amount of selections. Read more at Ajax Cascading Drop-Down List.

Important

Do not forget to configure the dependency field in Field ID to control available option based on Grouping in the next tab.

Important

Use question mark (?) in your SQL SELECT Query to represent dependency values.

Add Empty Option

Click this checkbox if you want an empty option in the selectbox.  Clicking this option will display the following field:

  • Empty Option Label - Enter your "empty" label, for example "Select".
SQL SELECT Query

To populate a selectbox, for example, you need to return at least 2 columns. The first column is used for Id. The second column is used for Label.
An optional third column can be returned for grouping value if for example, you are using the select box "Field ID to control available options based on Grouping" property field.

Example
SELECT
   username,
   username
FROM
   dir_user 
ORDER BY
   username ASC

When Use AJAX for cascade options is checked, make sure that a question mark is placed within the query.

Example
SELECT
   username,
   CONCAT(lastName, ' ', firstName) 
FROM
   dir_user 
WHERE
   timeZone = (?)

On multi-select box form element on cascade and when using JDBC, remember to use brackets to enclose the ? parameter in
"WHERE id IN (?)" :

SELECT
   id,
   c_field1
FROM
   app_fd_myTable
WHERE
   id IN (?)



Table & Column Naming

For database tables created by Joget Forms, Joget adds a "c_" in front of table column names and "app_fd_" in front of database table names.


Related JDBC Binders & Useful Links


Download Demo Apps

APP_jdbc_options_binder_dx_kb.jwa


  • No labels