Webitel: Документація

Колонки (Користувацькі довідники)

1. Опис

Дозволяє налаштувати структуру полів користувацького довідника (Рис. 1).

Важливо! Вкладка стає доступною після збереження даних у вкладці Загальне.

Складається з таких елементів (Рис. 1):

  1. Реєстр колонок (Рис. 1.(1));

  2. Кнопка “Зберегти” (Рис. 1.(2));

  3. Кнопка “Закрити” (Рис. 1.(3));

  4. Поле пошуку (Рис. 1.(4));

  5. Інструмент додавання колонки (Рис. 1.(5));

  6. Інструмент видалення (Рис. 1.(6)).

Колонки - Користувацькі довідники-20260224-103139.png
Рис. 1. Вкладка “Колонки“

1.1. Реєстр колонок

У реєстрі (Рис. 1.(1)) відображається список колонок довідника:

  1. Колонка “Чекбокс”;

  2. Колонка “Заголовок”;

  3. Колонка “Тип”;

  4. Колонка “Позиція”;

  5. Інструмент переміщення;

  6. Інструмент редагування;

  7. Інструмент видалення.

Після створення довідника система автоматично додає базові поля:

  • “ID”

  • “Створено”

  • “Ким створено”

  • “Змінено”

  • “Ким змінено”

  • “Назва”

  • “Опис”

Важливо!

  • Системні колонки не можна редагувати або переміщувати, окрім колонкиОпис“ та колонок, створених вручну.

  • Системні колонки можна видалити лише через чекбокс.

1.1.1. Колонка “Чекбокс”

Використовується для вибору одного або кількох записів. Після вибору одного або кількох записів з’являється додатковий інструмент видалення біля поля пошуку. Інформація про кількість записів, вибраних для видалення, з’являється при наведенні на цей інструмент. Коли ви натискаєте на нього, з’являється модальне вікно підтвердження. Він містить кнопки "Так", "Ні" та кнопку закриття - image-2023-7-12_22-34-16.png . Натискання кнопки "Так" видаляє записи. Натискання кнопки «Ні» закриває модальне вікно, а записи не видаляються.
Якщо відмітити чекбокс у заголовку, то усі записи на сторінці будуть вибрані.

