Introduction

The Report Search Datalist Binder plugin is is a database Binder Using JDBC with support for search filters before performing aggregate and pivot.

JDBC Datalist Database Binder (Report) Properties

Configure Database SQL Query

Report Search Datalist Binder Properties

Figure 1: Configure Report Search JDBC Datalist Database Binder (Report)

Name	Description
Datasource	Custom Datasource - setup to connect to an external database, has additional configuration. Default Datasource- connect to the Joget database. By selecting Default Datasource, the database your Joget is currently using will be selected.

(See Figure 2).

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 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 *	The SQL query specific to your database type (MySQL, MSSQL, Oracle, etc.). Use question mark ? in your query to represent the primary key or foreign key. Code Block language sql title Example linenumbers true SELECT * FROM app_fd_table WHERE id = ? 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 language sql 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.. Sample: SELECT * FROM dir_user
SQL Select Query (Data) *	Sample: SELECT locale, active, COUNT(active) as `count` FROM #data# GROUP BY active, locale
Primary Key *	Primary key of the table.
Pivot Data	If checked, Pivot Column Name, Pivot Value Column Name, and Value to Fill Up Empty Cell will be shown.
Pivot Column Name *	Multiple columns supported. Separate multiple columns using semicolon. (e.g. year;customer)
Pivot Value Column Name *	Multiple columns supported. Separate multiple columns using semicolon. (e.g. outstanding;paid)
Value to Fill Up Empty Cell	e.g. 0.00

Plugin Usage

Related Links