Mass Update Toolbar

The Mass Update toolbar toolbar provides the interface to change multiple rows for a selected column with a single action.

his toolbar is included by default in edit mode, based on the property emxFramework.ShowMassUpdate property, which is set to true by default in emxSystem.properties.

The functionality and the behavior of the Mass Update toolbar is exactly the same as the configurable edit table component. The following figure shows the header section with the Mass Update toolbar.



The UI objects related to mass update are described in this table.

Action Display Mode Description

View Mode (View All)

toolbar button

icon and text

This button is part of the regular page toolbar. The text and the icon for this button are changed to "View Mode" when the user clicks the "Edit Mode".

Column

option list

editable

This provides the list of columns that are editable in the current table view used in the structure browser. The user can pick any one of the columns for which mass update is required.

Value

textbox

editable

This text box provides the interface for the user to input to apply the changes. This field's input type changes, depending on the Input Type on the column, selected in the previous column option list.

Apply To Selected

button

button

Applies the entered value to the selected rows for the selected column.

Apply To All

button

button

Applies the entered value to all the rows for the selected column.

When entering values, the type ahead feature (see Design Considerations for Form Fields for details on how this feature works.

When the user enters a value (possibly using type ahead to select a prior value), then applies the change, the JPO:method defined by the Update Program and Update Function settings for the column is invoked. The Update Program Arguments setting on the column can be used to define arguments to pass to that JPO. The structure browser uses these settings on the column to support type-ahead:


  • TypeAhead
  • TypeAhead Program
  • TypeAhead Function
  • Update Program Arguments

If the input controls for a column vary based on how the row is created or edited, then that column is not available for mass update. The values for all of these settings (if used) must be the same for that column to be available for mass update.


  • Input Type
  • Add Input Type
  • Lookup Input type

For example, if a column has these settings defined, then it cannot be used for mass update:


  • Input Type=radiobutton
  • Add Input Type=listbox

However, if all input types are defined the same (for example, Input type=radiobutton, Add Input type=radiobutton, and Lookup Input type=radiobutton), then the column can be used for mass update.