Editable Grid Row Component

About the editable grid row component

Displays a row of components within an editable grid (a!gridLayout).

Where to use the editable grid row component

Use a!gridRowLayout() in the rows parameter of an editable grid (a!gridLayout()).

Supported components

The contents parameter of a!gridRowLayout() supports only the following components:

• a!barcodeField()
• a!buttonArrayLayout()
• a!checkboxField()
• a!booleanCheckboxField()
• a!dateField()
• a!dateTimeField()
• a!dropdownField()
• a!floatingPointField()
• a!encryptedTextField()
• a!fileUploadField()
• a!imageField()
• a!integerField()
• a!linkField()
• a!multipleDropdownField()
• a!paragraphField()
• a!pickerFieldCustom()
• a!progressBarField()
• a!radioButtonField()
• a!recordActionField()
• a!richTextDisplayField()
• a!tagField()
• a!textField()

Parameters

a!gridRowLayout( contents, id, selectionDisabled, showWhen )

Name	Keyword	Types	Description
Contents	contents	List of Variant	Array of components to display in the grid cell. Supported components: Barcode, Buttons, Checkbox, Boolean Checkbox, Date, Date & Time, Dropdown, Decimal, Encrypted Text, File Upload, Image, Integer, Link, Multiple Dropdown, Paragraph, Pickers, Progress Bar, Radio Buttons, Record Action Field, Rich Text Display, Tags, and Text.
Identifier	id	Any Type	Value that uniquely identifies this row for selection.
Selection disabled	selectionDisabled	Boolean	When selection is enabled, determines if the selection checkbox is disabled for this row. Default: false.
Show When	showWhen	Boolean	Determines whether the row is displayed in the grid. When set to false, the row is hidden and is not evaluated. Default: true.

Using the editable grid row component

The following sections cover important details about the editable grid row component.

Component behavior

• Some interface component configurations do not take effect when placed in a grid cell. Refer to the grid layout section for details.

Examples

See Editable Grid Component for examples.

Feature compatibility

The table below lists this component's compatibility with various features in Appian.

Feature	Compatibility	Note
Portals	Compatible
Offline Interfaces	Compatible
Sync-Time Custom Record Fields	Incompatible
Real-Time Custom Record Fields	Incompatible	Custom record fields that evaluate in real time must be configured using one or more Custom Field functions.
Process Reports	Incompatible	Cannot be used to configure a process report.
Process Events	Incompatible	Cannot be used to configure a process event node, such as a start event or timer event.
Process Autoscaling	Incompatible	Cannot be used in autoscaled processes.
Event Consumer Filter Conditions	Compatible	Can be used in filter conditions.
Event Consumer Event Handlers	Compatible	Can be used in event handler expressions.

Related recipes

The following recipes include usage of the Editable Grid Row Component.

• Add Validations to an Inline Editable Grid (Validation, Grids, Looping):

  Allows the user to change data directly in a grid, and validate a various entries.

• Add, Edit, and Remove Data in an Inline Editable Grid (Grids, Looping):

  Allow the user to change data directly in an inline editable grid.

• Display Multiple Files in a Grid (Document Management, Grids):

  Show a dynamic number of files in a grid and edit certain file attributes.

• Expand/Collapse Rows in a Tree Grid (Hierarchical Data, Grids):

  Create a grid that shows hierarchical data and allows users to dynamically expand and collapse rows within the grid.

• Track Adds and Deletes in Inline Editable Grid (Grids):

  In an inline editable grid, track the employees that are added for further processing in the next process steps.

• Upload Multiple Documents in an Editable Grid (Document Management, Records):

  Build a form that allows users to create a record and upload related documents in an editable grid.

• Use Selection For Bulk Actions in an Inline Editable Grid (Grids):

  Allow the user to edit data inline in a grid one field at a time, or in bulk using selection.

Feedback