HelomiWIKI

Типи даних і поля

«Типи даних» — місце, де ви самі вирішуєте, з яких полів складаються клієнт, угода, товар, завдання, додатковий контакт і операція «Фінансів»: які поля є, які обов'язкові, що видно в списку, у формі створення й у картці, і в якому порядку. Змінили тут — і одразу бачите це в розділі, на телефоні, в імпорті та в тому, що читає ШІ, без жодної правки коду.

8 хвОновлено 22.10.2026
Markdown для ШІ
На цій сторінці

Можливості

  • Одна таблиця на тип: вбудовані поля (ID, назва, телефон, етап…) разом із вашими власними.
  • Власні поля восьми типів: «Рядок», «Цифри», «Дата», «Час», «Так/Ні», «Список», «Гіперпосилання», «Текст»; для «Рядка» і «Списку» — мультивибір.
  • «Текст» — для довгих записів (умови, інструкції, коментарі): у картці показується з абзацами й «Розгорнути», редагується шторкою збоку з підказкою поля; у формах поле росте разом із текстом.
  • «Обов'язкове поле» діє насправді: без значення запис не збережеться ні вручну, ні через API, ні у ШІ.
  • «Вивести в списку», «Вивести при створенні», для угод — «Вивести в угоді», для товарів — «Вивести в угоді» і «Вивести в накладних».
  • Порядок перетягуванням, блоки картки з перейменуванням.
  • Поле угоди лише для вибраних воронок.
  • Поле клієнта також у картці угоди й у завданні.
  • Контроль унікальності, показ дублів, поле у фільтрі списку.

1Налаштування

Дорога: НалаштуванняТипи даних«Налаштування → Типи даних» і тип: «Клієнти», «Угоди», «Товари», «Завдання», «Дод. контакти», «Фінанси» (поля операції: «Вивести при створенні» — шторка «Новий платіж», «Вивести в списку» — колонка журналу; стаття «Фінанси», розділ 1б). Поля власних розділів — НалаштуванняТипи данихВласні розділи«Налаштування → Типи даних → Власні розділи» (стаття «Власні розділи»).

Швидкий шлях із самого розділу: ⋮Налаштувати поля«⋮ → Налаштувати поля» у «Клієнтах», «Угодах», «Завданнях», «Товарах» і у власних розділах; у картці угоди — ⋮Налаштувати поля угоди«⋮ → Налаштувати поля угоди». Пункт видно адміністратору.

На сторінці типу — пошук полів, таблиця з колонками «Увімкнено», «Назва», «Тип поля», «Обов'язкове поле», «Вивести в списку», «Вивести при створенні», «Блок», «ID» і «⋮» поля, внизу — сторінки, «Рядків на сторінці» (25 / 50 / 100) і «Всього». У «Завданнях» над полями ще таблиця «Типи завдань» (стаття «Довідники»).

Змінювати поля може людина з доступом до налаштувань (адміністратор або з галочкою «Налаштування CRM»).

2Додати своє поле

  1. Натисніть «Додати» під таблицею або ⋮Додати поле«⋮ → Додати поле» вгорі.
  2. У шторці «Користувацьке поле» заповніть «Назва », «Тип поля », «Блок *» (або «+ Новий блок…»).
  3. Для «Списку» введіть «Варіанти списку *» по одному, кожен — клавішею Enter.
  4. За потреби задайте «Значення за замовчуванням» — воно підставиться в новий запис.
  5. Для полів клієнта є «Також відображати у розділах»: «Угоди» (внизу «Даних угоди» блоком «Поля клієнта» і колонкою в списку угод) і «Завдання» (у шторці завдання, у блоці про клієнта).
  6. Поставте потрібні прапорці (розділ 3) і натисніть «Зберегти».

Ключ поля (латиницею) створюється з назви сам і видно в колонці «ID»; нове поле угоди одразу стоїть у картці.

3Прапорці: обов'язкове, у списку, при створенні, в угоді

ПрапорецьЩо робить
«Обов'язкове поле»Без значення запис не створиться; наявне значення не можна стерти
«Вивести в списку»Колонка в таблиці розділу
«Вивести при створенні»Поле у шторці нового запису («Нова угода», «Новий клієнт»…)
«Вивести в угоді» (угоди)Рядок у «Даних угоди» картки, на місці за порядком таблиці
«Вивести в угоді» (товари)Колонка у вікні «Додати товар зі складу»
«Вивести в накладних» (товари)Зберігається для шаблонів документів
«Видно колегам» (люди)Поле в картці людини в «Структурі»; без галочки — лише сама людина й адміністратор (стаття Люди: картки й анкети)
«Додати у фільтр»Фільтр за цим полем у списку розділу
«Дозволити мультивибір»Кілька значень для «Рядка» або кілька варіантів для «Списку»

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

3аПідказка поля

