• Русский

      • Обычная таблица

      Источник данных: основнойCommunity Edition+

      Введение

      Обычные таблицы — наиболее распространённый тип таблиц данных. Они подходят для хранения стандартных бизнес-данных: клиентов, заказов, договоров, заявок, отчётов о расходах, проектов, задач и т. д. Если к большинству бизнес-объектов не предъявляются особые требования к структуре, обычно достаточно использовать обычную таблицу.

      Обычные таблицы могут поступать из следующих источников:

      • Новые таблицы, созданные в основной базе данных
      • Существующие реальные таблицы, синхронизированные из основной базы данных
      • Существующие реальные таблицы, подключённые из внешней базы данных
      • Ресурсы, сопоставленные через REST API
      • Таблицы данных во внешнем приложении NocoBase

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

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

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

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

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

      В основной базе данных нажмите «Create collection» и выберите «General collection», чтобы создать обычную таблицу.

      20240324085739

      НастройкаОписание
      Collection display nameНазвание таблицы данных, отображаемое в интерфейсе, например «Клиенты», «Заказы», «Вложения к договорам». Рекомендуется использовать название, понятное сотрудникам бизнеса.
      Collection nameИдентификатор таблицы данных, используемый для внутренних ссылок в API, полях связей, правах доступа, рабочих процессах и т. д. Он создаётся автоматически, но его можно изменить вручную; допускаются только буквы, цифры и символы подчёркивания, при этом название должно начинаться с буквы.
      CategoriesКатегория таблицы данных. Категория влияет только на организацию интерфейса управления таблицами данных и не изменяет структуру таблицы. При большом количестве таблиц рекомендуется распределять их по бизнес-модулям, например «Управление клиентами», «Управление проектами», «Финансы».
      DescriptionОписание таблицы данных. Здесь можно указать, какие данные хранятся в таблице, кто отвечает за её обслуживание и с какими бизнес-процессами она связана, чтобы упростить дальнейшее сопровождение.
      Use simple pagination modeРежим простой пагинации. После включения при разбиении данных в блоке таблицы пропускается подсчёт общего количества записей. Подходит для таблиц с большим объёмом данных и позволяет снизить нагрузку на запросы.
      Preset fieldsПредустановленные поля. При создании таблицы можно выбрать, добавлять ли автоматически распространённые поля, такие как ID, время создания, создатель, время обновления и обновивший пользователь. Для обычных бизнес-таблиц рекомендуется сохранить эти поля.

      Встроенные поля

      При создании обычной таблицы можно автоматически добавить распространённые системные поля с помощью Preset fields.

      ПолеИмя поляОписание
      IDidПоле первичного ключа по умолчанию, используемое для уникальной идентификации записи. Тип первичного ключа по умолчанию — Snowflake ID (53-bit).
      Время созданияcreatedAtАвтоматически записывает время создания записи. Обычно используется для сортировки, фильтрации, аудита и условий рабочих процессов.
      СоздательcreatedByАвтоматически записывает пользователя, создавшего запись. Обычно используется для просмотра только созданных мной данных, управления правами доступа и отслеживания ответственности.
      Время обновленияupdatedAtАвтоматически записывает время последнего обновления записи. Обычно используется для определения того, изменялись ли данные.
      Обновивший пользовательupdatedByАвтоматически записывает пользователя, последним обновившего запись. Обычно используется в сценариях аудита и совместной работы.
      ПространствоspaceДоступно после включения плагина нескольких пространств и используется для изоляции данных по пространствам. Если плагин нескольких пространств не включён, это поле не отображается среди предустановленных полей обычной таблицы.

      Поле первичного ключа

      Primary key обозначает поле первичного ключа. Оно используется для уникальной идентификации записи на уровне базы данных. При создании таблицы рекомендуется сохранить предустановленное поле ID; тип первичного ключа по умолчанию — Snowflake ID (53-bit).

      20251209210153

      Наведите курсор на Interface поля ID, чтобы выбрать другой тип первичного ключа.

      20251209210517

      Доступны следующие типы первичного ключа:

      Внимание

      Для таблицы данных без первичного ключа необходимо при редактировании таблицы данных настроить «Record unique key», иначе невозможно будет создать блок на странице, а также корректно просматривать или редактировать записи.

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

      Обычные таблицы можно использовать в большинстве блоков данных и блоков фильтрации.

      БлокНазначение
      Блок таблицыПросмотр, фильтрация, сортировка и массовая обработка записей.
      Блок формыДобавление или редактирование одной записи.
      Блок подробностейПросмотр подробностей одной записи.
      Блок спискаОтображение записей в виде списка.
      Блок карточек сеткиОтображение записей, например изображений, файлов, товаров и активов, в виде сетки карточек.
      Блок канбан-доскиГруппировка и отображение записей по статусу, этапу, ответственному и другим полям.
      Блок календаряОтображение записей по дате или диапазону времени.
      Блок диаграммыСоздание статистических диаграмм на основе записей.
      Блок картыОтображение записей по географическому расположению.
      Блок диаграммы ГантаОтображение планов проектов и расписаний задач по времени начала и окончания.
      Блок фильтрации формыФильтрация блоков данных на странице с помощью условий формы.
      Блок фильтрации дереваФильтрация блоков данных на странице с помощью древовидной структуры; обычно используется для иерархической фильтрации по категориям, организациям, регионам и т. д.

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

      В списке таблиц данных нажмите «Edit» справа от обычной таблицы, чтобы изменить её основные настройки. Редактирование таблицы данных предназначено главным образом для изменения метаданных таблицы и некоторых параметров работы, но не для массового изменения структуры полей.

      Чтобы добавить поле, изменить его тип, настроить тип интерфейса поля или удалить поле, перейдите в «Configure fields».

      edit_collection

      edit_collection_configure

      НастройкаМожно редактироватьОписание
      Collection display nameДаНазвание таблицы данных, отображаемое в интерфейсе, например «Клиенты», «Заказы», «Вложения к договорам». После изменения затрагивается только отображение в интерфейсе, идентификатор таблицы данных не изменяется.
      Collection nameНетИдентификатор таблицы данных, используемый для внутренних ссылок в API, полях связей, правах доступа, рабочих процессах и т. д. После создания его нельзя изменить в форме редактирования таблицы.
      InheritsПри наличии условийВыбор родительской таблицы, от которой выполняется наследование. Доступно только для основной базы данных PostgreSQL, если эта настройка отображается в интерфейсе. Перед изменением наследования существующей таблицы необходимо убедиться, что структура полей, блоки страниц, права доступа и рабочие процессы не зависят от исходной структуры.
      CategoriesДаКатегория таблицы данных. Категория влияет только на организацию интерфейса управления таблицами данных и не изменяет структуру таблицы.
      DescriptionДаОписание таблицы данных. Подходит для указания назначения таблицы, ответственного за обслуживание, источника данных и связанных бизнес-процессов.
      Use simple pagination modeДаРежим простой пагинации. После включения при разбиении данных в блоке таблицы пропускается подсчёт общего количества записей. Подходит для таблиц с большим объёмом данных.
      Record unique keyДаУникальный идентификатор записи. Используется для определения записи в блоке; обычно выбирается первичный ключ или уникальное поле. Для таблиц данных без первичного ключа настройка обязательна, иначе невозможно корректно создать блок, просматривать или редактировать записи.
      Внимание

      Редактирование таблицы данных не изменяет автоматически существующие поля. Preset fields действует только при создании таблицы; если после создания необходимо добавить поля времени создания, создателя, времени обновления, обновившего пользователя и т. д., их нужно добавить отдельно в «Configure fields».

      Удаление таблицы данных

      В списке таблиц данных нажмите «Delete» справа от обычной таблицы, чтобы удалить таблицу данных. Для обычных таблиц в основной базе данных также поддерживается массовое удаление после выбора нескольких таблиц.

      delete_collection

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

      delete_collection_second_confirmation

      В окне подтверждения удаления есть необязательный параметр: автоматически удалить объекты, зависящие от этой таблицы. После включения NocoBase попытается также удалить объекты базы данных, зависящие от этой таблицы, например представления базы данных, созданные на её основе, а также другие объекты, которые продолжают зависеть от этих объектов.

      Предупреждение

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