Что такое сущность в 1С и как с ней работать

Сущность в 1С — это любой объект конфигурации, который описывает предметную область и хранится в базе данных: справочник, документ, регистр, план счетов, перечисление. Когда бухгалтер создаёт контрагента, а менеджер проводит накладную, они работают с сущностями, хотя в пользовательском интерфейсе это слово обычно не встречается. Термин пришёл из инженерии данных и в 1С используется в основном разработчиками и внедренцами.

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

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

Что считается сущностью в платформе 1С

Строгого термина «сущность» в документации платформы нет — это обобщающее понятие. Под сущностями понимают объекты метаданных, которые порождают конкретные записи в базе данных. К ним относятся справочники, документы, планы видов характеристик, планы счетов, планы видов расчёта, регистры (сведений, накопления, бухгалтерии, расчёта), а также перечисления и бизнес-процессы с задачами.

Каждая сущность описывается структурой: стандартные реквизиты (код, наименование, ссылка, дата у документа), пользовательские реквизиты, табличные части и, для регистров, измерения, ресурсы и реквизиты. Структура задаётся в конфигураторе и не меняется без обновления конфигурации базы данных.

Важно различать тип сущности и её экземпляр. «Справочник.Номенклатура» — это тип сущности, а конкретная позиция «Кабель ВВГ 3×2,5» — экземпляр. В запросах и коде тип определяет доступные поля, а экземпляр идентифицируется уникальной ссылкой (GUID).

Ссылочные сущности: справочники и документы

Ссылочные сущности — это объекты, на которые можно сослаться из других объектов. Справочники хранят условно-постоянную информацию: номенклатуру, контрагентов, склады, договоры. Они поддерживают иерархию, владельцев (подчинённые справочники) и предопределённые элементы, доступные в коде по имени.

Документы отражают события хозяйственной жизни: поступление товара, реализацию, начисление зарплаты. Ключевые особенности документа — позиция на оси времени (дата и время), возможность проведения и формирование движений по регистрам. Непроведённый документ существует в базе, но не влияет на учётные итоги.

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

Регистры: сущности для накопления данных

Регистры отличаются от справочников и документов принципиально: на запись регистра нельзя сослаться, записи идентифицируются набором измерений и (для периодических) периодом. Регистр сведений хранит факты в разрезе измерений — курсы валют, цены номенклатуры, штрихкоды. Регистр накопления хранит обороты и остатки — товары на складах, взаиморасчёты.

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

Сущности в запросах и коде

В языке запросов 1С к сущности обращаются по полному имени: Справочник.Номенклатура, Документ.РеализацияТоваровУслуг, РегистрНакопления.ТоварыНаСкладах.Остатки. Виртуальные таблицы регистров (Остатки, Обороты, СрезПоследних) — тоже своего рода сущности, материализуемые платформой на лету.

Во встроенном языке работа идёт через менеджеры объектов: Справочники.Номенклатура.СоздатьЭлемент() создаёт новый экземпляр сущности, Документы.РеализацияТоваровУслуг.НайтиПоНомеру() находит существующий. Запись объекта выполняется методом Записать(), проведение документа — Записать(РежимЗаписиДокумента.Проведение).

НовыйЭлемент = Справочники.Номенклатура.СоздатьЭлемент();
НовыйЭлемент.Наименование = "Кабель ВВГ 3x2,5";
НовыйЭлемент.Записать();
СсылкаНаСущность = НовыйЭлемент.Ссылка;

При обращении к реквизитам через точку от ссылки («разыменование») платформа выполняет скрытый запрос к базе. В циклах это приводит к резкому росту числа обращений к СУБД — выбирайте нужные поля одним запросом вместо обхода ссылок.

Сущности при интеграциях и обменах

При обмене с внешними системами сущности 1С становятся видимыми напрямую. Стандартный интерфейс OData публикует объекты конфигурации как наборы сущностей: Catalog_Номенклатура, Document_РеализацияТоваровУслуг. Внешняя система читает и создаёт записи через HTTP-запросы, а платформа сама заботится о правах и транзакциях.

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

Как выбрать тип сущности для своих данных

Главный вопрос при проектировании: данные описывают объект, событие или факт в разрезе аналитик. Объект с долгим жизненным циклом — справочник. Событие с датой и влиянием на учёт — документ. Факт в разрезе измерений без самостоятельной ссылки — регистр сведений. Обороты и остатки — регистр накопления.

Типичная ошибка — хранить изменяемые во времени данные в реквизитах справочника. Цена товара в реквизите номенклатуры перезаписывается и теряет историю; правильное решение — периодический регистр сведений «Цены номенклатуры». Обратная ошибка — выносить в регистр то, что должно быть ссылкой: список складов как записи регистра сведений вместо справочника ломает отборы и права.

Частые ошибки при работе с сущностями

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

Отдельно стоит пометка на удаление. Удалить сущность, на которую есть ссылки, платформа не даст — но пометить можно, и «битые ссылки» появятся только если обойти контроль. Перед удалением всегда выполняйте поиск ссылок на объект.

FAQ: частые вопросы о сущностях в 1С