Підказка — одне речення під полем у формі створення: що станеться або звідки значення («Без клієнта угоду не збережуть. Новий створиться сам.»). Її бачать усі, хто заповнює форму, і ШІ-співробітники в описі розділу, тому людина й ШІ заповнюють поле однаково.

  • Колонка «Підказка (бачать люди і ШІ)» — клацніть по тексту в рядку поля, напишіть і натисніть Enter (Esc — скасувати). До 300 знаків.
  • У вбудованих полів (ID, Назва, Телефон, Клієнт…) уже є типова підказка; її можна змінити або стерти, а кнопка «Типова» повертає її.
  • У шторці власного поля — поле «Підказка» під назвою.
  • У формах розділів (угода, клієнт, контакт, завдання, товар, платіж, запис власного розділу) підказка з'являється під полем, коли воно у фокусі або під курсором; на телефоні — завжди. Порожня підказка — рядка нема.
  • Пишіть наслідок, а не повтор назви: не «Телефон клієнта», а «За номером шукаються клієнт, дублі й переписки».

4Порядок і блоки

  • Тягніть рядок за «↕» — порядок спільний для вбудованих і власних полів і однаковий у списку, формі створення й картці. Під час пошуку перетягування вимкнене.
  • ⋮Перейменувати блок…«⋮ → Перейменувати блок…» вгорі сторінки змінює назву блоку картки для всіх його полів.

5Системні поля із замком

Вбудовані поля мають позначку «системне». Їх не можна видалити чи змінити тип; прапорці, без яких запис не існує (наприклад «Увімкнено» в ID, назви, клієнта, етапу, воронки угоди), заблоковані й сірі. Прочерк «—» означає, що для цього поля прояву нема (наприклад, колонки в шторці). Решту прапорців вбудованих полів можна вмикати й вимикати, а рядки — переставляти.

6Поле лише для окремих воронок

Для угоди, коли воронок більше однієї, у шторці поля є «Воронки продажів»: «Усі воронки» (і ті, що з'являться згодом) або «Лише вибрані». Картка й «Нова угода» показують поле тільки у вибраних воронках; у таблиці це видно в колонці «Воронка продажів». Імпорт і ШІ можуть записати таке поле в будь-яку угоду.

7Унікальність і дублі

  • «Контроль унікальності» — те саме значення в іншого запису не збережеться. Якщо дублі вже є, система попередить і запропонує ввімкнути все одно.
  • «Відобразити дублі» — у «⋮» поля з'явиться «Показати дублі»: список повторюваних значень із номерами записів.

8Вимкнути або видалити поле

  • Зніміть «Увімкнено» — поле зникне з карток, списків і фільтрів, значення збережуться.
  • ⋮Видалити«⋮ → Видалити» прибирає поле разом з усіма значеннями після підтвердження; дані не відновити. Поля, що прийшли з імпорту KeepinCRM, лише вимикаються.
  • Зміна типу не перетворює старі значення: вони лишаються текстом і можуть показуватися некоректно.

На телефоні рядок таблиці стає карткою: назва з «↕» і «⋮», під нею тип, блок і ID, далі пігулки прапорців.

Можливі помилки

Що ви бачитеЧомуЩо зробити
«Потрібна назва поля»Порожня «Назва»Впишіть назву
«Для списку потрібні варіанти: введіть варіант і натисніть Enter»Тип «Список» без варіантівДодайте хоча б один варіант
«Поле «…» у цій сутності вже є»Така назва вже зайнятаДайте іншу назву
«Увімкнути унікальність не можна: є N повторюваних значень…»Дублі вже є«Показати дублі», виправте або підтвердіть примусово
«Системне поле (з імпорту) не видаляється — лише архівується»Поле прийшло з KeepinCRMЗніміть «Увімкнено»
«Виберіть хоча б одну воронку або «Усі воронки»»«Лише вибрані» без жодної воронкиПозначте воронку
«Заповніть обов'язкове поле «…»» (у розділі)Поле позначено обов'язковимЗаповніть його або зніміть прапорець тут

Для ШІ-співробітників

  • Поля кожного розділу з прапорцями й варіантами — describe_section("<key>") (deals, clients, tasks, products, slug власного розділу). Обов'язкові поля діють для ШІ так само, як для людини: запис без них повертає помилку з назвою поля.
  • Власні поля в запитах передаються в об'єкті custom за ключем поля.
  • У кожного поля в describe_section є hint — та сама підказка, що людина бачить під полем: заповнюйте поле так, як вона каже.
  • Змінювати поля вбудованих розділів і розділів людей ШІ не може: «Налаштування CRM» для ШІ закриті завжди. З правом творця «Свої розділи» ШІ читає поля будь-якого розділу (fields_list) і змінює лише поля своїх розділів (fields_create, fields_update, fields_builtin_update, fields_delete — видалення чекає підтвердження людини). Докладно — стаття «ШІ-творець».

Додаткова інформація

Цю саму статтю читають ШІ-співробітники Helomi: help("settings-fields")