You can add a control of type Data grid to a form.

Compared to the configurable grid, a data grid uses a developed data set to query the data.


Standard procedure

1. Click Mobility design.
2. Click the Forms tab.
3. In the list, find and select the desired record.
4. Click Edit.
5. If you add a control, it is positioned before the selected control on the form.
  On the preview, select the desired control.
 

Note: If the control list is shown instead of the preview, in the list, find and select the desired control.

6. On the Properties tab, click Add.
7. Click Data grid.
8. Sub-task: Define control properties.
  8.1 In the Control field, type the data grid name.
 

Note: Only use letters and numbers, no spaces.

  8.2 You can use an index to indicate which row in the grid must be selected when the grid is shown on a mobile device.
  In the Selected index field, enter a number.
 

Note: Index numbering starts from 0. So, if the index is 0, the first row is selected.

  8.3 By default, the data grid is shown on the form.
  If you want to hide the data grid on the form, select No in the Visible field.
  8.4 By default, the data grid can be used on the form.
  If the data grid must be unavailable on the form, select Yes in the Read-only field. As a result, the data grid appears dimmed.
  8.5 By default, the next control is positioned on the same line.
  If the next control must be positioned on a new line, select Yes in the Append new line field.
  8.6 On a data grid, you can use a variable as defined for the application or for the form.
By default, this field is empty. So, in the Linked variable name field, you can link an application variable to the data grid.
  To link a form variable, in the Linked variable form field, enter or select the current form.
  8.7 You can link an application variable or a form variable to the check box.
  In the Linked variable name field, enter or select a value.
 

Note: Make sure, the extended data type of the variable has the same type as the control.

  8.8 Define the data set for the data grid. The data set gets the data to be shown in the data grid.
  In the Data set field, enter or select a value.
  8.9 You can use the Preview field to enter some example data. This data is only used to be shown in the preview.
Use commas to separate the preview values for the columns. To show several records with preview data in the data grid, start a new line for each data grid record.
Example:
The data grid has these columns: Item, Quantity, Unit.
Preview values:
ItemA, 12, pcs
ItemB, 7, pcs
  In the Preview value field, type the example values.
9. In the Documentation section, write the data grid control documentation. For example, describe the purpose and characteristics of the data grid control.
10. To show the added control on the preview, on the Design tab, click Refresh.

Notes

  • In general, if you add a form control, it is positioned before the selected control on the form.
  • Where the control is exactly positioned on the preview, also depends on:
    • The Append new line property of the previous control and of the added control.
    • The preview style sheet.
  • You can use the Up and Down buttons on the Properties tab to move a form control to another position on the form.

Related to Notes

Data grid

 

Provide feedback