How to initialize a grid with data
You can use the grid to retrieve data from a database.
For instance, assume you want to create a sandwich ordering functionality to complement your in-house event management system.
For each event you want to be able to indicate what sandwiches should be delivered - it should look something like this:
To setup such a grid you need:
a) A database containing a table with all the sandwich menu choices
b) The connection string to access the data.
We will use the same database as for the previous example, but it should be clear that the source data can be retrieved from any other database.
(The (mysql) sql statements to create the sandwich_menu source table is available in the sandwich_menu.sql )
Use the following grid configuration properties to populate the grid with data:
gd.query=select name,price from sandwich_menu
gd.query.columns=sandwich,price
gd.query.ds=gridds
gd.query = select... contains the query to retrieve the data from the sandwich_menu
gd.query.columns=sandwich,price maps received data to the certain columns in the Grid
gd.query.ds = gridds declares the database where the data can be found.
The full recipe for this example.
Add a new custom table grid field and configure it with following configuration specification.
gd.columns=sandwich,price,aantal
gd.tablename=sandwich_order
gd.query=select name,price from sandwich_menu
gd.query.columns=sandwich,price
gd.query.ds=gridds
datasource.names=gridds
ds.gridds.connection.type=mysql
ds.gridds.connection.url=jdbc:mysql://localhost:3306/igrid_test?useUnicode=true&characterEncoding=UTF8&jdbcCompliantTruncation=false
ds.gridds.connection.username=igrid_tester
ds.gridds.connection.password=igrid_tester
col.sandwich=Sandwich
col.sandwich.type=string
col.sandwich.editable=false
col.sandwich.width=200
col.price=Price
col.price.type=number
col.price.editable=false
col.price.width=75
col.aantal=Count
col.aantal.type=number
col.aantal.minvalue=0
col.aantal.maxvalue=10
col.aantal.width=75
gd.sandwich.editable = false set the column with the sandwich names and prices to false. That way your user will not change it inadvertently.
Check initialization properties to get complete list of the properties used to initialize a grid.