Creating a New SuperList

Use the SuperList Designer to create a new SuperList.

A SuperList is a control that acts as a container for controls that are bound to data from a datasource. To create the SuperList, create a metadata file and add it to the SuperList control following these steps:

  1. From the menu, select Designers > New SuperList.
  2. In the dialog, enter the information and click Confirm:
    • File name – name for the SuperList, ending with the .slmeta extension.
    • View Name – name for the view
    • View style – choose from:
      • ListView – displays data from from your specified datasource in list format on your device screen.
      • FormView – displays a row of data from your specified datasource on your device.
      • GroupView – displays data from your datasource grouped by the column that you specify.

    The new view opens in the SuperList designer as shown.
    superlist_view

  3. (Optional) Add another view to the SuperList:
    1. Click Edit Views.
    2. Click Add.
    3. Enter a name for the new view, select the view type, and click Confirm.
      If there is more than one view available for the SuperList, you can select a view from the Views List dropdown next to the Edit Views button.
      When editing views, you can preview the view result by clicking Preview.
  4. Bind data to the control:
    1. Go to Properties panel and click the dataStructure icon.

      appbuilder_sl_data_structure
    2. Click Data Source.

      appbuilder_sl_add_data_source
    3. Select the data binding, and click Confirm.

      appbuilder_sl_select_databinding

      The Data Source for View window appears and lists available columns.

    4. In the Data Source for View window, configure the columns that you want to display in your superlist and assign controls:
      1. In the Navigation Parameters field, enter comma separated column names that you wish to pass to the next level list as drill-down navigation parameters.
        datasource_forview

        You can also double-click on each column name that you would like to specify as a navigation parameter to add them in the Navigation Parameters field.

      2. (Optional) Click the
        more_icon
        icon to modify the columns.
      3. (Optional) Click the drop-down arrow in the Control column to display the list of control types, and select one to bind to the specified column.
      4. Click Confirm to save your choices. The controls and associated column names are added to the form in the Designer.
    5. (Optional) While working in the SuperList Designer, you can add and configure a limited number of controls. Configure the display and behavior for the data and the controls for the columns you wish to include in your SuperList.
      You can add controls to your SuperList from the Form Designer or from the SuperList Designer. However, not all of the controls in the Toolbox palette are available from the SuperList Designer. See ToolBox for a list of the controls that are available while working in the SuperList Designer.
      1. In the form, select the control you wish to configure.
      2. In the Properties Panel, click the classes icon. The Class Definition window opens.
        class_definition
      3. Use any functions, column names, and any operators from the lists provided to create your expression in the Expression Definition field.
      4. Click Confirm to save your choices. Repeat these steps for each control you wish to configure.
    6. Select Return on the AppBuilder menu to exit the SuperList Designer.
  5. Click Toolbox.
  6. Drag and drop the SuperList control onto the form.
  7. In Properties, click the metaData File icon.
  8. Under the view folder, select the <file_name>.slmeta file and click Confirm.
    The data appears in the control on the form. After the metadata file is set, you can reconfigure the datasource in the Properties panel as needed.
Related tasks
Adding Controls to the Project
Creating a New Chart
Related reference
Configuring Controls in the Project
Toolbox
SuperList Designer