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

Другое · 7 мин

Как получить итог по колонке табличной части в 1С

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

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

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

Порядок действий при переборе строк
  1. 1
    Объявить переменную для накопления итога
  2. 2
    Пройти циклом по строкам табличной части
  3. 3
    Добавить значение колонки к переменной с проверкой на пустоту
  4. 4
    Вывести результат в реквизит или использовать для проверки
  5. 5
    Сверить итог с отдельными строками вручную

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

Когда итог считать в модуле формы

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

Сравнение вариантов получения итога

Перебор строк в модуле

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

Агрегатный запрос

Удобен для больших данных и отчётов, требует корректного источника и условий отбора.

Встроенные итоги формы

Просты в настройке для отображения, но ограничены возможностями конкретной формы.

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

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

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

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

Итоги в форме и вычисляемые поля

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

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

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

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

Сравнение итога с суммой строк вручную
Норма

Значения совпадают на выбранной выборке

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

Итог отличается или не меняется при редактировании таблицы

Учёт пустых и нечисловых значений
Норма

Пустые значения не ломают расчёт

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

Ошибка типа или неопределённый результат

Обновление после изменения строк
Норма

Итог пересчитывается при добавлении или удалении строк

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

Итог остаётся прежним после правки табличной части

Ограничения и проверка результата

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

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

Типичные ошибки
01
Суммирование колонки с нечисловыми значениями без приведения типа
02
Итог по всем строкам вместо отобранных пользователем
03
Отсутствие пересчёта итога после изменения табличной части

Типичные ошибки

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

Также часто забывают обновить итог после изменения табличной части, особенно если расчёт выполняется один раз при открытии формы. В managed-формах важно учитывать контекст клиента и сервера: код, работающий на клиенте, не всегда имеет доступ к тем же данным, что и серверный модуль.

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

Как выбрать действие

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

Как выбрать подходящий способ

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

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

Часто задаваемые вопросы

Итог

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

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

Можно ли получить итог по колонке без программирования?

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

Учитывает ли итог скрытые или отфильтрованные строки?

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

Что делать, если в колонке есть пустые значения?

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

Нужно ли проверять итог на копии базы?

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