К статье
Практический материал

Быстрый старт · 10 мин

Элемент в 1С:Предприятие — что это такое и как с ним работать

Что такое элемент в 1С:Предприятие: элементы справочников, форм и коллекций. Разбор термина, примеры работы, типичные ошибки и ответы на вопросы.

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

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

Второй частый смысл — элемент формы. Это визуальные компоненты экрана: поля ввода, кнопки, таблицы, надписи, флажки. Разработчик в конфигураторе добавляет на форму элементы и настраивает их свойства. Третий смысл — элемент коллекции: одна строка табличной части документа, одна запись в массиве или таблице значений при программной работе.

Элемент справочника — основное значение термина

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

Элементы справочника могут объединяться в группы — это похоже на папки в файловой системе. Например, справочник «Номенклатура» может содержать группы «Материалы», «Готовая продукция», «Услуги», а внутри них — конкретные элементы. Группа тоже является особым видом элемента, но служит только для структурирования и не участвует в документах как самостоятельный объект.

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

Элементы формы — что видит пользователь на экране

Любое окно в 1С — это форма, собранная из элементов. Поле ввода наименования, кнопка «Записать и закрыть», табличная часть документа, надпись-подсказка, флажок «Проведён» — всё это элементы формы. У каждого есть имя, вид и набор свойств: видимость, доступность, заголовок, подсказка, связь с данными объекта.

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

Ошибка «Элемент формы с именем ... не найден» при открытии окна означает, что программный код обращается к элементу, которого нет в дереве формы — например, после переименования или удаления поля. Такая ситуация исправляется только в конфигураторе: нужно либо вернуть элемент, либо скорректировать код.

Элементы коллекций в программном коде

Для разработчика «элемент» — это ещё и единица коллекции: строка табличной части, запись в массиве, структуре или таблице значений. Обход коллекции выполняется циклом «Для каждого Элемент Из Коллекция Цикл», где переменная «Элемент» на каждой итерации содержит очередную строку или значение.

Типичный пример — перебор строк табличной части «Товары» документа реализации. Каждая строка — элемент табличной части, у которого доступны реквизиты: номенклатура, количество, цена, сумма. Изменение этих значений внутри цикла меняет данные документа, поэтому важно понимать, что работа идёт с реальными данными объекта, а не с копией.

bsl
Для каждого СтрокаТовара Из Объект.Товары Цикл
    СтрокаТовара.Сумма = СтрокаТовара.Количество * СтрокаТовара.Цена;
КонецЦикла;

Как создать и отредактировать элемент справочника

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

Создание элемента справочника
  1. 1
    Откройте нужный справочник через раздел меню (например, «Справочники» → «Номенклатура»).
  2. 2
    Нажмите кнопку «Создать» — откроется пустая карточка элемента.
  3. 3
    Заполните обязательные реквизиты: они обычно подчёркнуты красным или отмечены звёздочкой.
  4. 4
    Нажмите «Записать и закрыть» — элемент появится в общем списке.
  5. 5
    Проверьте, что элемент отображается в нужной группе и корректно подставляется в документы.

Если кнопка «Создать» недоступна, у пользователя нет прав на добавление элементов в этот справочник. Права настраиваются администратором через роли и профили групп доступа. Самостоятельно «обходить» ограничение не нужно — это признак осознанного разграничения доступа в организации.

Для массового изменения элементов (например, замены ставки НДС у группы товаров) в типовых конфигурациях есть обработка «Групповое изменение реквизитов» в разделе «Администрирование». Она позволяет выбрать список элементов по отбору и изменить нужные поля у всех сразу. Перед массовой операцией рекомендуется сделать резервную копию или хотя бы проверить отбор на небольшой выборке.

Элемент, объект и запись — в чём разница

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

Элемент, объект, запись

Элемент справочника

Одна карточка в списке однотипных объектов: товар, контрагент. Есть код, наименование, ссылка.

Объект конфигурации

Тип метаданных: справочник, документ, отчёт. Описывает структуру, а не конкретные данные.

Запись регистра

Строка в регистре сведений или накопления. Не имеет наименования и ссылки, как у элемента.

Элемент формы

