# Як розширити контакти таблиці Клієнтів через Custom Data?

Якщо потрібно додати до картки клієнта поля, яких немає в стандартній таблиці (дата народження, додатковий телефон, мітка VIP), можна використати Custom Data з опцією «Використовувати для розширення полів контактів». Дані з Custom Data з'являться в таблиці Клієнтів для відповідного клієнта.

> **Для нових проєктів:** Краще використовувати **Client Fields** (Меню → Налаштування → Поля клієнта). Client Fields — стандартний спосіб додавання кастомних полів. Custom Data з розширенням контактів — варіант для існуючих проєктів, які вже його використовують.

## Коли знадобиться

- Потрібно додати додаткові поля до таблиці Клієнтів (наприклад, дата народження, додаткові контакти, спеціальні мітки).
- Треба відображати кастомні дані безпосередньо в таблиці Клієнтів.
- Потрібно інтегрувати додаткову інформацію про клієнтів з Custom Data.

## Що важливо знати

- **Розширення контактів** — опція в моделі Custom Data, яка дозволяє додати поля до таблиці Клієнтів.
- Потрібно додати поле `reg_user_id` типу INTEGER з параметром `unique: true`.
- ID користувача не відображається в інтерфейсі — його можна дізнатися через консоль браузера.
- Дані з таблиці Custom Data з'являться в таблиці Клієнтів для відповідного клієнта.

## Перед початком

- [x] Ви увійшли в систему з правами адміністратора.
- [x] Ви перейшли в модуль `Custom Data` через `Меню -> Custom Data`.
- [x] Ви знаєте, які додаткові поля потрібно додати до таблиці Клієнтів.

## Покрокова інструкція

1. У модулі `Custom Data` перейдіть до вкладки **"Створити/Оновити"**.
2. Створіть нову модель або відредагуйте існуючу.
3. Увімкніть опцію **"Використовувати для розширення полів контактів"**.
4. Додайте обов'язкове поле:
   - **Назва поля**: `reg_user_id`
   - **Тип поля**: INTEGER
   - **Унікальність**: увімкніть опцію `unique: true`
5. Додайте інші поля, які потрібно відобразити в таблиці Клієнтів:
   - Назва поля (наприклад, "Дата народження", "Додатковий телефон")
   - Тип поля (TEXT, DATE, INTEGER тощо)
   - Налаштування відображення (назва, іконка, колір)
6. Збережіть модель.

### Заповнення даних

Після збереження моделі:

1. Перейдіть у вкладку **"Дані"** в модулі Custom Data.
2. Створіть записи для клієнтів:
   - У полі `reg_user_id` вкажіть ID клієнта (його можна дізнатися через консоль браузера)
   - Заповніть інші додаткові поля
3. Збережіть записи.

> 💡 **Підказка**: ID користувача не відображається в інтерфейсі. Його можна дізнатися через консоль браузера (F12 → Console → знайти ID клієнта).

## Що відбувається після

Після збереження моделі з увімкненою опцією "Використовувати для розширення полів контактів" додані поля відобразяться в меню "Клієнти". У записах Custom Data потрібно вказати ID клієнта в полі `reg_user_id`. Дані з таблиці Custom Data з'являться в таблиці Клієнтів для відповідного клієнта.

## Як переконатися, що все вдалось

- Перевірте, що опція "Використовувати для розширення полів контактів" увімкнена.
- Переконайтеся, що поле `reg_user_id` додано з типом INTEGER та унікальністю.
- Перевірте, що додані поля відображаються в таблиці Клієнтів.
- Створіть тестовий запис з правильним `reg_user_id` та перевірте, що дані відображаються в таблиці Клієнтів.

## Пов'язані матеріали

- [Патерни та приклади Custom Data](/uk/customdata/explanation/custom-data-patterns-and-examples.md) — коли використовувати Custom Data, а коли Client Fields
- [Створити модель](/uk/customdata/how-to/create-model.md)
- [Додати поле до моделі](/uk/customdata/how-to/add-field-to-model.md)
- [Налаштувати тип поля](/uk/customdata/how-to/configure-field-type.md)