1. Home
  2. Forms
  3. Form Fields & Components
  4. Form Fields & Components: View

Form Fields & Components: View

A View component allows a designer to embed a view in to a form. The view must be from the same application, but it does not have to display records that relate to the current form. An example would be for an sales opportunity or CRM application, there might be a contact form that stores information of a contact at a company. In this form you might want to display a list of the tasks or sales opportunities you have that relate to this contact. You could do this by adding a View component and setting it to display the tasks or sales opportunities views.

An example of a View component
Table Component

Adding a View to a Form

To add a View component, drag it from the left side palette onto the desired location on the form. As views tend to be wide, it is best to put them so they display in the full width of your form, and not in a 2, 3 or 4 column container.

Once the View component has been dropped onto the form a dialog box will appear that asks for which view to display. Select the desired view and click on ‘Add Field’. Once the view component had been added, it is not possible to change which view is displayed. To change the displayed view, you will need to deleted the current view component and add another one displaying the new view.

View Component – View Selection
Table Component Columns

View Component Properties

The properties panel allows the App Designer to further customize the table.

SettingDescription
Basic Tab / General Section
Display NameIf you would like the view to have a text header, enter the desired text here.
DescriptionIf you would like the view to have a text description, displayed in smaller font below the Display Name, enter the desired text here.
Basic Tab / Filters Section
Filter by Current RecordThis setting will filter the view based on the selected field on the current record that you are on.
field selection dropdownThis dropdown field will show the fields that directly link these two record types. These will be Dropdown or Lookup Fields field types where the selected value is looked up from another record, and that other record is of the form type displayed in the selected view. For example: If we are on a contact form and have selected a view that displays opportunity records, and the opportunity form has a dropdown field to pick the associated contact by looking up contact records, then that associated contact field would display in the field selection dropdown.
FiltersAllows to you to filter which records will be displayed in the view. For example, only showing Service Reps that work in the same state as listed in the “Customer Location State” field on the same record. Any filter added here will work in conjunction with any filter set by the ‘Filter by Current Record’ option, if there is one.

See Form Fields & Components:  Lookup Filters for more details on setting a lookup filter.
View Component – Filters
Creating a Table Component
SettingDescription
Basic Tab / Table Properties Section
Table HeightThe display height of the embedded view on the form. Select between:
– Default (smallest height)
– Medium
– Large
– X-Large
Show CreateEnabling this option will show the create new records button (+ icon) at the top of this embedded view.
Prefill FormAllows you to define fields on the current form whose values will be copied into fields on new record created by clicking the create new records “+” button at the top of the view. The mapping will only allow fields with similar data types to be mapped together.

Click on ‘Add Field Map’ to add a new pair of mapped fields: A field on the current form you have embedded the view on, and a field on the form of the records displayed in the selected view.
Show DeleteEnabling this option will show the delete records button (trash can icon) at the top of this embedded view.
Show SearchEnabling this option will show the search view button (magnifying glass icon) at the top of this embedded view.
Show View LinkEnabling this option will show the view link button (link icon) next to the view’s Display Name at the top of this embedded view. Clicking on the View Link will open the view full screen in GW Apps.
Show Record SelectionEnabling this option will show the record selection check-boxes at the left of each row in the view, like in a normal non-embedded view. This option is disabled by default as you might only want to show users the related records and not have them take actions on selected records.
Allow Record RedirectEnabling this option will allow to directly navigate to a specific record by clicking on it in the embedded view. If this option is turned off, then
Advanced Tab / Conditional VisibilityConditional Visibility
View Component – Table Properties
Creating a Table Component

View Component Usage Example

Embedded View Usage Example
View Component Usage Example
Updated on February 22, 2023
Was this article helpful?

Related Articles