Цвет

Введение

В NocoBase цвет (Color) используется для хранения значений цвета.

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

Если цвет является лишь частью поля вариантов, его можно настроить непосредственно в поле вариантов — создавать отдельное поле цвета не обязательно.

Сценарии использования

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

  • Цвет уровня клиента, цвет статуса
  • Цвет тега, цвет категории
  • Цвет серии диаграммы
  • Настройки отображения страницы или карточки

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

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

20240512175956

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

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

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

Поле цвета по умолчанию ведёт себя следующим образом:

СвойствоОписание
Field interface по умолчаниюcolor.
Field type по умолчаниюstring.
Доступный Field typestring.
Компонент страницыВ режиме редактирования используется компонент выбора цвета.
ФильтрацияМожно фильтровать по значению цвета, но обычно это не основной критерий поиска.
СортировкаОбычно не используется для сортировки.
ПроверкаПоддерживаются базовые проверки, например обязательность заполнения.

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

После создания нажмите «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, импорт и экспорт, а также существующие данные. Перед удалением убедитесь, что поле больше не используется в бизнес-конфигурации.

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

Поле цвета подходит для использования в сценариях отображения и настройки страниц. 20260709225444

СценарийНазначение
Блок формыВыбор значения цвета.
Блок подробной информацииОтображение цвета.
Список или карточкаВизуальная индикация статуса, тега или категории.
ДиаграммаИсточник настроек цвета.

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