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

Другое · 7 мин

Как получить объект справочника в 1C: ссылка, объект и запись

Как в 1C получить объект справочника по ссылке, коду или наименованию, создать и записать элемент, проверить результат и избежать основных ошибок.

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

Прямое изменение ссылки невозможно: у ссылки нет свойств для записи. Чтобы отредактировать элемент, нужно получить объект по ссылке, заполнить поля и вызвать метод записи. Это базовое правило при работе со справочниками в скрипте 1C.

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

Ссылка и объект: что использовать

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

Получить объект можно только из ссылки. Типичная конструкция выглядит так: сначала находится ссылка по коду, наименованию или другому уникальному реквизиту, затем вызывается метод ПолучениеОбъекта(). Только объект даёт возможность изменять Наименование, ИНН, Родителя и другие реквизиты.

Получение объекта по коду или наименованию

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

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

Как получить объект по существующей записи

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

Порядок действий такой: проверить, что ссылка заполнена; вызвать получение объекта; при необходимости изменить поля; вызвать запись объекта. Если запись не требуется, объект можно использовать только для чтения реквизитов.

Порядок изменения элемента справочника
  1. 1
    Найти ссылку по коду, наименованию или текущей строке формы
  2. 2
    Получить объект по ссылке
  3. 3
    Изменить реквизиты объекта
  4. 4
    Вызвать запись объекта
  5. 5
    Проверить сохранённые реквизиты

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

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

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

Есть ссылкаМожно получить объект

Проверьте, что ссылка не пустая и указывает на существующий элемент

Нужен новый элементСоздайте объект через создание элемента

Заполните обязательные реквизиты перед записью

Работа между сеансамиПередавайте только ссылку

Объект не переносится в другой сеанс

После заполнения реквизитов вызывается запись объекта. Если запись прошла успешно, элемент появляется в справочнике и получает код, если он не был задан вручную. При ошибке записи объект остаётся в памяти, но не сохраняется в базе.

Создавать элементы программно стоит только при чётком понимании уникальности данных. Иначе возможны дубликаты контрагентов, номенклатуры или других справочных записей, которые потом сложно объединить.

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

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

Значения реквизитов после записи
Норма

Реквизиты совпадают с введёнными

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

Значения остались старыми или пустыми

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

Элемент найден по коду или наименованию

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

Элемент отсутствует или создан дубликат

Особенности клиент-серверной работы

В клиент-серверных вариантах получение объекта и запись часто выполняются на сервере, а ссылка передаётся от клиента. Это снижает объём передаваемых данных и позволяет использовать серверные процедуры для изменения справочников. Клиент получает только результат или обновлённую ссылку.

Объект, полученный на клиенте, не всегда подходит для прямого изменения в серверной процедуре. Безопаснее передать ссылку на сервер, там получить объект, изменить и записать. Так уменьшается риск конфликтов и потери данных при одновременной работе нескольких пользователей.

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

Проверка результата и типичные ошибки

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

Типичные ошибки
01
Попытка изменить ссылку напрямую — изменения не сохранятся
02
Запись объекта без проверки обязательных реквизитов — отказ при записи
03
Использование объекта в другом сеансе — ошибка доступа к объекту

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

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

Итог

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

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

Можно ли изменить справочник напрямую по ссылке?

Нет. Ссылка только идентифицирует запись. Для изменения нужно получить объект по ссылке, изменить его реквизиты и вызвать запись.

Что делать, если поиск по наименованию нашёл несколько записей?

Не редактировать первую попавшуюся. Уточните поиск по коду, ИНН, артикулу или другому уникальному реквизиту, чтобы не изменить чужую запись.

Можно ли сохранить объект справочника в переменной и использовать позже?

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

Нужно ли всегда вызывать запись после создания объекта?

Да, если изменения должны остаться в базе. Без вызова записи объект существует только в памяти сеанса и пропадает при закрытии формы или сеанса.

Безопасно ли править справочник программно на рабочей базе?

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