Время

Введение

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

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

Если необходимо одновременно сохранять дату и время, выберитедату и время.

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

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

  • Время начала и окончания работы
  • Ежедневное время напоминания
  • Время начала и окончания смены
  • Настройка фиксированных моментов времени

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

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

20240512181216

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

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

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

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

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

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

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

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

Поле времени подходит для использования в формах и настройках правил. 20260709232726

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

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