Общие методы регистров
ПолучитьИтог
Выбрать очередной остаток по регистру.
Синтаксис:
ПолучитьИтог()
Англоязычный синоним:
GetTotal
Возвращаемое значение:
Число: 1 – если очередной остаток по регистру выбран успешно; 0 – если очередной остаток по регистру не найден (отсутствует).
Описание:
Метод ПолучитьИтог выбирает очередной остаток по регистру в последовательности выборки, открытой перед этим при помощи метода ВыбратьИтоги. Данный метод используется для организации цикла по регистру – позволяет перебрать текущие или временные (см. ВременныйРасчет) остатки по регистру. При этом используется фильтр, если он установлен (см. УстановитьФильтр). Открывается выборка остатков по всем записанным значениям измерений.
Итоги с нулевыми остатками не выдаются. Порядок выдачи для измерений типа "справочник" и "документ" не определен.
После выполнения данного метода все атрибуты регистра: измерения, ресурсы, Приход и Расход содержат значения очередной записи остатков регистра. Данный метод может использоваться только для позиционируемых объектов, созданных функцией СоздатьОбъект.
Пример:
Процедура ВыбратьКредит()
Список = СоздатьОбъект("СписокЗначений");
Рег = СоздатьОбъект("Регистр.ТоварныйКредит");
Рег.УстановитьФильтр(Клиент, );
Ном = 0;
Рег.ВыбратьИтоги();
Пока Рег.ПолучитьИтог() = 1 Цикл
Док = Рег.Документ;
Список.ДобавитьЗначение(Док, "" + Док + " — Остаток = " + Рег.Долг);
Если Ном = 0 Тогда
ВыбДок = Док;
КонецЕсли;
Ном = Ном + 1;
КонецЦикла;
Если Ном > 0 Тогда
Если Список.ВыбратьЗначение(ВыбДок, "Выберите кредит") = 1 Тогда
ДокКредита = ВыбДок;
КонецЕсли;
КонецЕсли;
КонецПроцедуры
См. также: ВыбратьИтоги.