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

Другое · 8 мин

Как получить документ 1С программно

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

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

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

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

H2. Отличие ссылки документа от его объекта

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

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

Получение по ссылке

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

Получение по номеру и дате

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

bsl
ДокОбъект = Документы.ИмяДокумента.ПолучитьОбъект(ДокСсылка);
Если ДокОбъект <> Неопределено Тогда
    // чтение реквизитов и табличных частей
КонецЕсли;

H2. Поиск документа по номеру, дате и реквизитам

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

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

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

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

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

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

Объект не равен неопределённому

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

Ссылка битая или документ удалён

Поиск по номеру и дате
Норма

Найдена одна подходящая ссылка

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

Найдено несколько документов или ни одного

H2. Работа в форме, на сервере и с правами доступа

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

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

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

H2. Изменение и сохранение документа

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

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

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

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

H2. Альтернативные способы получения данных

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

Внешнее соединение позволяет работать с 1С из другого приложения, но требует настройки подключения и прав пользователя. Веб-сервисы и OData часто отдают данные в структурированном виде, но не всегда предоставляют полную табличную часть или возможность записи без дополнительной разработки.

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

Прямое получение объекта внутри 1С

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

Внешнее соединение или веб-сервисы

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

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

H2. Типичные ошибки и границы самостоятельной работы

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

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

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

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

Итог

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

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

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

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

Что делать, если по номеру документа найдено несколько записей?

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

Почему запись документа может завершиться ошибкой?

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

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

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

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

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