Суммирует значения всех строк в указанной колонке. Если в колонке установлен тип и он единственный, то при суммировании будет предприниматься попытка преобразования значения к типу Число. Если колонке не присвоены типы, то в процессе суммирования будут принимать участие только значения, имеющие тип Число, значения других типов будут игнорироваться. Если в колонке несколько типов и среди них есть тип Число, то в процессе суммирования будут принимать участие только значения, имеющие тип Число, значения других типов будут игнорироваться. Если в колонке несколько типов и среди них нет типа Число, то результатом будет значение Неопределено.
Синтаксис
Итог(<Колонка>)Примеры платформы
ВсегоПоДокументу = Состав.Итог("Всего");Полное описание, параметры и ограничения
ПланСчетовВидыСубконто.<Имя плана счетов>.Итог (ChartOfAccountsExtDimensionTypes.<Chart of accounts name>.Total)
ПланСчетовВидыСубконто.<Имя плана счетов> (ChartOfAccountsExtDimensionTypes.<Chart of accounts name>)
Итог (Total)
Доступен, начиная с версии 8.0.
Синтаксис:
Итог(<Колонка>)
Параметры:
<Колонка> (обязательный)
Тип: Число, Строка.
Индекс либо имя колонки, по которой подсчитывается итог.
Возвращаемое значение:
Тип: Число, Неопределено.
Описание:
Суммирует значения всех строк в указанной колонке.
Если в колонке установлен тип и он единственный, то при суммировании будет предприниматься попытка преобразования значения к типу Число.
Если колонке не присвоены типы, то в процессе суммирования будут принимать участие только значения, имеющие тип Число, значения других типов будут игнорироваться.
Если в колонке несколько типов и среди них есть тип Число, то в процессе суммирования будут принимать участие только значения, имеющие тип Число, значения других типов будут игнорироваться.
Если в колонке несколько типов и среди них нет типа Число, то результатом будет значение Неопределено.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Примечание:
Метод реализован для совместимости с табличными частями и для данного объекта его использование не имеет смысла.
Пример:
ВсегоПоДокументу = Состав.Итог("Всего");
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Разобрать, почему Итог и Свернуть не дают бухгалтерского результата
Контролируемый опыт на трёх строках показывает формальный итог номеров и группировку по всем реальным колонкам. Справка прямо предупреждает: эти методы у ВидыСубконто оставлены для совместимости и не имеют прикладного смысла.
Где и как запускать
Полный обычный клиентский общий модуль УчебныеСубконто85, только толстый клиент; все помощники включены, полный модуль Пульта отдельно. Не выполнялся.
Подготовка
Создайте НОВУЮ отдельную файловую базу 8.5.1.1343, имя конфигурации УчебныеСубконто85, совместимость НеИспользовать, обычное приложение и толстый клиент. Не рабочую БП/КА2 и не её копию. Здесь база и код не запускались: runtimeVerifiedScenarios=0.
Планы видов характеристик → УчебныеАналитики85: тип значений только Строка(30), переменная длина. В Предопределённые создайте три собственных элемента НЕ группы: имя АналитикаА, код A, наименование Учебная аналитика A; АналитикаБ, код B, наименование Учебная аналитика B; АналитикаВ, код C, наименование Учебная аналитика C. Их тип значения — Строка(30). Дополнительные значения, свои реквизиты и табличные части не создавайте.
Планы счетов → УчебныеСчета85: ДлинаКода=10, ДлинаНаименования=100, ВидыСубконто=УчебныеАналитики85, МаксКоличествоСубконто=3. Признаки учёта субконто и обычные признаки учёта отсутствуют, собственные реквизиты/табличные части и предопределённые счета отсутствуют. Все объектные и менеджерские модули пустые.
Никаких регистров бухгалтерии, документов, подписок и расширений. Предопределённые аналитики — подготовленные элементы своего стенда; 1С может создать их при обновлении своей базы. Это не создание нами рабочих аналитик и не записи счёта из примера.
Создайте неглобальный общий модуль УчебныеСубконто85: Клиент (обычное приложение)=Да, Сервер=Нет, Привилегированный=Нет, другие клиентские флаги=Нет. Вставляйте полный основной модуль выбранного урока целиком. Все три имеют ВыполнитьПример; для другого урока заменяйте весь текст.
Создайте обработку УчебныеСубконто85, обычную основную форму Пульт с кнопкой Выполнить, действие ВыполнитьНажатие. Полный отдельный модуль этой формы приведён ниже. Дайте своему учебному пользователю доступ к своим планам, предопределённым аналитикам и обработке.
F7, сохранение и обновление только своего нового стенда. В будущем толстом клиенте запустите Пульт. Каждый вызов создаёт новый незаписанный счёт в памяти; Код, Наименование и остальные обязательные поля счёта для записи здесь не заполняются, поскольку Записать не вызывается.
Итог и Свернуть у ВидыСубконто оставлены для совместимости и, по справке, не имеют прикладного смысла. Третий урок — контролируемая демонстрация границы API, не вычисление бухгалтерских итогов и не способ изменить виды аналитики в рабочем учёте.
Процедура ВыполнитьПример() Экспорт
Счет = СоздатьСвойСчет();
Аналитики = ПолучитьСвоиАналитики();
Субконто = Счет.ВидыСубконто;
Для Индекс = 0 По 2 Цикл
ЗаполнитьСвоюСтроку(Субконто.Добавить(), Аналитики[Индекс], Индекс = 1);
КонецЦикла;
ПроверитьСвоиСтроки(Субконто, Аналитики, СвоиФлаги(Ложь, Истина, Ложь));
СуммаНомеров = Субконто.Итог("НомерСтроки");
Если СуммаНомеров <> 6 Тогда
ВызватьИсключение "В контрольном черновике номера 1, 2, 3 должны давать 6, это не бухгалтерский итог";
КонецЕсли;
Снимок = Субконто.Выгрузить();
Если Снимок.Колонки.Количество() <> 4 Тогда
ВызватьИсключение "Опыт требует только четыре стандартные колонки без флагов учёта";
КонецЕсли;
ИменаКолонок = Новый Массив;
Для Каждого Колонка Из Снимок.Колонки Цикл
Если Колонка.Имя <> "НомерСтроки" И Колонка.Имя <> "ВидСубконто"
И Колонка.Имя <> "Предопределенное" И Колонка.Имя <> "ТолькоОбороты" Тогда
ВызватьИсключение "Неожиданная колонка собственного определения";
КонецЕсли;
ИменаКолонок.Добавить(Колонка.Имя);
КонецЦикла;
Субконто.Свернуть(СтрСоединить(ИменаКолонок, ","), "");
Если Субконто.Количество() <> 3 Тогда
ВызватьИсключение "Группировка по всем колонкам трёх разных строк не должна создавать дедупликацию";
КонецЕсли;
Для Индекс = 0 По 2 Цикл
СтрокаСубконто = Субконто.Найти(Аналитики[Индекс], "ВидСубконто");
Если СтрокаСубконто = Неопределено Или СтрокаСубконто.ТолькоОбороты <> (Индекс = 1)
Или СтрокаСубконто.Предопределенное Тогда
ВызватьИсключение "Контрольный опыт совместимости изменил содержимое своей аналитики";
КонецЕсли;
КонецЦикла;
Сообщить("Итог номеров равен 6, но не имеет учётного смысла. Свернуть по всем четырём колонкам сохранила три разные строки. Для прикладного отчёта используйте отдельную таблицу значений.");
КонецПроцедуры
Процедура ПроверитьСвойКонтекст()
Если Метаданные.РежимСовместимости <> Метаданные.СвойстваОбъектов.РежимСовместимости.НеИспользовать Тогда
ВызватьИсключение "Нужен собственный стенд УчебныеСубконто85 платформы 8.5.1.1343";
КонецЕсли;
Если ТранзакцияАктивна() Тогда
ВызватьИсключение "Учебный вывод не должен выполняться внутри чужой транзакции";
КонецЕсли;
КонецПроцедуры
Функция СоздатьСвойСчет()
ПроверитьСвойКонтекст();
МДПлана = Метаданные.ПланыСчетов.Найти("УчебныеСчета85");
МДАналитик = Метаданные.ПланыВидовХарактеристик.Найти("УчебныеАналитики85");
Если МДПлана = Неопределено Или МДАналитик = Неопределено Тогда
ВызватьИсключение "Подготовьте собственные планы счетов и аналитик";
КонецЕсли;
Если МДПлана.ВидыСубконто <> МДАналитик Или МДПлана.МаксКоличествоСубконто <> 3
Или МДПлана.ПризнакиУчетаСубконто.Количество() <> 0 Тогда
ВызватьИсключение "Нужен свой план с тремя субконто без дополнительных флагов";
КонецЕсли;
Счет = ПланыСчетов.УчебныеСчета85.СоздатьСчет();
Если Счет.ВидыСубконто.Количество() <> 0 Тогда
ВызватьИсключение "Новый собственный счет должен иметь пустую таблицу";
КонецЕсли;
Возврат Счет;
КонецФункции
Функция ПолучитьСвоиАналитики()
Аналитики = Новый Массив;
Аналитики.Добавить(ПланыВидовХарактеристик.УчебныеАналитики85.АналитикаА);
Аналитики.Добавить(ПланыВидовХарактеристик.УчебныеАналитики85.АналитикаБ);
Аналитики.Добавить(ПланыВидовХарактеристик.УчебныеАналитики85.АналитикаВ);
Для Каждого Аналитика Из Аналитики Цикл
Если Аналитика.Пустая() Тогда
ВызватьИсключение "Предопределенные аналитики должны иметь непустые ссылки своего плана";
КонецЕсли;
КонецЦикла;
Если Аналитики[0] = Аналитики[1] Или Аналитики[0] = Аналитики[2] Или Аналитики[1] = Аналитики[2] Тогда
ВызватьИсключение "Три свои аналитики должны различаться";
КонецЕсли;
Возврат Аналитики;
КонецФункции
Процедура ЗаполнитьСвоюСтроку(СтрокаСубконто, Аналитика, ТолькоОбороты)
СтрокаСубконто.ВидСубконто = Аналитика;
СтрокаСубконто.ТолькоОбороты = ТолькоОбороты;
СтрокаСубконто.Предопределенное = Ложь;
КонецПроцедуры
Функция СвоиФлаги(Первый, Второй, Третий = Неопределено)
Флаги = Новый Массив;
Флаги.Добавить(Первый);
Флаги.Добавить(Второй);
Если Третий <> Неопределено Тогда
Флаги.Добавить(Третий);
КонецЕсли;
Возврат Флаги;
КонецФункции
Процедура ПроверитьСвоиСтроки(Субконто, Аналитики, Флаги)
Если Субконто.Количество() <> Аналитики.Количество() Или Флаги.Количество() <> Аналитики.Количество() Тогда
ВызватьИсключение "Не совпал полный размер своей таблицы";
КонецЕсли;
Для Индекс = 0 По Аналитики.Количество() - 1 Цикл
СтрокаСубконто = Субконто.Получить(Индекс);
Если СтрокаСубконто <> Субконто[Индекс] Или Субконто.Индекс(СтрокаСубконто) <> Индекс
Или СтрокаСубконто.НомерСтроки <> Индекс + 1
Или СтрокаСубконто.ВидСубконто <> Аналитики[Индекс]
Или СтрокаСубконто.ТолькоОбороты <> Флаги[Индекс] Или СтрокаСубконто.Предопределенное Тогда
ВызватьИсключение "Не совпали порядок, вид, флаг оборотов или принадлежность собственной строки";
КонецЕсли;
КонецЦикла;
КонецПроцедурыУчебныеСубконто85.Пульт
УчебныеСубконто85 → Обработки → УчебныеСубконто85 → Формы → Пульт → Модуль
Полный модуль собственной обычной формы, не выполнялся.
Процедура ВыполнитьНажатие(Кнопка)
УчебныеСубконто85.ВыполнитьПример();
КонецПроцедурыРазбор по шагам
СоздатьСвойСчет проверяет платформу и свой стенд, связь с планом аналитик, предел три вида и отсутствие дополнительных флагов. СоздатьСчет создаёт новый объект, не получает записанный счёт по ссылке.
Три ссылки берутся из своих предопределённых АналитикаА/Б/В, заданных в подготовке. Непустая ссылка не подменяется произвольным UUID или неизвестным входным объектом.
Строки специальной таблицы имеют ВидСубконто как ссылку на план характеристик и два отдельных Булево. Предопределенное=Ложь относится к строке счёта, не к тому, является ли сама аналитика предопределённым элементом плана.
Индекс начинается с 0, НомерСтроки — с 1 и readonly. Полный валидатор сверяет обе адресации, принадлежность строки, вид и оба флага; НомерСтроки не присваивается вручную.
Мутирующие методы допустимы у таблицы объекта. У таблицы ссылки или выборки они вызовут ошибку: ни ссылку на записанный счёт, ни неизвестную таблицу урок не принимает.
Итог("НомерСтроки") суммирует порядковые числа 1+2+3=6. Это нарочно техническая проверка совместимости, не сумма проводок, число аналитик или денежный показатель.
Выгрузкой получаем настоящий список колонок. Стенд должен содержать только четыре стандартные колонки; наличие динамических флагов учёта отклоняет этот узкий опыт.
Для Свернуть оба списка должны покрывать всю таблицу и не пересекаться. Собираем первый список из всех фактических имён, второй оставляем пустым: ничего не суммируем в readonly-номер.
Номера и виды трёх строк различаются, поэтому группировка по всем колонкам не может объединить их. Проверяем три настоящие аналитики и их флаги поиском, не обещаем недокументированный порядок после группировки.
Для реальной задачи отчёта надо выгрузить данные в отдельную ТаблицуЗначений, выбрать осмысленные группировки и вычисляемые показатели. Урок не выдаёт формальную доступность метода за рекомендацию его использовать на счёте.
Как проверить результат
Будущий тест: F7 и запуск Пульта только в своём новом стенде. Каждый вызов начинается с нового счёта и пустой таблицы; здесь BSL не выполнялся.
Если не созданы свои предопределённые имена, подготовьте их и обновите только свой стенд. Не заменяйте их чужими ссылками из БП или КА2.
В коде нет Записать счёта, проводок или регистров бухгалтерии. Удаление/очистка затрагивает только новые строки памяти, не записи базы.
Будущий технический контроль: сумма номеров 6 и три разные строки после Свернуть; обе величины ничего не говорят об учётных остатках.
Все фактические колонки входят в группировку, список суммирования пуст. НомерСтроки не присваивается и не используется как сумма бухгалтерского показателя.
Добавление своего флага учёта субконто в подготовку должно остановить опыт проверкой состава колонок, а не незаметно потерять этот флаг.
Справочное ограничение «для данного объекта использование не имеет смысла» должно оставаться видимым рядом с кодом обоих методов.
Ожидаемый результат
Будущий опыт сверяет полный состав собственного незаписанного счёта в памяти и границы специальной таблицы. Рабочая база, проводки и счета не меняются. runtimeVerifiedScenarios=0.
На что обратить внимание
ВидыСубконто — специальная таблица счёта, не таблица сумм бухгалтерского регистра. Изменение её порядка влияет на позиции аналитик, не на остатки.
ТолькоОбороты и Предопределенное — разные флаги. Ссылка на предопределённый вид не делает автоматически предопределённой добавленную нами строку счёта.
Методы объекта памяти не сохраняют счёт. Этот черновик намеренно не подготовлен к записи; не добавляйте Записать ради проверки примера.
Статические Python/HTML-проверки и сверка установленной справки не являются компиляцией и запуском в 1С. runtimeVerifiedScenarios остаётся 0.
Не копируйте пример native Состав.Итог("Всего") или Свернуть("Номенклатура",...) в ВидыСубконто: таких полей у этой специальной таблицы нет.
Наличие метода в списке API не означает его полезность для этого типа. Этот урок — честная демонстрация совместимости, а не схема автоматического изменения бухгалтерской аналитики.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.