• Русский

      • Последовательность

      Введение

      В NocoBase последовательность (Sequence) используется для генерации бизнес-номеров.

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

      Если требуется только внутренний уникальный идентификатор, используйте Snowflake ID, UUID или Nano ID.

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

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

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

      Создание конфигурации

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

      20240512173752

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

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

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

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

      СвойствоОписание
      Интерфейс Field interface по умолчаниюsequence.
      Тип Field type по умолчаниюstring.
      Доступные типы Field typestring, integer — в зависимости от фактической конфигурации последовательности.
      Компонент страницыОбычно создаётся автоматически и используется после настройки правила нумерации.
      ФильтрацияПоддерживается точный поиск по номеру или фильтрация по тексту.
      СортировкаПригодность для сортировки зависит от правила нумерации.
      ПроверкаЗависит от правила последовательности; обычно обеспечивается уникальность.

      Редактирование конфигурации

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

      Использование в конфигурации страниц

      Поле последовательности подходит для бизнес-номеров и сценариев поиска пользователями. 20260710151731

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

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

      • Поля — сведения о назначении, классификации и логике сопоставления полей
      • Обычная таблица — создание и управление полями в обычной таблице
      • Однострочный текст — ручное ведение бизнес-номеров
      • Snowflake ID — использование внутреннего идентификатора первичного ключа