Обработка результата запроса кодом

Выполнение кода возможно в пяти режимах.

Простое выполнение

Код просто выполняется на сервере, выполнение происходит один раз. В этом режиме на клиенте нет никакой индикации прогресса выполнения. Обход результата запроса необходимо организовать самостоятельно. В коде можно использовать Сообщить, но сообщения можно будет увидеть только после завершения выполнения. Можно рекомендовать такой вариант, если алгоритм выполняется не долго.

Переменные, доступные в коде:

Выборка - выборка из результата запроса.

Параметры - параметры запроса.

Пример.
Пока Выборка.Следующий() Цикл
    Выборка.Ссылка.ПолучитьОбъект().Удалить();
КонецЦикла;

Построчно без индикации

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

Переменные, доступные в коде:

Выборка - выборка из результата запроса, в которой уже выбрана строка.

Параметры - параметры запроса.

Пример.
    Выборка.Ссылка.ПолучитьОбъект().Удалить();

Построчно с индикацией

В отличие от "Построчно без индикации", на клиенте виден прогресс выполнения, прошедшее время выполнения, прогноз на оставшееся время. Возможно прерывание выполнения с помощью Ctrl+Break. Можно использовать Сообщить, но сообщения можно будет увидеть только по завершению выполнения. Код алгоритма пишется точно так же, что и в варианте "Построчно без индикации". Это самый удобный вариант, если нет БСП 2.3 и подходит построчный вариант обхода.

Переменные, доступные в коде:

Выборка - выборка из результата запроса.

Параметры - параметры запроса.


Простое в фоне (БСП 2.3)

Для использования этого варианта в конфигурации должна быть БСП с версией не ниже 2.3. Код выполняется в фоновом задании, целиком. Обход результата запроса нужно организовывать самостоятельно. На клиенте отображается только время выполнения. Поскольку выполнение происходит в фоне, на клиенте можно продолжать работу. В этом режиме так же можно прерывать выполнение с помощью нажатия кнопки "Прервать" (Ctrl+F5). И еще одно преимущество - можно использовать Сообщить, и сообщения видны на клиенте с периодом обновления отображения состояния. Период обновления отображения по умолчанию одна секунда, можно изменить в "Опциях".

Переменные, доступные в коде:

Выборка - выборка из результата запроса.

Параметры - параметры запроса.

ПризнакПрогресса - переменная для передачи в СообщитьПрогресс (см. ниже). 

Пример.

Пока Выборка.Следующий() Цикл
    Объект = Выборка.Ссылка.ПолучитьОбъект();
    Сообщить(Объект);
    Объект.Удалить();
КонецЦикла;

Кроме этого, вариант "Простое в фоне (БСП 2.3)" позволяет отображать и прогресс, если использовать функцию СообщитьПрогрес:
//Этот метод можно использовать в коде для отображения прогресса.
//Параметры:
// Обработано - число, количество обработанных записей.
// КоличествоВсего - число, количество записей в выборке всего.
// ВремяНачалаВМиллисекундах - число, дата начала обработки, полученное с помощью ТекущаяУниверсальнаяДатаВМиллисекундах()
// в момент начала обработки. Это значение необходимо корректного расчета оставшегося времени.
// ПризнакПрогресса - строка, специальное значение, необходимое для передачи значений прогресса на клиент.
// Это значение необходимо просто передать в параметр без изменений.
СообщитьПрогресс(Обработано, КоличествоВсего, ВремяНачалаВМиллисекундах, ПризнакПрогресса)

Пример с отображением прогресса.
й = 0;
КоличествоВсего = Выборка.Количество();
ВремяНачалаВМиллисекундах = ТекущаяУниверсальнаяДатаВМиллисекундах();
Пока Выборка.Следующий() Цикл
    Объект = Выборка.Ссылка.ПолучитьОбъект();
    Объект.Удалить();
    й = й + 1;
    //Передаём прогресс один раз на 10 записей, что бы меньше тормозить основную обработку.
    Если й % 10 = 0 Тогда
        СообщитьПрогресс(й, КоличествоВсего, ВремяНачалаВМиллисекундах, ПризнакПрогресса);
    КонецЕсли;
КонецЦикла;

Построчно в фоне с индикацией (БСП 2.3)

Для использования этого варианта в конфигурации должна быть БСП с версией не ниже 2.3. Работает точно так же, как "Построчно с индикацией", но выполнение происходит в фоне. Код вызывается для каждой записи. Прогресс обновляется с периодом, указанном в опциях (по умолчанию одна секунда). Можно использовать Сообщить, сообщения отображаются на клиенте с обновлением прогресса. В момент выполнения обработки на клиенте можно продолжать работу. Так же, как и в предыдущем варианте возможно прерывание. Это самый удобный вариант, если есть БСП 2.3 и подходит построчный вариант обхода.

Переменные, доступные в коде:

Выборка - выборка из результата запроса.

Параметры - параметры запроса.


Пример.
Объект = Выборка.Ссылка.ПолучитьОбъект();
Сообщить(Объект);
Объект.Удалить();