Визуальный компонент экрана: поле, кнопка, таблица. Данных не хранит, только отображает.

Практический вывод: когда в сообщении об ошибке или инструкции встречается слово «элемент», смотрите на контекст. «Элемент не найден в справочнике» — проблема с данными. «Элемент формы недоступен» — проблема с настройкой интерфейса или прав. «Элемент коллекции» — речь о программном коде.

Типичные ошибки при работе с элементами

Типичные ошибки
01
Создание дублей: пользователь заводит второй элемент вместо поиска существующего. Последствие — раздвоение аналитики в отчётах. Решение: перед созданием использовать поиск по наименованию и ИНН/артикулу.
02
Переименование элемента вместо создания нового: старые документы начинают отображать новое название, что искажает историю.
03
Удаление используемого элемента без контроля ссылок: документы показывают «Объект не найден».
04
Путаница между группой и элементом: в документ пытаются подставить группу справочника, что система не позволяет.
05
Редактирование предопределённых элементов: изменение служебных записей, заданных конфигурацией, может нарушить логику типовых алгоритмов.

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

Если в справочнике накопились дубли, не удаляйте их вручную. В типовых конфигурациях есть обработка «Поиск и удаление дублей» (раздел «Администрирование» → «Обслуживание»): она находит похожие элементы и автоматически заменяет ссылки в документах на выбранный «правильный» элемент.
ПЗ
Практическое замечание

Как проверить, что всё сделано правильно

Контрольные точки

Как проверить результат

Новый элемент в списке
Норма

Элемент виден в нужной группе, реквизиты заполнены, подставляется в документы

Тревожный признак

Элемент не отображается или находится не в той группе — проверьте отбор списка и права

Ссылки на элемент
Норма

В документах элемент выбирается из списка и корректно отображается

Тревожный признак

В документах надпись «Объект не найден» — элемент был удалён, нужно восстановление или замена ссылок

Дубли
Норма

Поиск по наименованию и ключевым реквизитам выдаёт один элемент

Тревожный признак

Несколько одинаковых записей — требуется объединение через обработку дублей

Для проверки, где используется элемент, есть стандартная команда «Ссылки на объект» (обычно доступна по правой кнопке мыши или в меню «Ещё» карточки элемента). Она показывает все документы и регистры, где встречается данная запись. Это самый надёжный способ оценить последствия перед удалением или серьёзной правкой.

Итог

Что важно запомнить

Элемент в 1С — это единица внутри структуры: запись справочника, компонент формы или объект коллекции. Чаще всего термин означает карточку в справочнике. Работайте с элементами аккуратно: проверяйте дубли, не удаляйте используемые записи без контроля ссылок и не трогайте предопределённые элементы.

Частые вопросы

Чем элемент справочника отличается от документа?

Элемент справочника — это постоянная учётная единица (товар, контрагент), которая хранит справочную информацию и не меняет состояние учёта сама по себе. Документ фиксирует событие (поступление, продажа, оплату) и при проведении формирует движения по регистрам. Справочники отвечают на вопрос «что это», документы — «что произошло».

Почему при удалении элемента появляется сообщение о ссылках?

Система проверяет, используется ли элемент в документах, регистрах или других справочниках. Если используется, физическое удаление заблокировано: иначе в документах осталась бы «битая» ссылка. Сначала замените или очистите ссылки в найденных объектах, затем повторите удаление.

Что такое предопределённый элемент и можно ли его менять?

Это элемент, созданный разработчиком конфигурации и используемый в программном коде по фиксированному имени (например, типовая валюта или вид номенклатуры). Переименовывать и удалять его не следует — алгоритмы, обращающиеся к нему, перестанут работать. Обычно платформа сама блокирует такие действия.

Как найти нужный элемент в большом справочнике?

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

Что означает ошибка «Элемент формы не найден»?

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

Можно ли восстановить случайно удалённый элемент?

Если элемент только помечен на удаление — снимите пометку через команду в списке (покажите помеченные объекты и отмените пометку). Если выполнено физическое удаление, восстановить запись можно только из резервной копии базы. Поэтому перед чисткой справочников всегда делайте выгрузку или копию.