1. Manufacturing
  2. Anywhere Mobility Studio
  3. Setting up and designing Anywhere mobility studio
  4. Design application configuration
  5. Design form controls

Data grid

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

To fill the data grid, a data set is required. Compared to the configurable grid, you must develop the required data set for the data grid. So, coding is required to create the data set that queries your data. You use the data grid, for example, for lists that are based on enums instead of data.
You must also configure the data grid columns.
If your company uses different types of mobile devices, controls can require a different layout for each device.


Designer Designer Developer Developer Start Start Is a data set required  other than the  predefined data sets? Is a data set required  other than the  predefined data sets? Inform developer on  data set class to be developed Inform developer on  data set class to be developed Develop data set class Develop data set class Use a data set on a form control of type Data grid. The data set gets the data to be shown in the data grid. For a data set, a class is required. To develop this class, extend the DAWQueryMethodRun class. Prerequisite: Develop the extension of the DAWQueryMethodRun class in the AOT before you start the steps.Note: The steps are to have the developed data set class uploaded as data set to the related library. Procedure 1. Click Mobility design. 2. Click the Libraries tab. 3. In the list, find and select the desired record. 4. Click View. 5. Click the Data sets tab. 6. Click Refresh. 7. Close the page. Notes If you deploy (export/import) an application as built in Mobility studio, make sure the related custom data set classes are deployed as well. You can do so with a Microsoft Dynamics Lifecycle Services project. Inform designer that  the data set is available  in the library Inform designer that  the data set is available  in the library Update application libraries Update application libraries In your application design, you can only use the libraries and library elements that are linked to the application. An application library defines which library elements can be used in the application design. Library elements are: actions, functions, and data sets.You link libraries to an application in several ways:Add manuallyYou manually add a library to an application to make it available for use in the application.Link automaticallyIf you have imported an application, the used libraries are not linked automatically. To make the used libraries available for the application, you must link these. Only the libraries are linked of which at least one action, function, or data set is used in the application.Note: If you link libraries, and an already linked library is not used in the application, it is removed from the linked libraries.If a linked library is updated, for example a new action class is created, you must refresh the libraries to have the updates available for the application. To do so refer to: Manage libraries. Procedure 1. Click Mobility design. 2. On the Applications tab, click Edit. 3. Click the Libraries tab. 4. Sub-task: Manually add library to application. 5. Click Add. 6. In the Library field, enter or select a value. 7. Click Save. Note: As a result, all current actions, functions, and data sets of the library are added to the application. 8. Sub-task: Link used libraries to application. 9. If you have imported an application, you must link the used libraries to the application. Click Link libraries. Note: You can also use this to clean up the list of linked application libraries. The libraries that are not used in the application, are removed from the linked libraries list. 10. Close the page. Create form control:  Data grid Create form control:  Data grid 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. 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. 9. In the Control field, type the data grid name. Note: Only use letters and numbers, no spaces. 10. 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. 11. If you want to hide the data grid on the form, select No in the Visible field. 12. 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. 13. If the next control must be positioned on a new line, select Yes in the Append new line field. 14. To link a form variable, in the Linked variable form field, enter or select the current form. 15. 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. 16. In the Data set field, enter or select a value. 17. In the Preview value field, type the example values. 18. In the Documentation section, write the data grid control documentation. For example, describe the purpose and characteristics of the data grid control. 19. 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. Configure grid Configure grid Configure the columns of the data grid. You can only add columns that are also defined as fields in the data set. Ask the developer of the data set class for the exact names. Procedure 1. Click Mobility design. 2. Click the Forms tab. 3. In the list, select a form. 4. Click Edit. 5. On the Controls tab, select a control of type Data grid. 6. Click the Grid configuration tab. 7. Click Add. 8. In the Label field, select the label for the display name of the column. Note: If no label exists, you can click Generate labels from text. as a result, for all fields without a label defined, a label is created based on the value in the text field. Before you create labels from text, define the known labels for the fields. 9. In the Grid column width field, define the width of the column expressed in a number of pixels. Note: Enter a width of 0 to hide the column. 10. In the Data set column mapping field, type the struct field that is used for this column. 11. To link a form variable, in the Linked variable form field, enter or select the current form. 12. In the Linked variable name field, enter or select a value. 13. If a variable is defined, the label of the related extended data type can be used as display name for the column. By default, the label of the extended data type is not used. If you want to use the label of the extended data type, select Yes in the Get caption from extended data type field. Note: If you use the label of the extended data type, do not fill in the Label ID. 14. Close the page. Is a  device-specific  control layout  required? Is a  device-specific  control layout  required? Make control layout device-specific Make control layout device-specific If your company uses different types of mobile devices, controls can require a different layout. For example, longer labels do not fit properly on a smaller screen. So, you can define a smaller version of such a label for these small-screen mobile devices. Procedure 1. Click Mobility design. 2. Click the Forms tab. 3. In the list, find and select the desired record. 4. Click Edit. 5. On the preview, click the desired control. Note: If the control list is shown instead of the preview, in the list, find and select the desired control. 6. Click the Device/localized specific tab. 7. Click Add and fill in the fields. 8. Close the page. End End Yes No Yes No

Activities

Name Responsible Description

Develop data set class

Developer

 		Use a data set on a form control of type Data grid. The data set gets the data to be shown in the data grid.
For a data set, a class is required. To develop this class, extend the DAWQueryMethodRun class.
Prerequisite: Develop the extension of the DAWQueryMethodRun class in the AOT before you start the steps.
Note: The steps are to have the developed data set class uploaded as data set to the related library.

Update application libraries

Designer

 		In your application design, you can only use the libraries and library elements that are linked to the application. An application library defines which library elements can be used in the application design. Library elements are: actions, functions, and data sets.
You link libraries to an application in several ways:
  • Add manually
    You manually add a library to an application to make it available for use in the application.
  • Link automatically
    If you have imported an application, the used libraries are not linked automatically. To make the used libraries available for the application, you must link these. Only the libraries are linked of which at least one action, function, or data set is used in the application.
    Note: If you link libraries, and an already linked library is not used in the application, it is removed from the linked libraries.
If a linked library is updated, for example a new action class is created, you must refresh the libraries to have the updates available for the application. To do so refer to: Manage libraries.

Create form control:  Data grid

Designer

 		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.

Configure grid

Designer

 		Configure the columns of the data grid. You can only add columns that are also defined as fields in the data set. Ask the developer of the data set class for the exact names.

Make control layout device-specific

Designer

 		If your company uses different types of mobile devices, controls can require a different layout. For example, longer labels do not fit properly on a smaller screen. So, you can define a smaller version of such a label for these small-screen mobile devices.

Provide feedback