Другое · 6 мин
Как получить сумму табличной части в 1С
Как посчитать сумму строк табличной части в 1С: цикл по строкам, итог в реквизите формы, сохранение при записи, проверка и частые ошибки без риска для данных.
Табличная часть — это набор строк в документе, справочнике или регистре, где каждая строка содержит реквизиты, в том числе сумму, количество и цену. Получить общую сумму означает пройти по всем строкам табличной части и сложить значения нужного реквизита. В 1С это делается программно в модуле объекта, модуле формы или через запрос, в зависимости от того, где нужен результат: на экране, в печатной форме или в записанном документе.
Важно различать отображение суммы и её сохранение. Если вы просто вычисляете значение в реквизите формы, оно будет видно пользователю, но не попадет в базу автоматически. Чтобы итог участвовал в проводках, отчетах или ограничениях, его нужно записать в реквизит объекта, регистр накопления или другой хранилище данных при записи или проведении.
Перед изменением конфигурации рекомендуется работать на копии информационной базы и проверять результат на тестовых данных. Ошибка в расчете суммы табличной части может привести к неверным остаткам, неправильным отчетам или проблемам при проведении документов.
Что понимать под суммой табличной части
Табличная часть не является отдельным хранилищем итогов. Она представляет собой коллекцию строк, у каждой из которых есть свои реквизиты. Сумма табличной части — это производное значение, которое вычисляется по реквізиту «Сумма» или аналогичному числовому полю всех строк. Если строк нет, итог равен нулю.
В конфигураторе табличная часть описывается как реквизит типа «Таблица значений» или встроенного типа табличной части. В модуле объекта к ней обращаются по имени, например Объект.Товары или Объект.Состав. В форме доступ через Элементы.Товары или через коллекцию строк формы, в зависимости от способа создания формы.
Форма — для отображения, база — для отчетов и проводок
Добавление, удаление, изменение количества или суммы
Сравнить программный итог с данными запроса или печатной формы
Суммирование в модуле формы
Самый простой способ вывести сумму пользователю — создать реквизит формы типа Число, например ИтогоСумма, и заполнять его в процедуре пересчета. В цикле по строкам табличной части значение прибавляется к переменной, а затем записывается в реквизит формы. Процедуру вызывают при открытии формы, при изменении строки и при добавлении или удалении строк.
Пример логики: обнулить переменную, выполнить «Для каждого Строка Из ТабличнаяЧасть Цикл», прибавить Строка.Сумма, конец цикла, присвоить результат реквизиту формы. Если сумма используется в расчетах с налогами или скидками, учитывайте порядок операций и округление, иначе итог может расходиться с документом на копейки.
- 1Создать реквизит формы для итога
- 2Написать процедуру пересчета суммы
- 3Вызвать её при открытии и изменении табличной части
- 4Проверить итог на нескольких вариантах заполнения
Суммирование в модуле объекта и при записи
Если итог должен сохраняться, вычисляйте его в модуле объекта, например в процедуре ПередЗаписью или при проведении. Полученное значение присваивайте реквизиту документа или записывайте в регистр накопления. Тогда сумма станет частью данных и будет доступна в отчетах, даже если форма закрыта.
Не полагайтесь только на реквизит формы: при открытии документа в другом окне или при программном чтении через объект итог формы может отсутствовать. Также избегайте дублирования расчета в нескольких событиях без признака необходимости пересчета, это может привести к лишним записям и замедлению работы.
Итоги через запрос, отчет или СКД
Когда нужно получить сумму табличной части по многим документам или с условиями, удобнее использовать запрос к табличной части с агрегацией. В языке запросов 1С функция Сумма позволяет вычислить итог по группировке, например по документу, контрагенту или номенклатуре. Это подходит для отчетов, динамических списков и печатных форм.
В отчетах на базе СКД итоги настраиваются через систему компоновки данных: поле суммы добавляется в ресурсы, а группировки — в измерения. При таком подходе программировать цикл вручную не требуется, но нужно проверять отбор и период, иначе в выборку попадут лишние строки.
Проверка результата и частые ошибки
После реализации проверьте, что сумма пересчитывается при добавлении строки, удалении строки, изменении количества и цене. Сравните программный итог с суммой, вычисленной вручную или через запрос. Если значения не совпадают, причина может быть в отборе, пустых строках, неинициализированных реквизитах или округлении.
Частые ошибки: сумма считается только при открытии формы и не обновляется при редактировании; итог вычисляется, но не записывается в объект; в цикле участвуют строки, помеченные на удаление; используются разные поля для количества и суммы, что приводит к несоответствию. Также не изменяйте табличную часть напрямую в базе без понимания логики проведения.
Границы самостоятельной работы и риски
Простой расчет суммы на форме можно внести самостоятельно, если у вас есть доступ к конфигуратору и опыт работы с модулями формы и объекта. Запись итогов в регистры, изменение механизмов проведения или переработка отчетов требует более глубокого понимания конфигурации и может повлиять на учет.
Если после изменений появились расхождения в остатках, неверные проводки или ошибки при записи, откатите изменения и проверьте их на копии базы. Не вносите правки в рабочую базу в конце отчетного периода без проверки, так как это может повлиять на налоговую и бухгалтерскую отчетность.
Что важно запомнить
Сумму табличной части считают в цикле по строкам, выводят на форму или в отчет, а для постоянного хранения записывают в объект при записи или проведении, обязательно проверяя результат на копии базы.
Нужно ли сохранять сумму в реквизит документа?
Нет, если итог нужен только для отображения пользователю, достаточно реквизита формы. Если сумма используется в отчетах, проводках или ограничениях, запишите её в реквизит объекта или регистр при записи или проведении.
Можно ли обойтись без программирования?
Да, для отчетов и динамических списков часто достаточно запроса или СКД с функцией Сумма и группировкой. Для вывода итога прямо на форме документа обычно требуется процедура пересчета в модуле формы.
Почему итог может не совпадать с документом?
Различия возникают из-за округления, налогов, скидок, пустых строк, строк, помеченных на удаление, или использования разных полей для количества и суммы. Проверьте отбор и порядок расчета.
Безопасно ли менять расчет в рабочей базе?
Не рекомендуется без создания копии информационной базы и тестирования. Ошибка в сумме табличной части может повлиять на остатки, отчеты и проведение документов.