MBP
GitHub
Маркетплейс/Данные/Поля и типы данных

Поля и типы данных

Поля определяют, какую информацию хранит запись. У каждого поля есть тип — он задаёт, что можно в него ввести, и как платформа проверяет и показывает значение. Тип цены не даст ввести текст, поле email проверит адрес, а поле-ссылка свяжет запись с другой записью.

Текст

  • Строка — короткий текст: название, артикул, имя
  • Длинный текст — описание или примечание, по которому работает поиск
  • Форматированный текст — текст с оформлением: заголовки, списки, выделение

Числа и деньги

  • Целое число — количество, номер
  • Дробное число — вес, объём, коэффициент
  • Деньги — сумма вместе с валютой
  • Автономер — порядковый номер, который платформа присваивает сама

Даты и логические значения

  • Дата — календарная дата без времени
  • Дата и время — момент с точностью до времени
  • Да/нет — переключатель: активно или нет, оплачено или нет

Специальные поля

  • Email — адрес электронной почты с проверкой формата
  • Ссылка (URL) — адрес сайта или страницы
  • Телефон — номер телефона
  • Список значений — выбор одного варианта из заранее заданного набора (например, статус)
  • Геолокация — точка на карте: широта и долгота

Файлы и изображения

Файловые поля хранят ссылку на файл из медиатеки — сам файл лежит в общем хранилище, а поле указывает на него:

  • Файл — прикреплённый документ
  • Изображение — картинка с готовым превью
  • Галерея — несколько изображений в одном поле

Связи между записями

Отдельные типы полей связывают записи друг с другом — так товар «знает» о своём поставщике, а заказ — о контрагенте:

  • Ссылка на запись — указывает на одну связанную запись из другой коллекции
  • Связь «многие ко многим» — соединяет запись сразу с несколькими другими
  • Обратная связь — показывает записи, которые ссылаются на текущую

Правила и проверки

У поля могут быть настроены правила, которые платформа проверяет при сохранении:

  • Обязательное — запись нельзя сохранить, пока поле не заполнено
  • Уникальное — значение не должно повторяться у других записей (например, артикул)
  • Проверка по типу — email, ссылка и другие поля контролируют формат значения

Служебные поля записи

Кроме ваших полей, каждая запись автоматически хранит служебные сведения — их не нужно заполнять вручную:

  • Когда запись создана и когда изменена в последний раз
  • Кто создал запись и кто её последним изменил
  • Внутренний идентификатор, по которому на запись ссылаются другие записи