# Default layouts

## 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 page | [Open Default layouts](#open-default-layouts) |
| Identify the required fields and list choices | [Fields](#fields) |
| Retrieve, format, reset, or save a layout | [Actions](#actions) |
| Maintain one list's default layout | [Maintain a default layout](#maintain-a-default-layout) |
| Maintain user-specific layouts | [Users layouts](#know-whats-next) |

## 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 know | Why it matters |
|---|---|
| The list number | **Get layout** uses the selected **List num** value. |
| The layout string | **Layout** must contain a value before a valid save can proceed. |
| The required save behaviour | **Save** 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](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2c6a60c7558a40d445cfafa737314416.png)

## Understand the screen

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

| Field | Type | Required | Use |
|---|---|---:|---|
| **List num** | Select box | Yes | Choose the list whose default layout you maintain. |
| **Layout** | Text area | Yes | Enter 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)](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4c5b2e8c6114f8ac65255bda006a8243.png)

### Actions

| Control | Use |
|---|---|
| **Users layouts** | Open the related user-layouts page. |
| **Stringfy** | Remove line breaks and whitespace outside quoted strings from **Layout**. |
| **Reset** | Replace the current layout with a new default layout. |
| **Get layout** | Retrieve the default layout for the selected list number. |
| **Save** | Save and remain on the form. |
| **Save and Close** | Save 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](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/b20f26ed86d4896a6a8371dd9b523f32.png)

## 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 strings | **Stringfy** |
   | Replace the current layout | **Reset** |
   | Save and remain on the form | **Save** |
   | Save and leave the form | **Save 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](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/431e8358c6636506e23cc3f6c1fecd4a.png)

## 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](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/7a877152c98ade8edc68ccee027c95b4.png)