Модальне вікно Підтвердіть видалення (декілька об'єктів).png

Рис. 2. Модальне вікно “Підтвердіть видалення“

1.1.2. Колонка “Заголовок”

Відображає назву колонки, яка буде показана користувачам у довіднику.

  • Для системних колонок назва визначена автоматично та не може бути змінена.

  • Для користувацьких колонок заголовок задається під час створення або редагування.

1.1.3. Колонка “Тип”

Показує тип даних, що зберігатимуться у колонці.

1.1.4. Колонка “Позиція”

Відображає порядковий номер колонки у таблиці.

  • Для користувацьких колонок позицію можна змінювати вручну за допомогою інструмента переміщення.

  • Позиція впливає на порядок відображення колонок у формі довідника.

Важливо! Позиція системних колонок не змінюється.

1.1.5. Інструмент переміщення

Іконка image-20250818-122217.png дозволяє змінити порядок відображення полів у таблиці перетягуванням.

1.1.6. Інструмент редагування

Іконка %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 використовується для внесення змін до заголовка колонки. Після натискання на іконку відкривається модальне вікно (Рис. 3).

Модальне вікно "Редагувати колонку".png
Рис. 3. Модальне вікно “Редагувати колонку”

1.1.7. Інструмент видалення

Іконка 20f61797-97ac-4f64-bb72-6de44110a55d використовується для повного видалення колонки з конфігурації. Після натискання на іконку відкривається модальне вікно підтвердження (Рис. 4).

image-20250818-121541.png
Рис. 4. Модальне вікно “Підтвердіть видалення“

1.2. Кнопка “Зберегти”

Після внесення змін потрібно натиснути кнопку “Зберегти” (Рис. 1.(2)). Без натискання кнопки зміни не зберігаються.

1.3. Кнопка “Закрити”

Кнопка “Закрити” (Рис. 1.(3)) завершує роботу з розділом і повертає користувача до сторінки Користувацькі довідники.

1.4. Панель пошуку

Поле пошуку (Рис. 1.(4)) дозволяє швидко знайти колонку за заголовком.

1.5. Інструмент додавання нової колонки

Щоб створити нову колонку, натисніть іконку image-20250818-120551.png (Рис. 1.(5)).

Відкриється модальне вікно “Додати колонку” (Рис. 5), яке містить такі елементи:

  1. Поле “Заголовок”;

  2. Поле “Код”;

  3. Поле “Тип”;

  4. Поле “Обʼєкт“;

  5. Перемикач “Обовʼязковий“;

  6. Поле “Значення за замовчуванням“.

Кнопка “Додати” створює нову колонку і додає її до конфігурації, кнопка “Закрити” – закриває вікно без змін.

"Додати колонку".png
Рис. 5. Модальне вікно “Додати колонку“

1.5.1. Поле “Заголовок“

Назва поля, обовʼязкове поле.

1.5.2. Поле “Код“

Обовʼязкове поле. Унікальний ідентифікатор, який може містити лише латинські літери (A-Z, a-z) та цифри (0–9), починається з літери.

Важливо! Заборонено використовувати зарезервовані системні значення:

  • bool;

  • bytes;

  • double;

  • null_type;

  • int;

  • list;

  • map;

  • string;

  • type;

  • uint.

У разі введення одного з цих значень система відобразить помилку та не дозволить зберегти колонку.

1.5.3. Поле “Тип“

Обовʼязкове поле. Параметр, що визначає формат даних, які зберігатимуться у відповідній колонці довідника. Доступні варіанти:

  • Текст — поле для введення текстових даних.

  • Число — поле для збереження числових значень.

  • Вибір — список із можливістю вибору лише одного варіанту.

  • Мультивибір — список із можливістю обрати кілька значень.

  • Календар — поле для вибору дати.

  • Логічне — перемикач, який дозволяє задати два стани: увімкнено image-20250818-125907.png / вимкнено image-20250818-125933.png .

1.5.4. Поле “Обʼєкт“

Вибір довідника, дані з якого будуть використовуватися при заповненні.

Це поле з’являється лише тоді, коли для параметра “Тип” обрано варіант “Вибір” або “Мультивибір”.

1.5.5. Перемикач “Обовʼязковий“

Перемикач відображається після вибору типу поля (крім типу “Логічне”).

Увімкнення перемикача image-20250818-125907.png означає, що поле стає обовʼязковим для заповнення.

1.5.6. Поле “Значення за замовчуванням“

Відображається після ввімкнення перемикача “Обовʼязковий”.

Поле є обовʼязковим для заповнення.

Тип значення за замовчуванням відповідає “Типу“ користувацького поля (текст, число, вибір, мультивибір, календар).

Логіка застосування значення за замовчуванням:

  • для існуючих записів довідника, у яких обовʼязкове поле не заповнене, значення за замовчуванням автоматично підставляється;

  • для існуючих записів довідника, у яких поле вже заповнене, наявне значення зберігається і не змінюється;

  • для нових записів довідника значення за замовчуванням підставляється автоматично при створенні запису довідника.

1.6. Інструмент для видалення

Використовується для видалення колонки із підтвердженням через модальне вікно. Активується після вибору чекбокса біля колонки.

При наведенні на кнопку видалення 20f61797-97ac-4f64-bb72-6de44110a55d відображається підказка з назвою інструмента — image-20250506-114641.png . Після натискання кнопки видалення з’являється модальне вікно з підтвердженням (Рис. 6).

image-20250818-121541.png
Рис. 6. Модальне вікно “Підтвердіть видалення“

Натискання кнопки "Так" видаляє колонку і всі записи з неї у довіднику. Натискання кнопки "Ні" закриває модальне вікно, колонка не видаляється.

2. Можливості

2.1. Додавання колонки

Мета

Додати колонку

Передумови

  1. Доступ до застосунку CRM;

  2. Доступ до розділу "Користувацькі довідники" у застосунку CRM;

  3. Дозвіл на створення або редагування в розділі "Користувацькі довідники".

  4. Наявність щонайменше одного користувацького довідника, або створення нового.

Сценарій:

 

  1. Натиснути кнопку image-20250211-133952.png . Відкриється модальне вікно "Додати колонку".

  2. Внести дані.

  3. Натиснути кнопку "Зберегти".

Результат

Модальне вікно закривається. Дані збережено. Колонка додана в реєстр.

2.2. Видалення колонки

Мета

Видалити колонку

Передумови

  1. Доступ до застосунку CRM;

  2. Доступ до розділу "Користувацькі довідники" у застосунку CRM;

  3. Дозвіл на створення або редагування в розділі "Користувацькі довідники".

  4. Наявність щонайменше одного користувацького довідника або створення нового.

  5. Наявність, мінімум, однієї колонки у реєстрі.

Сценарій:

 

  1. Знайти колонку, що потрібно видалити.

  2. Натиснути кнопку видалення -  image-20250213-111620.png . Відкриється модальне вікно для підтвердження видалення.

  3. Натиснути кнопку "Так".

Результат

Модальне вікно закривається. Колонку видалено.

2.3. Видалення кількох колонок

Мета

Видалити кілька колонок

Передумови

  1. Доступ до застосунку CRM;

  2. Доступ до розділу "Користувацькі довідники" у застосунку CRM;

  3. Дозвіл на вибір та видалення в розділі "Користувацькі довідники".

  4. Наявність щонайменше одного користувацького довідника або створення нового.

  5. Наявність, мінімум, однієї колонки у реєстрі.

Сценарій:

 

  1. Знайти у реєстрі колонки, які потрібно видалити. Вибрати їх за допомогою чекбокса.

  2. Натиснути кнопку видалення у верхній частині реєстру колонок. Відкриється модальне вікно для підтвердження видалення.

  3. Натиснути кнопку "Так".

Результат

Модальне вікно закривається. Колонки видалено.

2.4. Редагування колонки

Мета

Відредагувати колонку

Передумови

  1. Доступ до застосунку CRM;

  2. Доступ до розділу "Користувацькі довідники" у застосунку CRM;

  3. Дозвіл на створення та редагування в розділі "Користувацькі довідники";

  4. Наявність щонайменше одного користувацького довідника або створення нового.

  5. Наявність, мінімум, однієї колонки у реєстрі.

Сценарій:

 

  1. Знайти у реєстрі колонку, що потрібно відредагувати.

  2. Натиснути кнопку редагування для цієї колонки. Відкриється модальне вікно "Редагувати колонку".

  3. Внести зміни. Кнопка "Зберегти" стає активною.

  4. Натиснути кнопку "Зберегти".

Результат

Дані збережено.