СводнаяТаблица.Область

Получить смысл значений области сводной, а не только текст ячейки

ПолучитьЗначения возвращает структуру по левой верхней ячейке переданной области. За пределами сводной результат — Неопределено.

Подготовка

1. Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.

2. На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).

3. Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.

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

5. Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.

&НаКлиенте
Процедура УчебныйПример(Команда)
    ТабДок = ПостроитьУчебныйДокумент();

    ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры

&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
    ТабДок = Новый ТабличныйДокумент;
    Источник = Новый ТаблицаЗначений;
    Источник.Колонки.Добавить("Товар", Новый ОписаниеТипов("Строка"));
    Источник.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число"));
    Источник.Колонки.Добавить("Сумма", Новый ОписаниеТипов("Число"));
    СтрокаТовара = Источник.Добавить();
    СтрокаТовара.Товар = "Книга";
    СтрокаТовара.Количество = 3;
    СтрокаТовара.Сумма = 750;
    СтрокаТовара = Источник.Добавить();
    СтрокаТовара.Товар = "Ручка";
    СтрокаТовара.Количество = 1;
    СтрокаТовара.Сумма = 50;
    Менеджер = Новый МенеджерВременныхТаблиц;
    Запрос = Новый Запрос;
    Запрос.МенеджерВременныхТаблиц = Менеджер;
    Запрос.УстановитьПараметр("Источник", Источник);
    Запрос.Текст = "ВЫБРАТЬ Д.Товар, Д.Количество, Д.Сумма
    |ПОМЕСТИТЬ ВТУчебныеТовары ИЗ &Источник КАК Д;
    |ВЫБРАТЬ Д.Товар, Д.Количество, Д.Сумма
    |ИЗ ВТУчебныеТовары КАК Д
    |ИТОГИ СУММА(Количество), СУММА(Сумма) ПО Товар";
    Попытка
        Пакет = Запрос.ВыполнитьПакет();
        Результат = Пакет.Получить(1);
    Исключение
        Менеджер.Закрыть();
        ВызватьИсключение;
    КонецПопытки;
    Менеджер.Закрыть();
    Сводная = ТабДок.ВстроенныеТаблицы.Добавить(Тип("СводнаяТаблица"), ТабДок.Область(2, 1));
    Сводная.Имя = "УчебныеТовары";
    Сводная.ИсточникДанных = Результат;
    Сводная.Строки.Добавить("Товар");
    Сводная.Данные.Добавить("Количество");
    Сводная.Данные.Добавить("Сумма");
    Сводная.Обновить();
    Область = Сводная.Область;
    Данные = Сводная.ОбластьДанных;
    Если Область = Неопределено Или Данные = Неопределено Тогда
        ВызватьИсключение "После обновления ожидаются области собственной сводной";
    КонецЕсли;
    Значения = Сводная.ПолучитьЗначения(Данные);
    Если Значения = Неопределено Тогда
        ВызватьИсключение "В собственной области данных ожидается структура значений";
    КонецЕсли;
    Сумма = Неопределено;
    ЕстьСумма = Значения.Свойство("Сумма", Сумма);
    Сообщить(ЕстьСумма);
    Если ЕстьСумма Тогда
        Сообщить(ТипЗнч(Сумма) = Тип("Число"));
        Сообщить(Сумма = 750 Или Сумма = 50 Или Сумма = 800);
    КонецЕсли;
    Внешняя = ТабДок.Область(Область.Низ + 5, Область.Право + 5);
    Сообщить(Сводная.ПолучитьЗначения(Внешняя) = Неопределено);
    Сообщить("Заголовки строк: " + Строка(Сводная.ОбластьЗаголовковСтрок));
    Сообщить("Заголовки колонок: " + Строка(Сводная.ОбластьЗаголовковКолонок));
    Возврат ТабДок;
КонецФункции

Разбор по шагам

1. Получаем фактические Область и ОбластьДанных после обновления, проверяя их наличие.

2. Метод анализирует только левую верхнюю ячейку даже при передаче большой области.

3. Набор ключей структуры зависит от места: заголовок, данные или общие итоги; наличие Сумма проверяем через Свойство.

4. Внешнюю ячейку выбираем по координатам за правой нижней границей и обрабатываем отрицательный результат.

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

1. Для области данных ЕстьСумма и числовой тип должны дать Истина; допустимы только собственные суммы 750, 50 или общий итог 800.

2. За пределами сводной сравнение с Неопределено Истина; к свойствам такого результата не обращаемся.

Ожидаемый результат

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

На что обратить внимание

1. ПолучитьЗначения не возвращает все строки области одним вызовом.

2. Не считайте текст видимой ячейки числом без проверки: структура метода сохраняет тип значения.

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