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

Другое · 5 мин

Как программно записать документ в 1С 8.3

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

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

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

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

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

Основные способы программной записи

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

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

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

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

Ссылка на документ после записи
Норма

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

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

Ошибка записи или ссылка не возвращена

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

Данные сохранены без изменений

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

Реквизиты не сохранились или сбросились

Табличная часть
Норма

Строки на месте и заполнены

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

Табличная часть пустая или частичная

Порядок действий при программной записи

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

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

Проверка результата и обработка ошибок

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

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

Типичные ошибки
01
Запись проведенного документа без отмены проведения
02
Заполнение только заголовка при пустой табличной части
03
Отсутствие прав на запись документа у текущего пользователя

Ограничения и частые ошибки

Частая ошибка — попытка записать проведенный документ без отмены проведения. Многие конфигурации запрещают изменение проведенных документов, поэтому перед правкой нужно отменить проведение, а после записи провести документ повторно, если это требуется бизнес-логикой.

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

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

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

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

Итог

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

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

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

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

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

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

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

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

Как понять, что документ записался успешно?

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