• Русский

      • Дата обновления

      Введение

      В NocoBase дата обновления (Updated at) автоматически записывает время последнего обновления записи.

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

      Если необходимо сохранить время завершения операции, согласования и т. п., используйте дату и время.

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

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

      • Просмотр времени последнего обновления
      • Фильтрация недавно обновлённых данных
      • Определение данных, которые давно не поддерживались
      • Сравнение времени обновления при синхронизации с внешними системами

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

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

      20240512174826

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

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

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

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

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

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

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

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

      Поле даты обновления подходит для списков, подробной информации, фильтрации и определения необходимости синхронизации. 20260710153223

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

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