Skip to content
D
Documentation

Default layouts

reference
3 min readUpdated

Default layouts

A default layout is the layout string assigned to one list number. Administrators select a list, retrieve or edit its layout, and save the value.

If you need to…Go to
Open the form or its related user-specific layout pageOpen Default layouts
Identify the required fields and list choicesFields
Retrieve, format, reset, or save a layoutActions
Maintain one list's default layoutMaintain a default layout
Maintain user-specific layoutsUsers layouts

Before you start

You need the list number and layout value you want to maintain. List num and Layout are required, and the form validates both before save processing.

Have or knowWhy it matters
The list numberGet layout uses the selected List num value.
The layout stringLayout must contain a value before a valid save can proceed.
The required save behaviourSave saves and remains on the form; Save and Close saves and leaves the form.

Open Default layouts

Default layouts is the configuration form for maintaining a list's default layout. User-specific layouts are maintained on the related Users layouts page.

Prerequisites

  • You have access to the configuration area.

Steps

  1. In the configuration area, select Default layouts.
  2. Select Users layouts when you need the related user-layouts page.

Result:

The selected page is open.

The Default layouts form with its two fields and action controls

Understand the screen

The form contains two required fields: List num and Layout. Both fields belong to the form's validation group.

FieldTypeRequiredUse
List numSelect boxYesChoose the list whose default layout you maintain.
LayoutText areaYesEnter or edit the layout string.

Layout is editable. Its text area has a fixed height of 350, does not resize automatically, and selects its text when it receives focus. The screen has no grid, configurable field, tab group, or embedded feature surface.

Fields

Each List num option shows a display name and numeric ID. The options run from Activities (0) to Outgoing Paymnet (126); examples include Registeration data (3) and Job Profitabilty (123).

The expanded List num options, from Activities (0) through Outgoing Paymnet (126)

Actions

ControlUse
Users layoutsOpen the related user-layouts page.
StringfyRemove line breaks and whitespace outside quoted strings from Layout.
ResetReplace the current layout with a new default layout.
Get layoutRetrieve the default layout for the selected list number.
SaveSave and remain on the form.
Save and CloseSave and leave the form.

Get layout is disabled when List num has no value. Both Stringfy and Reset leave the page on Default layouts without opening a dialog or showing a toast.

The formatting, reset, retrieval, and save actions around the form

Maintain a default layout

Retrieve or edit the default layout for one list number.

Prerequisites

  • You know which list number to maintain.
  • You have the layout string to enter or the saved configuration to edit.

Steps

  1. In List num, select the list number.

  2. Select Get layout.

  3. In Layout, edit the layout value.

  4. Select the action that matches your need:

    If you need to…Select
    Remove line breaks and whitespace outside quoted stringsStringfy
    Replace the current layoutReset
    Save and remain on the formSave
    Save and leave the formSave and Close

Result:

The selected list's layout is retrieved or edited, and the chosen action is applied.

The form after Get layout loads the selected list

Handle validation and request outcomes

The form checks both required fields before save processing. If a required value is missing, the field can show This Field Is Required. A successful request uses Your request was completed successfully; an error uses An error occurred while processing your request.

Know what’s next

Select Users layouts to maintain layouts associated with users rather than with a selected list number.

The Users layouts destination reached from Default layouts

Was this page helpful?

Need help using the product?