Views allow you to control how, when, and where data is presented to the app user, and how the user interacts with the data. Create and manage views from the UX >> Views tab of the app editor.

View Name

Each view needs a unique View name; no two views may have the same name. If a view is given the same name as another, the app editor will automatically add a number to its name to differentiate them.

For This Data

With the exception of dashboard views, each view is attached to a single table or slice (labeled For this data). Only data from the attached table or slice can be displayed within the view.

View Type

The View type determines how the data is presented to the app user. There are a variety of view types: chart, form, detail, map, table, and others. Each view type has its own characteristics and type-specific view options.

Position

The view's Position determines where the view is located in the app display. Positions include spots along the navigation bar at the bottom of the screen (e.g., left, center, and right), in the app's main menu (menu), or only when referenced implicitly while navigating through data (ref).

View Options

Each view type has type-specific view options that allow you to tailor the appearance of the view. For example, the view options for a table view are shown here:

Display Options

All view types have configurable display options. Display options affect how the view is presented in the navigation bar along the bottom of the app display, and in the app's main menu.

Icon

The view's Icon is displayed along with the view's Display name (see below). Choose an icon from the given list; custom icons are not possible. Every view must have an icon. If none is selected, a type-specific default will be used.

Display Name

The Display name allows you set the text used to refer to the view. The display name may be set to a fixed value by setting the toggle to pencil, or to a Text expression by setting the toggle to flask:

If Display name is not specified, or if set to an expression that evaluates to a blank value, the view's name itself is used.

Show If

Show if is a Yes/No expression that, if provided, determines whether the view is included as a navigation element in its designated Position (i.e., in the navigation bar or the main menu). If the expression evaluates to TRUE, the view will be included. For example:

No Show if expression is equivalent to the expression, TRUE .

Note that Show if is not a security measure! Show if merely hides the view from navigation; there are other legitimate ways for a user to access the view.

Behavior Options

Each view type has type-specific behavior options that may allow you to tailor the behavior of the view when the user interacts with it. The behavior options for a table view, for example, are shown here:

Event Actions

Some view types provide the opportunity to customize the app's response to certain events triggered by user activity. When a recognized view event occurs, the configured action is performed.

App Link

Not configuration, this section provides two ways to target the view from a navigation element:

  1. The first (LINKTOVIEW("By House") in this example) is a deep link to the view, to be used as the target of an action of type App: go to another view within this app.
  2. The second is a full URL for the view, to to be used a the target of an action of type External: go to a web site, or from a web browser.

Note that the use of app links is not affected by a view's Show if setting: a Show if expression that evaluates to FALSE does not prevent the use of an app link to the view.

Did this answer your question?