• Русский

      • Процент

      Обзор

      В NocoBase процент (Percent) используется для хранения и отображения пропорциональных данных.

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

      Если речь идет об обычной сумме, количестве или оценке, лучше выбрать число.

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

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

      • Процент выполнения проекта, прогресс выполнения задачи
      • Скидка, налоговая ставка, размер комиссии
      • Коэффициент конверсии, процент достижения, доля
      • Вес оценки, пропорция распределения

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

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

      20240512175847

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

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

      Особенности поля

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

      ОсобенностьОписание
      Интерфейс Field interface по умолчаниюpercent.
      Тип Field type по умолчаниюdouble.
      Доступные типы Field typefloat, double, decimal.
      Компонент страницыВ режиме редактирования используется компонент ввода процентов.
      ФильтрацияПоддерживается фильтрация числовых значений: больше, меньше, диапазон, пусто и не пусто.
      СортировкаПоддерживается сортировка в блоке таблицы.
      ВалидацияПоддерживается проверка диапазона значений, обязательности поля и другие правила.

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

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

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

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

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

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

      • Поля — узнайте о назначении, категориях и логике сопоставления полей
      • Обычная таблица — создание и управление полями в обычной таблице
      • Число — хранение обычных числовых значений
      • Формула — вычисление результатов в виде пропорций