Другое · 8 мин
Как обратиться к документу в 1C: справочник приёмов и ограничений
Разберём, как правильно сослаться на документ в 1C: через реквизит, ссылку, объект и модуль, с учётом прав, проведения и безопасных изменений.
Обращение к документу в 1C означает получение доступа к данным документа из кода, отчёта, обработки или формы. Документ может существовать как запись в базе, как ссылка на эту запись или как изменяемый объект в памяти. Выбор способа зависит от того, нужно ли только прочитать реквизиты, изменить документ или создать новый на основании существующего.
В конфигурации 1C документы описываются метаданными, а во время выполнения работа ведётся через встроенный язык. На клиенте и сервере доступны разные наборы методов: некоторые операции допустимы только на сервере, некоторые требуют вызова через контекстный менеджер транзакций, а некоторые блокируются правами доступа или состоянием документа.
Перед началом работы важно определить, какая задача стоит: просмотр текущих значений, создание документа на основании другого, проведение, отмена проведения или изменение уже проведённого документа. Неправильный выбор способа обращения может привести к ошибкам выполнения, блокировкам данных или нарушению проводок.
Что означает обращение к документу в 1C
Документ в 1C — это конфигурационный объект, экземпляры которого хранятся в информационной базе. Обращение к документу начинается с идентификации нужного экземпляра: по ссылке, по номеру и дате, через реквизит другой таблицы или через результат запроса. Ссылка сама по себе не даёт менять данные, она только указывает на запись.
Для работы с данными ссылку обычно превращают в объект документа. Объект позволяет читать и менять реквизиты, табличные части, проводить и отменять проведение. Разница между ссылкой и объектом важна: ссылка лёгкая и безопасная для передачи, объект тяжёлый и требует осторожной записи.
Если нужно только вывести значение реквизита в отчёте или форме, достаточно ссылки или выборки из запроса. Если нужно сохранить изменения, обязателен этап получения объекта, изменения его свойств и вызова метода записи. Промежуточное состояние объекта не сохраняется автоматически.
Подходит для отчётов и просмотра без записи
Требует проверки прав и состояния проведения
Нужно заполнить реквизиты и провести при необходимости
Способы получить доступ к документу
Самый частый способ — обращение по ссылке. Ссылка может приходить из реквизита формы, из табличной части другого документа, из результата запроса или из параметра вызова обработки. Получить объект по ссылке позволяет работать с конкретным экземпляром документа, даже если его номер или дата неизвестны заранее.
Доступ через реквизит формы удобен в интерфейсе: пользователь открывает документ, а код формы может обратиться к его объекту через стандартные свойства формы. Такой подход зависит от типа формы — управляемая или обычная — и от контекста, в котором открыт документ.
- 1Определите способ идентификации документа: ссылка, реквизит, номер и дата или запрос
- 2Получите объект документа для изменения или ссылку для чтения
- 3Проверьте права доступа и состояние проведения документа
- 4Внесите изменения в реквизиты или табличные части
- 5Запишите объект и проверьте результат в базе
Поиск по номеру и дате применяется, когда ссылка недоступна, но известны внешние идентификаторы. Этот способ менее надёжен, если в конфигурации возможны одинаковые номера или документы ведутся по разным организациям. Лучше сочетать номер, дату и организацию для уточнения поиска.
Получение объекта по ссылке
В модуле объекта или модуле менеджера документа используется получение объекта по ссылке. После этого к объекту применяются свойства реквизитов и табличных частей.
Доступ из формы документа
В форме документа объект часто доступен через свойство формы, связанное с открытым документом. Это удобно для команд формы, но не подходит для серверного кода без явного перехода на сервер. При работе с управляемыми формами учитывайте контекст клиента и сервера.
Работа с объектом документа: чтение и изменение
Чтение реквизитов объекта не требует специальных разрешений Beyond обычных прав на просмотр, но изменение требует права на запись по документу. Если документ проведён, прямое изменение может быть заблокировано или привести к несоответствию проводок. В таких случаях используется отмена проведения, корректировка или создание нового документа.
Табличные части документов изменяются через строки табличной части объекта. Нужно добавлять, удалять или редактировать строки, а затем записывать объект целиком. Частичная запись только одной строки без записи документа не сохраняет изменения.
После записи объекта рекомендуется проверить, что документ сохранился с ожидаемыми значениями, проведение выполнено корректно, а связанные регистры обновились. Это особенно важно при изменении проведённых документов, где ошибка затрагивает бухгалтерские или налоговые записи.
Права, проведение и блокировки
Права доступа в 1C настраиваются по ролям и могут ограничивать чтение, запись, проведение и удаление документов. Даже если код корректно получает объект, запись может быть отклонена из-за отсутствия прав. Проверка прав должна быть частью логики обработки, а не последействием.
Проведение документа создаёт движения по регистрам бухгалтерии, налогового или управленческого учёта. Отмена проведения отменяет эти движения, но не всегда удаляет документ. Изменение проведённого документа без отмены проведения может оставить базу в неконсистентном состоянии.
Как проверить результат
Данные совпадают с введёнными
Старые значения или пустые реквизиты
Соответствует ожидаемому
Документ не проведён или проведение отменено без причины
Движения обновлены корректно
Отсутствуют движения или есть дубли
При одновременной работе нескольких пользователей возможны блокировки записей. Если один пользователь открыл документ на редактирование, другой может получить ошибку при попытке записи. Долгие операции с объектом документа увеличивают вероятность конфликтов, поэтому код должен быть кратким и целенаправленным.
Альтернативы и когда обращаться к программисту
Если задача решается стандартными отчётами, обработками или встроенными командами конфигурации, программирование не требуется. Например, просмотр документа, печать или создание документа на основании через типовые команды часто доступны из интерфейса без кода.
Сравнение вариантов
Подходит для отчётов и просмотра, не меняет данные
Подходит для исправлений, требует прав и осторожности с проведёнными документами
Подходит для дублирования и переноса данных, нужно заполнить реквизиты
Программисту стоит обращаться, если нужно менять логику проведения, создавать документы автоматически по сложным правилам, интегрировать 1C с внешними системами или исправлять ошибки в проведённых документах. Самостоятельные правки в конфигурации без понимания метаданных могут повредить базу.
Альтернативой прямому обращению к документу может быть использование регистров накопления, отчётов или внешних обработок, которые читают данные без изменения документов. Это безопаснее для аналитики и не рискует целостностью проводок.
Что важно запомнить
Обращайтесь к документу через ссылку для чтения и через объект для записи, проверяйте права и проведение, не правьте проведённые документы без отмены проведения.
Можно ли изменить проведённый документ напрямую?
Обычно нет без отмены проведения, так как прямое изменение может нарушить движения по регистрам. Используйте отмену проведения, корректировку или новый документ в зависимости от правил конфигурации.
Чем ссылка на документ отличается от объекта документа?
Ссылка только указывает на запись и подходит для чтения и передачи, а объект позволяет изменять реквизиты и требует явной записи для сохранения изменений.
Что делать, если запись документа выдаёт ошибку прав?
Проверьте роль пользователя и права на запись по данному документу. Если прав недостаточно, обратитесь к администратору или измените процесс, а не обходите ограничения в коде.
Нужно ли программирование для простого просмотра документа?
Нет, просмотр обычно доступен через стандартную форму документа или отчёт без написания кода. Код нужен для автоматизации, изменения или интеграции.
Как убедиться, что изменения в документе сохранились?
После записи объекта снова откройте документ или выполните запрос по его ссылке и сравните значения реквизитов и состояние проведения с ожидаемыми.