Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Introduction

...

borderColorgreen
borderWidth1
titleBGColor#ddffcc
borderStylesolid
titleDefinition

JDBC Options Binder allows you to retrieve form

...

option records from Joget or a custom database via user-defined SQL

...

borderColorpurple
borderWidth1
titleBGColor#ddccff
borderStylesolid
titleNew Feature

...

query statements.


JDBC Datalist Properties

Configure JDBC Datalist Binder

...

Figure 1: JDBC Options Binder Properties

NameDescription
Datasource
  • Custom Datasource
  • Default Datasource

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


Image Added
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.

Info
titleTest 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.

Info
titleImportant

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

Image Modified
Info
titleImportant

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

Add Empty Option
If checked,

Click this checkbox if you want an empty option

will be added to the selections.

in the selectbox.  Clicking this option will display the following field:

  • Empty Option Label
Empty option label. Only in use when Add Empty Option is checked
  • - 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

value/ID

Id. The second column is used for

label

Label. An optional third column can be returned for grouping value.

Code Block
languagesql
titleExample
linenumberstrue
SELECT username, CONCAT(lastName, ' ', firstName) FROM dir_user


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

Code Block
languagesql
titleExample
linenumberstrue
SELECT username, CONCAT(lastName, ' ', firstName) FROM dir_user WHERE timeZone = (?)


Related JDBC Binders

...