Grid layout - Operations tab

The row editing mode sets the default presentation and behavior configuration for a grid, determining how users view and edit properties.

Select one of the following row editing options, each of which are described below: None, Inline, Master-detail.

Default behaviors, configured on the Actions tab,are defined for Inlineand Master-detail row editing formats. See About Grid Actions and the Actions tab for more information.

None

Select if the row's data cannot be edited. You can allow the user to display the flow action's fields (read only) by selecting the Show Details option on this tab, under Grid Operations.

If the data source is a Report Definition, this is the default value and cannot be edited. You can add express action buttons to the grid, which gives the user access to actions on the object represented by that row, such as opening a work item or a local flow action.

Appears when you select Inline. Select an inline edit mode:

Click a row to edit: When the user double-clicks a row, the editable fields in that row display as editable.

Rows always editable Editable fields display the data in input boxes.

Master-detail

Select to display row details in:

• Modal dialog: When the user clicks a row, the editable fields for the flow action appear in a modal window on top of the data display. When the modal window is dismissed, the edits are applied.
• Expandable rows: When the user clicks a row, the flow action's editable fields populate a detail area below the selected row. When the user saves the edits or selects another row, the edits are applied.
• Embedded elsewhere: When the user clicks a row, editable fields for the flow action populate a detail area below the grid. When the user saves the edits or selects another row, the edits are applied.

Click Open template to open the section used to render the layout. By default, the templates are standard rules .pyGridModalTemplate, .pyGridDetails , and .pyGridRowDetails, respectively. To create custom templates, copy these rules into your Applies To class. Do not change the Purpose.

Select a format for the modal dialog. The default is Standard. To specify a custom format defined

in the skin, select Other. Press the down arrow in the field that displays to select the format that you want to use.

Appears if you select Master-detail as the Row editing operation or you select None as the Row editing operation and you select the Show Details checkbox, under Grid Operations.

Select or create the flow action that will provide the form for the modal dialog or detail area that appears when the user clicks a row.

Appears if you select Master-detail as the Row editing operation.

Select to allow the user to view the flow action details in read-only mode, which prevents locking the work item (Work- or Assign- item) when it opens.

Appears if you select Master-detail as the Row editing operation and select to display details in Expandable rows. Also displays if you select None as the Row editing operation and you select the Show Details checkbox, under Grid Operations.

Select to display an Expand/Collapse column at the far left of the grid at runtime. The column displays the following icon in each row of the grid:

The Expand/Collapse column is optional; users can click in the row to expand or collapse the pane, or you can insert a button, icon, or link anywhere in the row to enable expand and collapse. If you deleted the default Edit Item action from the Expand Pane edit mode, then select this column to use Expand Pane.

Appears if you select Master-detail as the Row editing operation and select to display details in Expandable rows.

Select Default, to display details after the grid, or select In place of a section to specify the section in which you want the details to appear. For example, assume you want the detail area to appear to the right of the grid instead of below it (default). Create a section (named gridResults) containing a two-column layout. Embed the grid in the first column and an empty section in the second column. Specify the name of the empty section here.

Select to allow users to sort the rows on a column in the grid. This setting applies to all columns. You can disable sorting for individual columns by clearing the Enable Sorting checkbox in a column's Cell Properties panel. Sorting is not available for columns containing images, or controls such as buttons (but can include links). This setting overrides the Sort Type settings on Report Definition form's Design tab. For instance, if there are no settings that form, the Sorting selection here enables sorting on the grid.

A tool tip appears at runtime when the user hovers the mouse pointer over the column header. Clicking the header sorts the rows in the column. When sorted, an icon indicating an ascending or descendingsort order appears to the right of the header label text. The user can alternate the sort order by clicking the header again. You can use the Skin rule to replace the default icons.

Sorting is performed on all rows in the grid. If Paging is enabled and the user changes the sort order, the grid view returns to the first page.

Select to allow users to show only those rows that match a column value filter. This setting enables filtering for all columns that include a property. You can set filter types or disable filtering for individual columns using the Filtering options in the Column Properties panel.

If a column can be filtered, a filter icon appears on the right side of the column's header cell. The user clicks the icon to display the filter pop-up menu. On the menu, the user selects the checkbox next to each property to include.

Filtering mechanisms also appear in the menus for the following property types. These filtering criteria override checkbox selections.

• Date types (Date and DateTime) — Define a date range in the From and To fields.
• Text — Enter free-form text in the abc field.
• Numeric types (Integer, Decimal, and Double) — Define a range by entering numeric values in the greater than and less than fields.

When finished, the user clicks Apply. The filter icon changes to a filter-on icon () indicating that a filter is applied to the column.

You can use the Skin rule to replace the default icons.

Note the following:

• — Columns containing images, most action controls such as buttons or icons, hidden controls (pxHidden), prompt select controls, and subsections cannot be filtered. Columns can include links.
• — Filtering on Text properties that are obfuscated in edit-mode return results based on unfiltered data. Filtering should be disabled.
• — For date types, leaving a From or To field blank means to include everything preceding or following the single limit. For example, if you enter From12/15/2011 and leave To blank, all dates on or after 12/15/2011 are included.
• — For numeric types, leaving a greater than or less than field blank means to include everything preceding or following the single limit. For example, if you enter less than500 and leave greater than blank, all numbers less than 500 are included.
• The following property types cannot be filtered:
  
  • TextEncrypted
  • Password
  • TimeOfDay
  • Identifier
• Entering a From or To range or search text overrides checkbox selections; these selections are not included in the filter.

Select to allow users to move objects higher or lower on the display by dragging and dropping individual rows. Depending on the properties of the objects the rows represent, rows may be moved above or below other rows, or dropped into a row that can receive them to become child entries of that row.

Unavailable if source is Report Definition.
Visual indicators give clues about the process: a line appears between two rows in the list if that is where the row you have started dragging will appear if you release it. A row that can receive the row you have selected as a child will change background color. If your mouse cursor is over an area where you cannot drop the row you have selected, an indicator will remind you that the area is not a valid target. If you attempt to drop the row there, the display will remain unchanged.

Select to allow users to adjust the width of columns on the display by dragging individual columns to the left or right.

Appears if the source of the grid (specified on the General tab) is a Report Definition and the Row editing operation on the Operations tab is None.

Select if you want categorize grid rows based on columns within the grid. You can select the columns by which you want to categorize the grid, and specify sorting and ascending or descending order on the column properties panel of the column within the grid.

Note: Categorizing all columns within a grid would not yield any data columns at runtime.

Appears if you select the Categorize grid rows checkbox. By default, the pzGridCategoryHeader template is applied.

Select this checkbox if you want to specify a custom category template in the field that displays.

Select to allow the user to click a row and display its flow action details beneath the row in read-only mode. The user can expand multiple rows. Enter the flow action in the Flow Action field.

Appears if you select Master-detail as the Row editing operation and select to display details in Embedded elsewhere.

Select this checkbox if you want the first row to display as selected when the grid initially loads.

Appearsif you select Master-detail as the Row editing operation and select to display details in Expandable rows.

Select to enable users to expand more than one row at a time.

Appears if Show Details is selected. Select to display details for all rows when the user opens the form.

The system uses existing grid actions to determine whether to set focus to new rows.