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

Другое · 8 мин

Как записать текущий документ в 1С

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

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

Важно различать запись документа и его проведение. Запись фиксирует значения реквизитов, а проведение создаёт движения по регистрам бухгалтерского, налогового и управленческого учёта. Документ можно записать без проведения, тогда он останется в состоянии «Не проведен» и не повлияет на остатки.

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

Что означает запись документа в 1С

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

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

Основные способы записи текущего документа

Самый распространённый способ — нажатие кнопки «Записать» или «Записать и закрыть» на командной панели формы документа. Это стандартное поведение управляемых форм, которое не требует написания кода. Пользователь видит сообщение об успешном сохранении или предупреждение о незаполненных обязательных реквизитах.

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

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

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

Программная запись без открытия формы

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

Порядок записи документа из формы
  1. 1
    Откройте документ в режиме редактирования.
  2. 2
    Заполните обязательные реквизиты и табличную часть.
  3. 3
    Нажмите «Записать» или «Записать и закрыть».
  4. 4
    При необходимости проведите документ отдельной командой.
  5. 5
    Убедитесь, что документ появился в списке с номером и статусом.

Запись с проведением

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

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

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

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

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

Документ в списке с номером
Норма

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

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

Форма осталась открытой без номера или появилась ошибка

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

Пометка «Проведен» или «Не проведен» соответствует действию

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

Документ записан, но проведение не запущено при необходимости

Движения по регистрам
Норма

После проведения движения появились в соответствующих регистрах

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

Регистры пусты несмотря на отметку о проведении

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

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

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

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

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

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

Частые ошибки и как их избегать

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

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

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

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

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

Маршрут решения

Как выбрать способ записи

Документ заполняется пользователем в формеИспользуйте стандартную команду записи формы.
Нужно сохранить документ автоматически в обработкеВызывайте метод Записать() у объекта документа в серверном модуле.
Требуется изменение остатков после записиПосле записи выполните проведение документа.

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

Как выбрать способ записи

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

Итог

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

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

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

Нет. Запись и проведение — разные операции. Документ можно сохранить без проведения, тогда он останется в состоянии «Не проведен» и не изменит остатки. Проведение требуется, только если документ должен влиять на регистры учёта.

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

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

Можно ли отменить уже записанный документ?

Записанный документ нельзя просто «отменить» нажатием кнопки в форме. Его можно пометить на удаление, если это разрешено правами, или создать сторнирующий документ, а также отменить проведение, если документ был проведен. Удаление проведенного документа часто ограничено и требует прав администратора.

В чем разница между записью и сохранением формы?

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