How to Create Layouts With Dynamic Components

Dynamic components provide a declarative way for you to bind a component's content to fields from your data sources. They serve as the building blocks for UIs that dynamically change what content is shown and how it is presented based on rules that you define.

Dynamic components are listed in the Components palette under Dynamic Components (you can enter dynamic in the palette's filter field to locate them). When you use dynamic components to show or hide content, you're defining layouts, all of which show up on the Layouts tab (Layouts icon) in the Navigator.
Description of dynamic-components-installed.png follows
Description of the illustration dynamic-components-installed.png

You have the option of creating a layout from scratch on the Layouts tab, where you can choose your data source, create a rule set with your own layouts and display logic, then associate the rule set with a dynamic form or table. It's simpler though to start by adding a dynamic form or table to a page, then using quick starts to walk you through the basics.

Because a layout represents a set of data fields that can appear in one or more related dynamic components, you'll need to have your component's data source ready before you can work with layouts. Your data source can be a business object that stores your app's data or a service connection that receives data from REST APIs.

Here are the high-level steps you need to take to create a simple layout using a dynamic form or table:
To perform this action: See this:
1. Add a dynamic form or table to a visual application's page
2. Configure the rule set's display logic and layouts.

For each dynamic component, you usually have a default rule and an accompanying layout. This default set is created for you when you configure a dynamic component on a page using a Quick Start (or, when you create a rule set in the Layouts' Rule Sets tab). You can then add additional rules (with matching layouts) to cover other scenarios. The default set is displayed if none of the conditions you define are met.

Besides layouts that control what's displayed on a page, you can control how something's displayed by using templates to visually design the field's area in a dynamic form or table. You can also set fields to be read-only for specific users and updatable for others.

In addition to rule sets, fields, and templates, the Layouts tab provides access to variables, actions, events, and event listeners, much like what's available when you add standard components to a page:
Description of dynamicui-editors.png follows
Description of the illustration dynamicui-editors.png

You can use these dynamic component editors just as you would use the editors for standard components, for example, to define events that you can hook action chains to.