Типы сущностей

Тип сущности — это схема, которая описывает вид бизнес-записей. Каждый тип сущности относится к одному из восьми супертипов и содержит набор полей, организованных в группы.

Эта страница описывает механизм. Конкретные виды — типы документов, поля, статусы — определяются для вашей организации и могут отличаться. См. систему сущностей.

Создание типа сущности

Чтобы создать тип сущности, откройте раздел «Сущности», выберите папку супертипа (например, «Справочники») и нажмите «Создать тип».

Для каждого типа сущности нужны:

Отображаемое название

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

Машинное имя

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

Машинное имя нельзя изменить после сохранения типа сущности. Выбирайте его внимательно.

Машинные имена уникальны во всей организации: у двух типов сущностей не может быть одинакового машинного имени, а зарезервированные системные имена (Deal, File, Proposal, Employee, Employee Group, Customer, Contact, Digital Inventory, Printed Inventory, Tag и Price List) использовать нельзя.

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

Группы полей

Поля типа сущности организованы в группы. Каждое поле входит в какую-нибудь группу.

У группы есть собственное отображаемое название и машинное имя (к ним применяются те же правила уникальности и неизменности, что и к машинным именам типов сущностей). Группы служат визуальными разделами, когда пользователь просматривает или редактирует запись этого типа.

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

Порядок групп и полей

У групп и полей есть порядок отображения. Действие «Отредактировать порядок» перемещает группы вверх или вниз на странице и меняет порядок полей внутри группы.

Порядок отображения определяет:

  • порядок разделов и полей в формах создания и редактирования записи;

  • порядок колонок, когда поля показываются в списках;

  • порядок полей в экспортируемых файлах схемы.

Добавление и редактирование полей

Каждое поле (в интерфейсе оно называется «тип данных») описывает одну единицу данных типа сущности. При добавлении поля вы выбираете:

  • отображаемое название и машинное имя (правила те же, что для типов сущностей);

  • тип данных — один из девяти типов, описанных в разделе типы данных;

  • необязательные флаги поведения: обязательное поле (при сохранении записи у поля должно быть значение) и уникальное значение (у двух записей этого типа сущности не может быть одинакового значения этого поля);

  • настройки, зависящие от типа, например точность поля с датой (только дата или дата со временем), целевой тип сущности поля-ссылки или формулу поля-выражения. NOTE: Флаг уникальности проверяется по существующим данным только для типов сущностей, которые относятся к супертипам «Документ», «Контрагент», «Справочник», «Задача», «Группа сотрудников» или «Предложение».

Уникальность машинных имён

Машинные имена полей подчиняются тому же шаблону, что и машинные имена типов сущностей: они должны начинаться с буквы, могут содержать буквы, цифры и знаки подчёркивания и не меняются после создания.

Машинные имена полей уникальны в организации среди всех полей всех типов сущностей, а не только внутри одного типа. Если у типа сущности A уже есть поле с машинным именем notes, у типа сущности B не может быть поля с таким же машинным именем.

Это правило действует и при копировании поля. Действие копирования дублирует настройки поля, включая машинное имя. Перед сохранением измените машинное имя скопированного поля на уникальное, иначе сохранение завершится ошибкой.

Редактирование существующего типа сущности

Откройте тип сущности из папки его супертипа и нажмите «Редактировать». На странице редактирования вы можете:

  • переименовать тип сущности (меняется только отображаемое название, машинное имя остаётся прежним);

  • добавлять, редактировать и удалять группы полей;

  • добавлять, редактировать, переупорядочивать и удалять поля внутри групп;

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

  • менять настройки поля, зависящие от типа (например, переключать поле с датой между точностью «только дата» и «дата и время»).

Изменения вступают в силу, когда вы сохраняете тип сущности.

Удаление поля

Если вы убрали поле в редакторе групп и сохранили тип сущности, определение этого поля удаляется навсегда. Отменить это нельзя, и дополнительного подтверждения, кроме самого сохранения, нет.

У существующих записей, в которых были значения удалённого поля, эти значения остаются в хранилище, но больше не показываются, не проверяются и не попадают в экспорт. Через интерфейс эти данные недоступны.

Удаление поля в редакторе типа сущности происходит сразу и необратимо. Перед сохранением внимательно проверьте список полей, особенно если удаляете поля, в которых могут быть данные.

Архивирование типа сущности

Архивирование — это мягкое отключение. Архивный тип сущности:

  • больше не появляется в списках выбора при создании — пользователи не могут создавать новые записи этого типа;

  • больше не появляется как цель при настройке нового поля-ссылки;

  • сохраняет все существующие записи — они остаются доступными и работают.

Чтобы архивировать тип сущности, нажмите «Архивировать» на странице типа или в списке. Чтобы вернуть тип, используйте то же действие и снимите флаг архивации.

Удаление типа сущности

Удаление безвозвратно убирает тип сущности и определения его полей. Действие доступно только для пользовательских типов сущностей, которые задал администратор. Встроенные системные типы удалить нельзя.

Связанные страницы

Типы данных описывают девять доступных типов полей. Вложенные сущности описывают структуры с повторяющимися строками. Права на поля описывают управление доступом к отдельным полям. Перенос схемы описывает перенос определений типов сущностей между организациями.