Webitel: Documentation

Columns (Custom lookups)

1. Description

Allows configuring the structure of fields in a custom lookup (Fig. 1).

Important! This tab becomes available only after saving data in the General tab.

The tab consists of the following elements (Fig. 1):

  1. Columns registry (Fig. 1.(1));

  2. Save button (Fig. 1.(2));

  3. Close button (Fig. 1.(3));

  4. Search field (Fig. 1.(4));

  5. Add column tool (Fig. 1.(5));

  6. Delete tool (Fig. 1.(6)).

Columns - Custom lookups -20260224-103200.png
Fig. 1. Columns tab

1.1. Columns registry

The registry (Fig. 1.(1)) displays a list of all columns in the lookup:

  • Checkbox column;

  • Title column;

  • Type column;

  • Position column;

  • Move tool;

  • Edit tool;

  • Deletion tool.

After creating a lookup, the system automatically adds the following base fields:

  • ID;

  • Created on;

  • Created by;

  • Modified on;

  • Modified by;

  • Name;

  • Description.

Important!

  • System columns cannot be edited or moved, except for the Description column and any manually created columns.

  • System columns can be deleted only via the checkbox.

1.1.1. Checkbox column

Used to select one or more entries. An additional removal tool appears next to the search field after selecting one or more entries. Information about the number of entries chosen for deletion appears when you hover over this tool. When you click on it, a modal confirmation window appears.

It contains the Yes, No, and close ( image2024-3-7_15-21-56.png ) buttons.

  • Clicking the Yes button deletes the entries.

  • Clicking the No button closes the modal window, and the entries are not deleted.

All records on the page will be selected if you select the checkbox in the header.

Confirm deletion modal window.png


Fig. 2. Confirm deletion modal window

1.1.2. Title column

Displays the name of the column that will be shown to users in the lookup.

  • For system columns, the title is predefined and cannot be changed.

  • For custom columns, the title is set during creation or editing.

1.1.3. Type column

Shows the type of data that will be stored in the column.

1.1.4. Position column

Displays the sequential order number of the column in the table.

  • For custom columns, the position can be adjusted manually using the move tool.

  • The position defines the display order of columns in the lookup form.

Important! The position of system columns cannot be changed.

1.1.5. Move tool

The icon image-20250818-122217.png allows you to change the display order of fields in the table by dragging and dropping.

1.1.6. Edit tool

The icon %D0%9A%D0%BD%D0%BE%D0%BF%D0%BA%D0%B0%20%D1%80%D0%B5%D0%B4%D0%B0%D0%BA%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D1%82%D1%8C.png?version=2&modificationDate=1708702071712&cacheVersion=1&api=v2&width=20&height=25 is used to modify the column title. After clicking it, a modal window opens (Fig. 3).

Edit column.png
Fig. 3. Edit column

1.1.7. Delete tool

The icon 20f61797-97ac-4f64-bb72-6de44110a55d is used to permanently remove a column from the configuration. After clicking it, a confirmation modal window opens (Fig. 4).

Confirm__deletion.png
Fig. 4. Confirm deletion modal window

1.2. Save button

After making changes, click the Save button (Fig. 1.(2)). Without clicking the button, the changes are not saved.

1.3. Close button

The Close button (Fig. 1.(3)) exits the tab and returns the user to the Custom lookups tab.

1.4. Search panel

The search field (Fig. 1.(4)) allows you to quickly find a column by its title.

1.5. Add column tool

To create a new column, click the icon image-20250818-120551.png (Fig. 1.(5)).

A modal window Add column (Fig. 5) will open. It contains the following elements:

  • Title field;

  • Code field;

  • Type field;

  • Object field;

  • Required switch;

  • Default value field.

  • The Add button creates a new column and adds it to the configuration.

  • The Close button closes the window without saving changes.

Add column.png
Fig. 5. Add column modal window

1.5.1. Title field

Required field, the name of the field.

1.5.2. Code field

