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

← На главную

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

Анализ типовой ошибки при вызове метода Записать()

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

Посмотрим на пример кода с ошибкой:


Объект = ВыборкаДетальныеЗаписи.Ссылка.ПолучитьОбъект();
Если Объект.Проведен Тогда
    Сообщить("Документ проведен!");
    Записать(РежимЗаписиДокумента.ОтменаПроведения); // Ошибка!
КонецЕсли;

В результате выполнения такого кода платформа выдает синтаксическую ошибку: «Процедура или функция с указанным именем не определена (Записать)».

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

Объект.Записать(РежимЗаписиДокумента.ОтменаПроведения);

Пошаговый алгоритм отмены проведения документа через запрос

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

Формирование текста запроса с фильтрацией: Чтобы избежать лишней нагрузки на базу данных и не читать объекты, которые уже не проведены, условие Проведен = ИСТИНА следует добавлять непосредственно в секцию ГДЕ текста запроса.
Учет уникальности номера: В конфигурациях 1С нумерация документов может быть периодической (например, сбрасываться каждый год) или зависеть от префикса организации. Для точечного поиска желательно дополнительно ограничивать выборку периодом или организацией.
Обход выборки и модификация: Для каждой найденной ссылки получаем экземпляр ДокументОбъект и вызываем его метод записи.

Рассмотрим полный рабочий пример серверной процедуры:


&НаСервере
Процедура РаспровестиДокументыПоНомеру(НомерДокумента)
    
    Запрос = Новый Запрос;
    Запрос.Текст =
    "ВЫБРАТЬ
    |    ЧекНаОплату.Ссылка КАК Ссылка,
    |    ЧекНаОплату.Номер КАК Номер
    |ИЗ
    |    Документ.ЧекНаОплату КАК ЧекНаОплату
    |ГДЕ
    |    ЧекНаОплату.Номер = &Номер
    |    И ЧекНаОплату.Проведен = ИСТИНА";
    
    Запрос.УстановитьПараметр("Номер", НомерДокумента);
    РезультатЗапроса = Запрос.Выполнить();
    Выборка = РезультатЗапроса.Выбрать();
    
    Пока Выборка.Следующий() Цикл
        
        Попытка
            ДокументОбъект = Выборка.Ссылка.ПолучитьОбъект();
            
            // Выполняем отмену проведения
            ДокументОбъект.Записать(РежимЗаписиДокумента.ОтменаПроведения);
            
            Сообщить("Успешно распроведен документ № " + Выборка.Номер);
        Исключение
            Сообщить("Ошибка при отмене проведения документа № " + Выборка.Номер + ": " + ОписаниеОшибки());
        КонецПопытки;
        
    КонецЦикла;
    
КонецПроцедуры

Особенности клиент-серверного контекста и блокировок

Проанализируем важные технические нюансы, которые необходимо соблюдать в среде 1С:Предприятие 8.3:

Контекст выполнения: Методы ПолучитьОбъект() и Записать() доступны исключительно на стороне сервера. В управляемом приложении вызов процедуры должен предваряться директивой &НаСервере или &НаСервереБезКонтекста.
Безопасность транзакций: При отмене проведения вызывается модуль документа (событие ОбработкаУдаленияПроведения), могут сработать проверки дат запрета изменения данных или блокировки торгового оборудования (онлайн-касс). Оборачивание вызова в блок Попытка ... Исключение защищает пакетную обработку от аварийного прерывания.
Альтернативный поиск: Если требуется найти единичный документ по известному номеру и точной дате, можно воспользоваться методом менеджера Документы.ЧекНаОплату.НайтиПоНомеру(НомерДокумента, ДатаДокумента).

Корректная инициализация дат и реквизитов формы

Нередко в обработках требуется задать начальные параметры дат при открытии. Разберем типичные ошибки, возникающие при неверном обращении к элементам формы и типам данных 1С.

Неверный подход:


// Ошибка: обращение к элементам как к данным и неверный строковый литерал даты
Форма = ЭлементыФормы.ПолеВвода;
Форма.НачДата = '04.04.2018';

Разберем правила работы с формой и литералами:

Разделение данных и интерфейса: В управляемых формах значения хранятся в реквизитах формы (или реквизитах объекта), а коллекция Элементы отвечает только за визуальное отображение. Значения присваиваются напрямую переменной реквизита: НачПериода = ...;.
Формат литерала даты: Строковый формат с точками '04.04.2018' не распознается синтаксисом платформы как дата. Канонический литерал задается в одинарных кавычках в формате ГГГГММДД (или ГГГГММДДЧЧММСС), например: '20180404'.
Конструктор даты: Для явного создания даты можно использовать встроенную функцию Дата(Год, Месяц, День).

Посмотрим на корректный пример инициализации реквизитов формы:


&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    
    // Инициализация реквизитов формы при создании
    НачДата = '20180404'; // Канонический литерал ГГГГММДД
    КонДата = Дата(2018, 4, 5); // Через конструктор даты
    
КонецПроцедуры

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