Versions Compared

Key

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

...

NameDescriptionScreens (Click to view)
Datasource

Target database to execute SQL statements on.

Choices:-

  • Custom Datasource
    • JDBC Connection Parameters are needed for this choice.
  • Default Datasource
      By selecting Default Datasource, the
        • Points to the current database your copy of Joget
      is currently using will be selected
        • currently connects to.


    Figure 1: JDBC Option Binder
    Properties

    Custom JDBC DriverCustom

    JDBC

    Driver. This field is required when 

    driver name.

    Example values:

    • com
    Custom Datasource is selected in Datasource above. Example: com
    • .mysql.jdbc.Driver (MySQL)
    • oracle.jdbc.driver.OracleDriver (Oracle)
    • com.microsoft.sqlserver.jdbc.SQLServerDriver (Microsoft SQL Server)

    Only applicable to "Custom Datasource" option.

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

    Database connection URL.

    Example: jdbc:mysql://localhost

    /jwdb?characterEncoding=UTF8&useSSL=false

    :3306/jwdb

    Only applicable to "Custom Datasource" option.

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

    Database username.

    Example: root

    Only applicable to "Custom Datasource" option.

    Custom JDBC Password

    Specified database user's password.

    Only applicable to "Custom Datasource" option

    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.

    Info
    titleImportant

    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.

    Code Block
    languagesql
    titleExample
    linenumberstrue
    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.

    Code Block
    languagesql
    titleExample
    linenumberstrue
    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 (?)" :

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



    Info
    titleTable & 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.

    ...