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

Другое · 8 мин

Как обратиться к документу в 1C: справочник приёмов и ограничений

Разберём, как правильно сослаться на документ в 1C: через реквизит, ссылку, объект и модуль, с учётом прав, проведения и безопасных изменений.

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

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

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

Что означает обращение к документу в 1C

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

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

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

Только чтениеСсылка, запрос, реквизит формы

Подходит для отчётов и просмотра без записи

Изменение данныхОбъект документа через ПолучитьОбъект

Требует проверки прав и состояния проведения

Создание новогоМетод СоздатьДокумент или копирование

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

Способы получить доступ к документу

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

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

Порядок действий
  1. 1
    Определите способ идентификации документа: ссылка, реквизит, номер и дата или запрос
  2. 2
    Получите объект документа для изменения или ссылку для чтения
  3. 3
    Проверьте права доступа и состояние проведения документа
  4. 4
    Внесите изменения в реквизиты или табличные части
  5. 5
    Запишите объект и проверьте результат в базе

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

Получение объекта по ссылке

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

Доступ из формы документа

В форме документа объект часто доступен через свойство формы, связанное с открытым документом. Это удобно для команд формы, но не подходит для серверного кода без явного перехода на сервер. При работе с управляемыми формами учитывайте контекст клиента и сервера.

Работа с объектом документа: чтение и изменение

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

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

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

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

Права, проведение и блокировки

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

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

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

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

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

Данные совпадают с введёнными

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

Старые значения или пустые реквизиты

Состояние проведения
Норма

Соответствует ожидаемому

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

Документ не проведён или проведение отменено без причины

Связанные регистры
Норма

Движения обновлены корректно

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

Отсутствуют движения или есть дубли

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

Альтернативы и когда обращаться к программисту

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

Сравнение вариантов

Чтение через ссылку или запрос

Подходит для отчётов и просмотра, не меняет данные

Изменение через объект документа

Подходит для исправлений, требует прав и осторожности с проведёнными документами

Создание нового документа на основании

Подходит для дублирования и переноса данных, нужно заполнить реквизиты

Программисту стоит обращаться, если нужно менять логику проведения, создавать документы автоматически по сложным правилам, интегрировать 1C с внешними системами или исправлять ошибки в проведённых документах. Самостоятельные правки в конфигурации без понимания метаданных могут повредить базу.

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

Итог

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

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

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

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

Чем ссылка на документ отличается от объекта документа?

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

Что делать, если запись документа выдаёт ошибку прав?

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

Нужно ли программирование для простого просмотра документа?

Нет, просмотр обычно доступен через стандартную форму документа или отчёт без написания кода. Код нужен для автоматизации, изменения или интеграции.

Как убедиться, что изменения в документе сохранились?

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