Required field. A unique identifier that may include only Latin letters (A–Z, a–z) and digits (0–9) and must start with a letter.

Important! Reserved system values must not be used:

  • bool;

  • bytes;

  • double;

  • null_type;

  • int;

  • list;

  • map;

  • string;

  • type;

  • uint.

If one of these values is entered, the system will display an error and will not allow the column to be saved.

1.5.3. Type field

Required field. A parameter that defines the data format stored in the column. Available options:

  • Text — a field for text values;

  • Number — a field for numeric values;

  • Select — a list allowing the user to choose only one value;

  • Multiselect — a list allowing multiple values;

  • Calendar — a field for selecting a date;

  • Boolean — a switch that allows you to set two states: enabled image-20250818-125907.png / disabled image-20250818-125933.png .

1.5.4. Object field

Selection of another lookup whose values will be used when filling this field.

Displayed only if the Type parameter is set to Select or Multiselect.

1.5.5. Required switch

The switch is displayed after selecting the field type (except for the Boolean type).

Enabling the switch image-20250818-125907.png means that the field becomes mandatory to fill in.

1.5.6. Default value field

Displayed after enabling the Required switch.

The field is mandatory to fill in.

The default value type corresponds to the selected custom field Type (text, number, select, multiselect, calendar).

Default value application logic:

  • for existing lookup records where the required field is not filled in, the default value is automatically applied;

  • for existing lookup records where the field is already filled in, the current value is preserved and not changed;

  • for new lookup records, the default value is automatically applied when the record is created.

1.6. Delete tool

Used to delete a column with confirmation via a modal window. It becomes active after selecting the checkbox next to a column.

When hovering over the delete button 20f61797-97ac-4f64-bb72-6de44110a55d , a tooltip with the tool name appears image-20251106-225214.png . After clicking, a confirmation modal window opens (Fig. 6).

Confirm__deletion.png
Fig. 6. Confirm deletion modal window

Clicking Yes deletes the column and all its records. Clicking No closes the modal window without deleting the column.

2. Opportunities

2.1. Add column

Goal

Add a new column

Preconditions

  1. Access to the CRM application;

  2. Access to the Custom lookups partition;

  3. Permission to create or edit in the Custom lookups partition;

  4. At least one lookup exists, or a new one is created.

Steps:

 

  1. Click the add button image-20250211-133952.png . A modal window Add column will open.

  2. Enter the required data.

  3. Click the Save button.

Result

The modal window closes. The data is saved. The column is added to the registry.

2.2. Delete column

Goal

Delete a column

Preconditions

  1. Access to the CRM application;

  2. Access to the Custom lookups partition;

  3. Permission to create or edit in the Custom lookups partition;

  4. At least one lookup exists or a new one is created.

  5. At least one column is present in the registry.

Steps:

 

  1. Find the column that needs to be deleted.

  2. Click the delete button image-20250213-111620.png . A confirmation modal window will open.

  3. Click Yes.

Result

The modal window closes. The column is deleted.

2.3. Delete several columns

Goal

Delete several columns

Preconditions

  1. Access to the CRM application;

  2. Access to the Custom lookups partition;

  3. Permission to select and delete in the Custom lookups partition;

  4. At least one lookup exists or a new one is created.

  5. At least one column is present in the registry.

Steps:

 

  1. Find the columns to delete and select them using checkboxes.

  2. Click the delete button at the top of the registry. A confirmation modal window will open.

  3. Click Yes.

Result

The modal window closes. The selected columns are deleted.

2.4. Edit column

Goal

Edit a column

Preconditions

  1. Access to the CRM application;

  2. Access to the Custom lookups partition;

  3. Permission to create or edit in the Custom lookups partition;

  4. At least one lookup exists or a new one is created.

  5. At least one column is present in the registry.

Steps:

 

  1. Find the column that needs editing.

  2. Click the edit button. A modal window Edit column will open.

  3. Make changes — the Save button becomes active.

  4. Click Save.

Result

The data is saved.