Add transient data entities to the UI

The extension element allows you to display Transient Data Entities with collection outputs that are part of the entity's extended data model. The field is based on a view of the transient data entity.

IMPORTANT!  
Before you add a transient data entity to the UI, you must:
  1. Define a transient data entity (see Create transient data entities) with a collection output (see Create On-demand Server Automation Scripts).
  2. Extend the data model of the base entity with the transient data entity (see Extend platform data entities with transient data entities).
  3. For App Data Forms and Form Driven Flows, explicitly add the extension to the form's or flow's data model.

To add a transient data entity element to the user interface:

  1. In the UI Designer's left panel, from the Data Templates section, select the extension template and drag it to the working area in the desired position. For more information, see Adding UI elements to the user interface.

  2. While the extension field is selected, fill in its properties in the right panel.
    PropertyDescription
    Select the Entity ExtensionSelect the name of the data model extension that you want to display.
    CollapseMakes the extension field collapsible and sets the heading of the collapsible panel.
    ViewThe name of the view of the transient data entity to be displayed. If left unchecked, the default view is used.
    No RefreshDoes not display the Refresh button on the view toolbar.
    No ToolbarDoes not display the view toolbar.
    Select Label Type
    • default - The extension's display name is used as a field label.
    • custom - Manually enter the text for the field label. You can also manually add translations for each platform language, by clicking the toggle translation button placed in the Enter the desired text field. In this case, you also need to choose a name for the resource key that will save this text in the Localization Resources page.
    Additional CSS classesWrite any CSS class names you wish to apply to the field. The classes must be defined in one of the form's associated Style Sheets.
    NOTE  
    You must press Space or Enter after typing a class name to confirm it.
  3. Click Apply changes to save the field's properties.
  4. Click Save and reload to save the form.

To modify an extension field, select it in the main area and edit its properties from the right panel.

To move an extension in the user interface or to delete it, see Moving and deleting UI elements.