## Data Simulation Widgets

The widgets located in the data visualization group are those related to Data Masters' visual representation. These widgets will help you visualize the contents of your Data Masters as well as some information related to them.

### Data Grid

This widgets displays the records of a Data Master as a grid. The data source is always a single Data Master which is selected when the grid is created. Data grids are displayed as cells that contain all the data of a data master row. The number of rows or columns can be decided by selecting vertical or horizontal orientation on the properties panel. The first cell will be displayed with the field names and the other cells will be displayed just as a grey cell. When simulating, cells will be filled with the Data Master's record instances.

In order to create a Data Grid for a particular Data Master:

1. Click on the Data Grid widget on the Widgets' palette.

2. A dialog will appear asking for information regarding the data source the Data Grid will use. (If you have no Data Masters you will be first asked to create a new one).

3. Fill in all the requiered fields and press Ok.

4. Once the dialog is closed, just click on the desired place on the canvas to finally create the item.

Once a Data Grid is created you can change some of its properties including its identifier in the Properties panel but you cannot change its Data Master association.

Selecting cells

To select a single cell, click on the upper-left sample cell

Select number of rows

You can choose the number of rows on vertical orientation. To choose the number of rows, set vertical orientation on the properties tab, and then choose the number of rows.

Select number of columns

You can choose the number of rows on vertical orientation, and the number of columns on horizontal orientation new columns at the end of a Data Grid widget. To insert a new column, right-click on the Data Grid widget and select 'New Column' in the contextual menu.

Select number of cells per page

You can choose the number of cells that will be displayed on each data grid page. Using the 'Paginate data grid' event, you will be able to navigate between the grid's pages.

Removing fields or texts

Delete a field or text by selecting it and pressing Delete key.

Ordering fields

The order of the Data Grid's fields can be modified once created. To move a field or text to a different position within the Data Grid, drag and drop it to the desired position.

Resizing cells

Select a Data Grid's cell and drag its sizing handles to resize them.

### Data List

This widgets displays the records of a Data Master as a list. The data source is always a single Data Master which is selected when the list is created. This widget is displayed as a header row with the Data master field names, a row with the field names, the other rows are displayed as grey rows: when simulating, rows will be filled with the the Data Master's record instances.

In order to create a Data List for a particular Data Master:

1. Click on the Data List widget on the Widgets' palette.

2. A dialog will appear asking for information regarding the data source the Data List will use. (If you have no Data Masters you will be first asked to create a new one).

3. Fill in all the requiered fields and press Ok.

4. Once the dialog is closed, just click on the desired place on the canvas to finally create the item.

Once a Data List is created you can change some of its properties including its identifier in the Properties panel but you cannot change its Data Master association.

Selecting rows and columns

To select a row, click on the left edge of the row when the cursor changes to

To select a column, click on the top edge of the column when the cursor changes to

Inserting columns

You can insert new columns at the end of a Data List widget. To insert a new column, right-click on the Data List widget and select 'New Column' in the contextual menu.

Removing columns

Delete a column by selecting it and pressing Delete key. You can also remove it if you select the option Delete in the contextual menu of a column.

Ordering columns

The order of the Data List's columns can be modified once created. To move a column to a different position within the Data List, drag and drop it to the desired position. An orange feedback will guide you when placing the column between other columns.

Resizing rows and columns

Select a Data List's cell or an entire row or column and drag its sizing handles to resize them.

Changing Data List's properties

When a Data List widget is selected on a screen you can change some of its properties in the Properties panel:

Find more information about Data Lists in the Data Simulation section.

### Summary

The Summary widget is a special text label which shows information about a Data Grid or Data List. This widget cannot be directly edited like a normal Text as its content is automatically generated using its associated Data Grid information. The information displayed by this widget is the total number of rows and the currently displayed ones.

To change its associated Data Grid, select the Summary widget and select the desired Data Grid in the Properties panel.

### Index

The Index widget is a special text label which shows information about the Data Grid or Data List's pages. This widget cannot be directly edited like a normal Text as its content is automatically generated using its associated Data Grid information. The information displayed by this widget is the index of pages of the Data Grid. The current page index will be highlighted using a bold font style. Notice that the number of pages of a Data Grid will depend on the field 'Rows per page' in the Data Grid widget's properties.

To change its associated Data Grid, select the Index widget and select the desired widget in the Properties panel.