• Русский

      • Группа флажков

      Введение

      В NocoBase группа флажков (Checkbox group) используется для выбора нескольких значений из набора вариантов с их непосредственным отображением в форме.

      Группа флажков подходит для сценариев с небольшим количеством вариантов, когда требуется множественный выбор. От выпадающего списка с множественным выбором она отличается главным образом способом взаимодействия с интерфейсом.

      Если вариантов много, выберите выпадающий список с множественным выбором, чтобы сэкономить место. Если можно выбрать только один вариант, выберите группу переключателей.

      Подходящие сценарии

      Группа флажков подходит для следующих бизнес-сценариев:

      • сфера обслуживания, доступные каналы
      • пункты выбора функциональных разрешений
      • теги потребностей клиентов
      • небольшое количество фиксированных вариантов для множественного выбора

      Создание и настройка

      На странице «Configure fields» таблицы данных нажмите «Add field» и выберите «Группа флажков», чтобы создать поле группы флажков. 20260709231244

      НастройкаОписание
      Field interfaceТип интерфейса поля. Для группы флажков соответствует checkboxGroup и определяет способ ввода и отображения данных на странице.
      Field display nameИмя поля, отображаемое в интерфейсе, например «Сфера обслуживания», «Доступные каналы», «Теги потребностей». Рекомендуется использовать понятное бизнес-пользователям имя.
      Field nameИдентификатор поля, используемый для внутренних ссылок в API, полях связей, правах доступа, рабочих процессах и других компонентах. После создания обычно не изменяется; допускаются только буквы, цифры и символы подчёркивания, причём имя должно начинаться с буквы.
      Field typeТип поля на уровне данных. Группа флажков обычно сохраняется как массив или JSON; конкретный вариант зависит от настройки поля и возможностей источника данных.
      Default valueЗначение по умолчанию. При добавлении записи оно может подставляться автоматически, если пользователь не указал значение.
      Validation rulesПравила проверки. Обычно настраиваются обязательность заполнения и допустимый набор вариантов.
      DescriptionОписание поля. Здесь можно указать смысл поля, требования к заполнению, источник данных или ответственного за обслуживание.
      Внимание

      После создания имя поля будет использоваться блоками страниц, правами доступа, рабочими процессами и API. Перед созданием проверьте название, чтобы избежать дополнительных затрат на изменение конфигурации в дальнейшем.

      Свойства поля

      По умолчанию поле группы флажков ведёт себя следующим образом:

      СвойствоОписание
      Интерфейс Field interface по умолчаниюcheckboxGroup.
      Тип Field type по умолчаниюarray.
      Доступные типы Field typearray、json, в соответствии с фактическим сопоставлением поля.
      Компонент страницыВ режиме редактирования используется группа флажков.
      ФильтрацияПоддерживается фильтрация по наличию определённого варианта.
      СортировкаОбычно не используется для сортировки.
      ПроверкаПоддерживаются обязательность заполнения и ограничения набора вариантов.

      Редактирование настроек

      После создания нажмите «Edit» справа от поля, чтобы изменить настройки поля группы флажков. Редактирование поля используется главным образом для изменения способа его отображения и использования в NocoBase, например имени, описания, значения по умолчанию, правил проверки или специальных настроек поля.

      Если поле поступает из уже синхронизированной таблицы основной базы данных, редактирование обычно означает настройку сопоставления поля — сопоставление поля базы данных с Field type и Field interface в NocoBase.

      НастройкаМожно редактироватьОписание
      Field display nameДаИзменяет отображаемое в интерфейсе имя поля, не меняя его идентификатор.
      Field nameНетИдентификатор поля обычно нельзя изменить в форме редактирования после создания.
      Field interfaceПри определённых условияхДля полей основной базы данных или синхронизированных полей интерфейс можно изменить при сопоставлении. Это повлияет на способ ввода, отображения и проверки данных на странице.
      Field typeПри определённых условияхДля полей основной базы данных или синхронизированных полей тип можно изменить при сопоставлении. Перед изменением необходимо убедиться, что существующие данные можно использовать с новым типом.
      Default valueДаИзменяет значение по умолчанию для новых записей.
      Validation rulesДаИзменяет правила проверки поля.
      DescriptionДаДополняет сведения о смысле поля, требованиях к заполнению, источнике данных или ответственном за обслуживание.
      Внимание

      Переключение Field type или Field interface — это не просто изменение отображаемого имени. Оно влияет на способ хранения данных, компонент ввода, правила проверки, условия фильтрации и использование переменных рабочих процессов. При большом объёме существующих данных сначала убедитесь, что их формат соответствует новому типу.

      Удаление поля

      Нажмите «Delete» справа от поля, чтобы удалить поле группы флажков. В основной базе данных также можно выбрать несколько полей и удалить их одновременно.

      При удалении созданного в основной базе данных поля группы флажков обычно одновременно удаляются соответствующий физический столбец в базе данных и уже сохранённые в нём данные. При удалении поля, синхронизированного с базой данных или сопоставленного из внешнего источника данных, область воздействия зависит от соответствующего источника данных и происхождения поля.

      Предупреждение

      Удаление поля может повлиять на блоки страниц, формы, фильтры, права доступа, рабочие процессы, API, импорт и экспорт, а также существующие данные. Перед удалением убедитесь, что поле больше не используется в бизнес-конфигурациях.

      Использование в настройках страницы

      Группа флажков подходит для отображения небольшого количества вариантов множественного выбора непосредственно в форме. 20260709230421

      СценарийНазначение
      Блок формыНепосредственно отображает все варианты и позволяет выбрать несколько.
      Блок подробностейОтображает несколько выбранных вариантов в виде тегов или текста.
      Блок фильтрацииФильтрует записи по наличию определённых вариантов.
      Рабочие процессы и права доступаУчаствует в проверке условий, таких как «содержит» и «не содержит».

      Связанные ссылки