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

Другое · 7 мин

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

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

Программное изменение документа в 1C выполняется через объект документа, а не через форму интерфейса. Сначала получается ссылка на документ по номеру, дате, уникальному идентификатору или другому реквизиту, затем через метод ПолучитьОбъект() открывается редактируемый экземпляр.

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

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

Когда программная правка оправдана

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

Массовое исправление реквизитов

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

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

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

Ссылку можно получить через НайдиПоНомеру, ПоУникальномуИдентификатору, из таблицы документов или по результату запроса. После получения ссылки вызывается ПолучитьОбъект(Ссылка), который возвращает объект для редактирования реквизитов и табличных частей.

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

Редактирование реквизитов и запись

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

Режим записиКогда используетсяОсобенность
Обычная Запись()Не проведенный документСохраняет реквизиты без проведения
Запись(РежимЗаписи.Редактирование)Требуется явно указать режим редактированияПозволяет менять проведенные документы после отмены проведения
ПроведениеПосле исправления проведенного документаВосстанавливает движения и регистры
Отмена проведенияПеред изменением проведенного документаУдаляет движения, делает документ редактируемым

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

Объект = Документы.РеализацияТоваровИУслуг.ПолучитьОбъект(Ссылка);
Объект.Комментарий = "Исправлено программно";
Объект.Запись();

Проведенные документы: отмена проведения и повторное проведение

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

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

Права, блокировки и транзакции

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

Для группы связанных изменений можно использовать транзакцию: НачатьТранзакцию, изменения, ЗафиксироватьТранзакцию или ОтменитьТранзакцию при ошибке. Это помогает избежать частичного сохранения, если одна из операций не удалась.

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

Ограничения и риски

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

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

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

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

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

Итог

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

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

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

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

Что делать если Запись() выдает ошибку блокировки?

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

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

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

Как понять, что изменения применены?

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

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

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