Как сложить значения колонок табличной части и вывести общий итог на форму документа в 1С?

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

Почему возникает ошибка при вызове метода Итог?

Проанализируем распространенную ошибку: при вызове Товары.Итог("Вес") платформа выдает сообщение: «Недопустимое значение параметра (параметр номер '1') (Колонка не принадлежит коллекции)».

Выясним причину такого поведения платформы:

1. Метод ТабличнаяЧасть.Итог("ИмяРеквизита") обращается исключительно к реальным реквизитам табличной части объекта метаданных, имеющим числовой тип.
2. Если вы добавили колонку только визуально в табличное поле формы (в коллекцию ЭлементыФормы.Товары.Колонки), в самой табличной части документа в базе данных этого реквизита нет, поэтому метод Итог() завершается аварийно.
3. Метод Итог() не умеет вычислять выражения «на лету» (например, умножать количество на вес единицы товара). Он лишь складывает уже готовые сохраненные числа из указанной колонки.

Способ 1. Программный подсчет суммы через цикл в коде модуля формы

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

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

Посмотрим на пример процедуры расчета и вывода значения в надпись на форме:

Процедура РассчитатьИВывестиОбщийВес()
    
    мТекВес = 0;
    
    Для Каждого ДанныеСтроки Из ЭтотОбъект.Товары Цикл
        // Проверяем заполненность номенклатуры
        Если ЗначениеЗаполнено(ДанныеСтроки.Номенклатура) Тогда
            // Учитываем вес единицы и количество в строке
            ВесЕдиницы = ДанныеСтроки.Номенклатура.ВесТовара;
            мТекВес = мТекВес + (ВесЕдиницы * ДанныеСтроки.Количество);
        КонецЕсли;
    КонецЦикла;
    
    // Выводим отформатированное значение в надпись формы
    ЭлементыФормы.ВсегоВес.Заголовок = Формат(мТекВес, "ЧЦ=15; ЧДЦ=3");
    
КонецПроцедуры

Важное замечание по архитектуре типовой «УТ 10.3»: в типовых решениях реквизит Вес хранится в подчиненном справочнике ЕдиницыИзмерения, а не в самой номенклатуре. В строке документа выбирается конкретная единица (упаковка, штука), поэтому правильнее получать вес с учетом единицы измерения:

мТекВес = мТекВес + (ДанныеСтроки.ЕдиницаИзмерения.Вес * ДанныеСтроки.Количество);

Оптимизация: куда поместить вызов процедуры расчета

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

Оптимально вызывать процедуру РассчитатьИВывестиОбщийВес() точечно:

1. В обработчике события ПриОткрытии формы документа.
2. В обработчиках событий ПриИзменении колонок табличного поля («Номенклатура», «Количество», «ЕдиницаИзмерения»).
3. В обработчиках удаления и добавления строк (события ПослеУдаления или ПриОкончанииРедактирования).

Способ 2. Добавление реквизита в метаданные табличной части и использование метода Итог

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

Разберем по шагам реализацию этого способа:

1. В конфигураторе открываем документ, находим табличную часть Товары и добавляем реквизит Вес (Тип: Число, Длина: 15, Точность: 3).
2. Выносим колонку на форму документа.
3. В событиях НоменклатураПриИзменении и КоличествоПриИзменении табличного поля рассчитываем вес конкретной строки:
   Скопировать код

   
   СтрокаТабличнойЧасти = ЭлементыФормы.Товары.ТекущиеДанные;
   СтрокаТабличнойЧасти.Вес = СтрокаТабличнойЧасти.ЕдиницаИзмерения.Вес * СтрокаТабличнойЧасти.Количество;
   

4. Для получения общей суммы используем быстрый платформенный метод:
   Скопировать код

   
   ОбщийВесДокумента = ЭтотОбъект.Товары.Итог("Вес");
   ЭлементыФормы.ВсегоВес.Заголовок = Формат(ОбщийВесДокумента, "ЧЦ=15; ЧДЦ=3");
   

Способ 3. Вывод итога в стандартный подвал таблицы без написания кода

Если суммарный вес нужно отобразить непосредственно под колонкой «Вес» в таблице документа, можно воспользоваться стандартными свойствами табличного поля без написания программного кода:

1. Выделяем табличное поле Товары на форме и открываем окно «Свойства».
2. Убеждаемся, что в верхней части окна свойств отключен фильтр «Показывать только важные» (должна быть выбрана иконка отображения всех свойств по категориям).
3. Устанавливаем свойство Подвал (ставим флажок).
4. В свойствах самой колонки Вес находим категорию «Подвал» и включаем флажок ОтображатьИтогиВПодвале.
5. Платформа автоматически рассчитает сумму по колонке и выведет ее в нижней строке таблицы.