Low-code кастомизация
Low-code кастомизация
Назначение
Сервис обеспечивает адаптацию поведения и интерфейса системы без полноценной разработки отдельных приложений. Включает Customize Form, Custom Field, Property Setter , визуальное создание страниц (builder) и улучшения контролов .
Цели и задачи
- Добавлять и скрывать поля в формах документов (Custom Field).
- Менять свойства полей и форм (Property Setter) без изменения кода.
- Создавать страницы и представления визуально (builder при установке).
- Группировать опции в выпадающих списках .
- Адаптировать формы под процессы компании без разработки приложения.
Для кого
- Администраторы и конфигураторы системы.
- Аналитики и ключевые пользователи при согласовании полей и представлений.
- Разработчики при ограниченных доработках через low-code.
Основные понятия
- Customize Form — интерфейс кастомизации формы тип документа: какие поля показывать, порядок, вкладки.
- Custom Field — пользовательское поле, добавленное к тип документа; тип (Data, Link, Select и т.д.), метка, обязательность.
- Property Setter — изменение свойства стандартного поля или формы (read_only, hidden, default и т.д.).
- Builder — приложение визуального создания страниц (формы, списки, дашборды без кода).
- frappe_better_select_control — группировка опций в Select (заголовки групп).
Основные сущности / объекты
- Custom Field, Property Setter .
- builder — визуальное создание страниц (README).
- frappe_better_select_control — группировка в Select (README).
Основные сценарии / процессы
Добавление пользовательского поля
- Перейти в Customize Form; выбрать тип документа.
- Добавить поле (Add Row или New Custom Field): тип, метка, опции для Select/Link.
- Задать обязательность, только для чтения, видимость по условию при поддержке.
- Сохранить; поле появится в форме выбранного тип документа для всех сайтов (или по применению к группе).
Изменение свойства стандартного поля
- В Customize Form выбрать тип документа и поле.
- Либо через Property Setter: создать запись для этого тип документа и поля, задать свойство (например, read_only = 1, default = "Draft").
- Сохранить; изменение применится к форме.
Создание страницы в Builder
- Открыть Builder (при установленном приложении).
- Создать новую страницу; добавить блоки (форма, список, график) и привязать к тип документа или данным.
- Опубликовать страницу; добавить в меню или рабочее пространство при необходимости.
Группировка опций в Select
- При установленном frappe_better_select_control в настройках поля типа Select указать группы опций (синтаксис по документации приложения).
- В форме выпадающий список отобразит опции с заголовками групп.
Правила и ограничения
- Custom Field и Property Setter применяются глобально к тип документа (или к группе при использовании полей применения); откат — удаление кастомного поля или Property Setter.
- Builder создает страницы в рамках возможностей приложения; сложная логика может потребовать разработки.
- Резервные копии должны включать данные Custom Field и Property Setter (обычно в базе и в экспорте приложения).
Результаты / отчетность
- Измененные формы и списки с новыми полями и свойствами.
- Страницы, созданные в Builder, в меню и рабочих пространствах.
- Удобные выпадающие списки с группировкой .
Типовые вопросы и ошибки (FAQ)
Кастомное поле не отображается в форме
Проверьте: поле создано для правильного тип документа; в Customize Form для этого тип документа поле не скрыто; форма не переопределена макетом (Form Layout), который не включает это поле. Обновите страницу и очистите кэш при необходимости.
Чем Custom Field отличается от Property Setter?
Custom Field добавляет новое поле к тип документа. Property Setter меняет свойство уже существующего поля (стандартного или кастомного) — например, сделать его только для чтения или изменить значение по умолчанию.
Как откатить кастомизацию?
Удалить Custom Field или Property Setter через список соответствующих документов (Customize Form > поля или список Property Setter). Стандартное поле вернется к поведению из кода приложения.