Типы полей
Выбирайте тип по данным и действиям, которые нужны пользователю. Ниже перечислены все 30 типов из текущей фабрики полей и схемы создания backend: 27 обычных и 3 системных. Наличие типа в backend не означает, что он доступен во всех интерфейсах или запросах API; особенности указаны на его странице.
Как выбрать тип
| Тип | Когда использовать |
|---|---|
| Text | Короткие названия, коды и внешние номера |
| Textarea | Многострочные заметки, адреса и инструкции |
| Number | Количество, цены, формулы и валютные суммы |
| Balance | Остатки и балансы по зарегистрированным движениям |
| Percentage | Выбор процентной ставки из заданного списка |
| Choice field | Категории, варианты, признаки Да/Нет и бизнес-статус |
| Date | Дата документа или события |
| Due Date | Срок задачи, в том числе относительно другой даты |
| Counter | Автоматический номер по маске |
| Контактный email | |
| Phone | Контактный телефон |
| Person | Выбор пользователя HCAPP |
| Form | Ссылка на запись другой формы |
| Table | Повторяющиеся строки внутри текущей задачи |
| Associated table | Представление целых связанных задач |
| Linked Rows | Строки таблиц других задач, связанные с текущей |
| Linked Calc | Существующие процессы со связанными числовыми корректировками |
| Linked Total | Сумма, среднее или количество связанных задач в карточке |
| Files | Загруженные документы, фотографии и чеки |
| Signature | Подпись, сохраняемая файлом |
| Google Drive | Работа с папкой и шаблонами Drive |
| Link | Редактируемый внешний URL |
| GPS | Координаты устройства в момент запроса; см. ограничение отправки |
| Time tracker | Учёт рабочих интервалов |
| Portal User (Driver / Master) | Внешние пользователи Driver/Master и настройки личного кабинета |
| Button | Действие: ссылка, создание задачи или запуск интеграции |
| Title | Постоянный заголовок раздела |
| Divider | Визуальный разделитель |
| Author | Системные данные: кто создал задачу |
| Created At | Системные данные: когда создана задача |
| Is Finished | Системные данные: завершена ли задача |
Похожие типы
- Text или Number: коды с начальными нулями храните в Text; для арифметики используйте Number.
- Number или Balance: Number вводится или вычисляется; Balance изменяется через правила движений таблицы.
- Date или Due Date: Date хранит дату события; Due Date обновляет срок задачи.
- Form, Table, Associated table или Linked Rows: ссылка на запись, собственные строки, представление целых связанных задач или представление связанных строк соответственно.
- Files, Signature или Google Drive: обычные вложения, подпись или работа с папкой Drive.
Общие настройки
Набор настроек зависит от схемы конкретного типа. Не все перечисленные параметры есть у каждого поля, особенно у системных и декоративных полей.
| Настройка | Назначение |
|---|---|
name | Название поля |
default_value | Начальное значение для типов, поддерживающих его |
show_in_title | Включение значения в заголовок задачи |
visible_on_step | Этапы, на которых поле видно |
required_on_step | Этапы, на которых поле обязательно |
immutable_from_step | Этапы, начиная с которых поле становится недоступным для редактирования |
show_if | Условия отображения по другим полям |
inline_with_next | Размещение рядом со следующим полем |
field_size | Размер S, M, L или F для поддерживающих типов |
required | Обязательная ячейка каждой непустой строки Table; игнорируется на верхнем уровне |
Условие show_if содержит ID поля, оператор и значение. Схема допускает =, <=, >=, !=, *, !*, === и !==. Настройки отображения не заменяют права доступа.
Названия, которые не являются отдельными типами
- Money: используйте Number с
moneyиcurrency. - Dropdown, Checkbox и Boolean: для списков и признаков используйте Choice; Dropdown и Checkbox — значения
display_as. - Status: используйте Choice с
is_status_field. УпоминаниеStatusFieldв схеме колонок Associated table не означает отдельный создаваемый тип. - Image: отдельного поддерживаемого типа нет; для изображений используйте Files. Старая страница Image сохранена для существующих ссылок.
Константы Money, Boolean, Checkbox и Dropdown присутствуют в модели, но отсутствуют в текущей фабрике и схеме создания полей. Author, Created At и Is Finished — системные типы; их ресурс возвращается как SystemField, а не как обычное редактируемое поле.