Тип: Строка. Имя таблицы. Данное свойство недоступно у объектов, содержащихся в коллекции пользовательских настроек компоновки данных.
Полное описание, параметры и ограничения
ТаблицаКомпоновкиДанных.Имя (DataCompositionTable.Name)
ТаблицаКомпоновкиДанных (DataCompositionTable)
Имя (Name)
Доступен, начиная с версии 8.1.
Использование:
Чтение и запись.
Описание:
Тип: Строка.
Имя таблицы.
Данное свойство недоступно у объектов, содержащихся в коллекции пользовательских настроек компоновки данных.
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Подготовить те же продажи в таблице СКД, а не в диаграмме
Строим альтернативное представление: товары — строки, магазины — колонки, Сумма — ресурс. Разделяем свойства таблицы, её группировок и параметры вывода.
Где и как запускать
Полный код серверного общего модуля УчебныеДиаграммы85. ВыполнитьПример() вызывается из собственного серверного обработчика учебной команды. Код не запускается автоматически в справочнике.
Подготовка
Работайте в отдельной учебной базе на платформе 8.5.1.1343. Справочники, документы, регистры и готовые макеты не нужны.
Создайте общий модуль УчебныеДиаграммы85: Сервер — Да, Клиент — Нет, Привилегированный — Нет. Полностью вставьте код одного урока, а не оборачивайте его второй процедурой.
В своей учебной обработке добавьте команду. Из её серверного обработчика вызовите УчебныеДиаграммы85.ВыполнитьПример();. Не вызывайте серверные объекты СКД непосредственно из тонкого клиента.
Запрос содержит только три собственные константные строки: Север/Книга — 750, Север/Ручка — 50, Юг/Книга — 500. Продажи Севера — 800, Юга — 500, общая сумма — 1300.
Серии будут магазинами, точки — товарами, ресурс — суммой продаж. Значение Книга складывается до 1250, Ручка — до 50. Количество единиц по всем строкам — 6, а число строк источника — 3.
Каждый урок запускайте отдельно: он заново создаёт схему и настройки в памяти. Упражнения с настройками не формируют отчёт; отдельный урок показывает компоновку и вывод.
Для просмотра объектов поставьте точку останова перед последними Сообщить. ТабличныйДокумент результата урока вывода находится в серверной переменной Результат; код не печатает, не сохраняет файл и не открывает окно клиента.
Запуск в 1С здесь не проверялся. Приведены ожидаемые проверки собственной задачи, а не доказательство успешного формирования отчёта в любой конфигурации.
Процедура ВыполнитьПример() Экспорт
Схема = Новый СхемаКомпоновкиДанных;
Источник = Схема.ИсточникиДанных.Добавить();
Источник.Имя = "УчебныеПродажи";
Источник.ТипИсточникаДанных = "Local";
Набор = Схема.НаборыДанных.Добавить(Тип("НаборДанныхЗапросСхемыКомпоновкиДанных"));
Набор.Имя = "СвоиТриСтроки";
Набор.ИсточникДанных = Источник.Имя;
Набор.АвтоЗаполнениеДоступныхПолей = Истина;
Набор.Запрос = "ВЫБРАТЬ
| ""Север"" КАК Магазин,
| ""Книга"" КАК Наименование,
| 3 КАК Количество,
| 750 КАК Сумма
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ""Север"", ""Ручка"", 1, 50
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ""Юг"", ""Книга"", 2, 500";
Для Каждого ИмяРесурса Из СтрРазделить("Сумма,Количество", ",") Цикл
Ресурс = Схема.ПоляИтога.Добавить();
Ресурс.ПутьКДанным = ИмяРесурса;
Ресурс.Выражение = "Сумма(" + ИмяРесурса + ")";
КонецЦикла;
Настройки = Схема.НастройкиПоУмолчанию;
Таблица = Настройки.Структура.Добавить(Тип("ТаблицаКомпоновкиДанных"));
Таблица.Имя = "УчебнаяМатрицаПродаж";
Таблица.Использование = Истина;
Товар = Таблица.Строки.Добавить();
Товар.Имя = "Товары";
Товар.Использование = Истина;
ПолеТовара = Товар.ПоляГруппировки.Элементы.Добавить(Тип("ПолеГруппировкиКомпоновкиДанных"));
ПолеТовара.Поле = Новый ПолеКомпоновкиДанных("Наименование");
ПолеТовара.ТипГруппировки = ТипГруппировкиКомпоновкиДанных.Элементы;
ПолеТовара.Использование = Истина;
Магазин = Таблица.Колонки.Добавить();
Магазин.Имя = "Магазины";
Магазин.Использование = Истина;
ПолеМагазина = Магазин.ПоляГруппировки.Элементы.Добавить(Тип("ПолеГруппировкиКомпоновкиДанных"));
ПолеМагазина.Поле = Новый ПолеКомпоновкиДанных("Магазин");
ПолеМагазина.ТипГруппировки = ТипГруппировкиКомпоновкиДанных.Элементы;
ПолеМагазина.Использование = Истина;
Выбранное = Таблица.Выбор.Элементы.Добавить(Тип("ВыбранноеПолеКомпоновкиДанных"));
Выбранное.Поле = Новый ПолеКомпоновкиДанных("Сумма");
Выбранное.Использование = Истина;
Таблица.ПараметрыВывода.УстановитьЗначениеПараметра("Заголовок", "Товары × магазины");
Таблица.ИдентификаторПользовательскойНастройки = "УчебнаяМатрица85";
Таблица.ПредставлениеПользовательскойНастройки = "Показывать матрицу продаж";
Таблица.РежимОтображения = РежимОтображенияЭлементаНастройкиКомпоновкиДанных.Обычный;
ПравилоТаблицы = Таблица.УсловноеОформление.Элементы.Добавить();
ПравилоТаблицы.Использование = Истина;
ПравилоТаблицы.Оформление.УстановитьЗначениеПараметра("ЦветФона", Новый Цвет(242, 248, 255));
Сообщить(Таблица.Родитель = Настройки);
Сообщить(Товар.Родитель = Таблица И Магазин.Родитель = Таблица);
Сообщить(Таблица.Строки.Количество() = 1 И Таблица.Колонки.Количество() = 1);
Сообщить(Таблица.Выбор.Элементы.Количество() = 1);
Сообщить(Таблица.ПредставлениеПользовательскойНастройки = "Показывать матрицу продаж");
Сообщить(Таблица.ИдентификаторПользовательскойНастройки = "УчебнаяМатрица85");
Сообщить(Таблица.РежимОтображения = РежимОтображенияЭлементаНастройкиКомпоновкиДанных.Обычный);
Сообщить(Таблица.УсловноеОформление.Элементы.Количество() = 1);
Сообщить("Идентификатор расшифровки таблицы: " + Таблица.Идентификатор);
КонецПроцедурыРазбор по шагам
Здесь создаётся только таблица: диаграмма из других упражнений не добавляется в настройки.
Коллекции Строки и Колонки создают ГруппировкаТаблицыКомпоновкиДанных. Они не создают обычную группу или группу диаграммы.
Поля Наименование и Магазин задаём в двух группировках; ресурс Сумма выбираем для таблицы.
Заголовок устанавливаем через ПараметрыВывода таблицы. Пользовательские ключ и подпись задаются отдельно.
Добавляем правило фона таблицы и проверяем связанное дерево. Идентификатор расшифровки, как у диаграммы, только читаем.
Как проверить результат
Ожидаются восемь сравнений Истина и строка с диагностическим идентификатором.
После отдельной компоновки этой схемы ожидайте пересечения Книга/Север 750, Книга/Юг 500, Ручка/Север 50. Отсутствующее Ручка/Юг не следует приравнивать к явно записанному нулю без настройки вывода.
Ожидаемый результат
Подготовлена собственная матрица СКД на тех же данных с правильными типами группировок и контейнеров.
На что обратить внимание
Количество группировок Строки = 1 не означает одну строку в сформированной таблице.
Заголовок таблицы не задаёт имя запроса и не создаёт новый ресурс.
Чтобы увидеть таблицу, после настройки отдельно выполните маршрут компоновки и вывода; этот урок исследует только её структуру.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Разобрать группировки строк и колонок настоящей матрицы СКД
Свои магазины становятся строками, товары — колонками, сумма продаж — ресурсом. Из готового макета получаем табличные группировки и настоящие объекты их шапок и подвалов.
Где и как запускать
Полный серверный общий модуль УчебныйМакетСКД85. ВыполнитьПример() вызывается только собственным серверным обработчиком учебной команды.
Подготовка
Используйте отдельную пустую учебную базу 8.5.1.1343. Данные рабочих конфигураций, готовые отчёты и подключение к интернету не нужны.
Создайте общий модуль УчебныйМакетСКД85: Сервер — Да, Клиент — Нет, Вызов сервера — Нет, Привилегированный — Нет. Вставьте весь модуль одного урока целиком, включая вспомогательные функции.
В своей учебной обработке создайте управляемую форму и команду ВыполнитьУрок. Через конструктор обработчика добавьте клиентскую процедуру команды, вызывающую собственную процедуру ВыполнитьНаСервере() с директивой &НаСервереБезКонтекста. В её тело вставьте УчебныйМакетСКД85.ВыполнитьПример();.
В запросе только свои три строки: Север/Книга — количество 3, сумма 750; Север/Ручка — 1 и 50; Юг/Книга — 2 и 500. Сумма источника 1300, количество единиц 6. Запрос ничего не читает из справочников или регистров.
Поставьте точку останова перед последним Сообщить в ВыполнитьПример. В серверном отладчике смотрите переменные Макет, Группы и Результат; у табличного документа можно открыть просмотр значения. Не пытайтесь вернуть Макет в тонкий клиент.
Каждый запуск заново строит свою схему и макет в памяти. Код не открывает клиентское окно, не печатает, не сохраняет файлы, не меняет настройки другого пользователя и не пишет в базу.
Настройки группировок и уже скомпилированные группировки макета — разные типы. У последних нет конструктора Новый: они получаются из реального Макет.Тело после КомпоновщикМакетаКомпоновкиДанных.Выполнить.
Пример не запускался в 1С. Контрольные результаты ниже ожидаемые; статические проверки сигнатур не подтверждают фактическое оформление или размещение итогов в табличном документе.
Процедура ВыполнитьПример() Экспорт
Схема = Новый СхемаКомпоновкиДанных;
Источник = Схема.ИсточникиДанных.Добавить();
Источник.Имя = "УчебныеПродажи";
Источник.ТипИсточникаДанных = "Local";
Набор = Схема.НаборыДанных.Добавить(Тип("НаборДанныхЗапросСхемыКомпоновкиДанных"));
Набор.Имя = "СвоиТриСтроки";
Набор.ИсточникДанных = Источник.Имя;
Набор.АвтоЗаполнениеДоступныхПолей = Истина;
Набор.Запрос = "ВЫБРАТЬ
| ""Север"" КАК Магазин,
| ""Книга"" КАК Наименование,
| 3 КАК Количество,
| 750 КАК Сумма
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ""Север"", ""Ручка"", 1, 50
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ""Юг"", ""Книга"", 2, 500";
Для Каждого ИмяРесурса Из СтрРазделить("Сумма,Количество", ",") Цикл
Ресурс = Схема.ПоляИтога.Добавить();
Ресурс.ПутьКДанным = ИмяРесурса;
Ресурс.Выражение = "Сумма(" + ИмяРесурса + ")";
КонецЦикла;
Настройки = Схема.НастройкиПоУмолчанию;
ТаблицаНастроек = Настройки.Структура.Добавить(Тип("ТаблицаКомпоновкиДанных"));
ТаблицаНастроек.Имя = "УчебныеМагазиныПоТоварам";
ТаблицаНастроек.Использование = Истина;
Выбор = ТаблицаНастроек.Выбор.Элементы.Добавить(Тип("ВыбранноеПолеКомпоновкиДанных"));
Выбор.Поле = Новый ПолеКомпоновкиДанных("Сумма");
Выбор.Использование = Истина;
СтрокаНастроек = ТаблицаНастроек.Строки.Добавить();
СтрокаНастроек.Имя = "Магазины";
СтрокаНастроек.Использование = Истина;
ПолеМагазина = СтрокаНастроек.ПоляГруппировки.Элементы.Добавить(Тип("ПолеГруппировкиКомпоновкиДанных"));
ПолеМагазина.Поле = Новый ПолеКомпоновкиДанных("Магазин");
ПолеМагазина.ТипГруппировки = ТипГруппировкиКомпоновкиДанных.Элементы;
ПолеМагазина.Использование = Истина;
КолонкаНастроек = ТаблицаНастроек.Колонки.Добавить();
КолонкаНастроек.Имя = "Товары";
КолонкаНастроек.Использование = Истина;
ПолеТовара = КолонкаНастроек.ПоляГруппировки.Элементы.Добавить(Тип("ПолеГруппировкиКомпоновкиДанных"));
ПолеТовара.Поле = Новый ПолеКомпоновкиДанных("Наименование");
ПолеТовара.ТипГруппировки = ТипГруппировкиКомпоновкиДанных.Элементы;
ПолеТовара.Использование = Истина;
КонтрольныйЗапрос = Новый Запрос;
КонтрольныйЗапрос.Текст = Набор.Запрос;
ИсходныеСтроки = КонтрольныйЗапрос.Выполнить().Выгрузить();
Если ИсходныеСтроки.Количество() <> 3 Или ИсходныеСтроки.Итог("Сумма") <> 1300 Тогда
ВызватьИсключение "Изменились собственные учебные данные";
КонецЕсли;
Компоновщик = Новый КомпоновщикМакетаКомпоновкиДанных;
Макет = Компоновщик.Выполнить(Схема, Настройки);
Группы = Новый Массив;
НайтиТабличныеГруппы(Макет.Тело, Группы);
Если Группы.Количество() = 0 Тогда
ВызватьИсключение "В собственной матрице не найдены табличные группировки";
КонецЕсли;
Для Каждого ГруппаМакета Из Группы Цикл
Сообщить("Имя группировки: " + ГруппаМакета.Имя);
Сообщить("Идентификатор: " + ГруппаМакета.Идентификатор);
Сообщить("Ограничение количества: " + Строка(ГруппаМакета.КоличествоЗаписей));
Сообщить("Процент записей: " + Строка(ГруппаМакета.ПроцентЗаписей));
Сообщить("Отбор записей: " + ГруппаМакета.ОтборЗаписей);
Сообщить("Отбор группировок: " + ГруппаМакета.ОтборГруппировок);
Сообщить("Отбор группировок с иерархией: " + ГруппаМакета.ОтборГруппировокСИерархией);
Сообщить("Отбор только иерархии: " + ГруппаМакета.ОтборГруппировокТолькоИерархия);
Сообщить("Частей тела: " + Строка(ГруппаМакета.Тело.Количество()));
Сообщить("Частей иерархического тела: " + Строка(ГруппаМакета.ТелоИерархии.Количество()));
Для Каждого Поле Из ГруппаМакета.Группировка Цикл
Сообщить("Поле группировки: " + Поле.ИмяПоля + "; выражение: " + Поле.Выражение);
КонецЦикла;
Для Каждого Порядок Из ГруппаМакета.Порядок Цикл
Сообщить("Порядок: " + Порядок.Выражение + "; направление: " + Строка(Порядок.ТипУпорядочивания));
КонецЦикла;
Сообщить("Элементов иерархического порядка: " + Строка(ГруппаМакета.ИерархическийПорядок.Количество()));
Сообщить("Макет шапки полей: " + ГруппаМакета.МакетШапки.Макет);
Сообщить("Макет итогов шапки: " + ГруппаМакета.МакетШапки.МакетИтоговРесурсов);
Сообщить("Макетов ресурсов шапки: " + Строка(ГруппаМакета.МакетШапки.МакетРесурсов.Количество()));
Сообщить("Макет подвала полей: " + ГруппаМакета.МакетПодвала.Макет);
Сообщить("Макет итогов подвала: " + ГруппаМакета.МакетПодвала.МакетИтоговРесурсов);
Сообщить("Макетов ресурсов подвала: " + Строка(ГруппаМакета.МакетПодвала.МакетРесурсов.Количество()));
КонецЦикла;
Результат = СформироватьСвойДокумент(Макет);
Сообщить(Результат.ВысотаТаблицы > 0);
КонецПроцедуры
Процедура НайтиТабличныеГруппы(Тело, Найденные)
Для Каждого Часть Из Тело Цикл
Если ТипЗнч(Часть) = Тип("ТаблицаМакетаКомпоновкиДанных") Тогда
СобратьОсьМатрицы(Часть.Строки, Найденные);
СобратьОсьМатрицы(Часть.Колонки, Найденные);
ИначеЕсли ТипЗнч(Часть) = Тип("ГруппировкаМакетаКомпоновкиДанных") Тогда
НайтиТабличныеГруппы(Часть.Тело, Найденные);
КонецЕсли;
КонецЦикла;
КонецПроцедуры
Процедура СобратьОсьМатрицы(ТелоОси, Найденные)
Для Каждого Часть Из ТелоОси Цикл
Если ТипЗнч(Часть) = Тип("ГруппировкаТаблицыМакетаКомпоновкиДанных") Тогда
Найденные.Добавить(Часть);
СобратьОсьМатрицы(Часть.Тело, Найденные);
КонецЕсли;
КонецЦикла;
КонецПроцедуры
Функция СформироватьСвойДокумент(СвойМакет)
Процессор = Новый ПроцессорКомпоновкиДанных;
Процессор.Инициализировать(СвойМакет);
Документ = Новый ТабличныйДокумент;
Вывод = Новый ПроцессорВыводаРезультатаКомпоновкиДанныхВТабличныйДокумент;
Вывод.ОтображатьПроцентВывода = Ложь;
Вывод.УстановитьДокумент(Документ);
РезультатВывода = Вывод.Вывести(Процессор, Ложь);
Если ТипЗнч(РезультатВывода) <> Тип("ТабличныйДокумент") Тогда
ВызватьИсключение "Не получен собственный табличный документ";
КонецЕсли;
Возврат РезультатВывода;
КонецФункции
Разбор по шагам
Схема создаёт собственный Local-источник и ресурсы Сумма(Сумма), Сумма(Количество). Контрольный запрос независимо подтверждает три исходные строки и 1300.
Поля группировки задаются в настройках. Компоновщик превращает их в исполняемый макет; коллекции макета содержат уже другие типы объектов.
Обход проверяет точный ТипЗнч и ищет группы в реальном теле собственного макета. Нет ни Новый для неконструируемого типа, ни объекта, который читатель должен неизвестно где взять.
Имя удобно читать человеку, Идентификатор связывает части макета. Их диагностируем, а не переименовываем: изменение идентификатора без исправления связей может повредить компоновку.
ОтборЗаписей действует на записи, ОтборГруппировок — перед построением иерархии, остальные два отбора имеют отдельные области применения. Выводим именно скомпилированные выражения; пустая строка сама по себе не ошибка.
Порядок и ИерархическийПорядок — разные коллекции. Тело и ТелоИерархии также различны; в нашей неиерархической задаче иерархические части могут быть пустыми.
КоличествоЗаписей и ПроцентЗаписей характеризуют ограничение вывода, а не число строк запроса. Значение -1 у количества означает все записи.
Новый процессор получает весь связанный макет, а вывод создаёт собственный ТабличныйДокумент. Ненулевая высота доказывает только наличие результата, не правильность каждого итога.
У матрицы отдельно обходим Строки и Колонки. В объектах шапки и подвала читаем имя макета полей, имя макета итогов и количество макетов ресурсов.
Как проверить результат
Найдены табличные группировки по Магазин и Наименование; заключительное сравнение высоты даёт Истина. Их точное техническое количество не фиксируется.
В Результат проверьте Север/Книга 750, Север/Ручка 50, Юг/Книга 500. Сумма книги 1250, ручки 50; источник всего 1300.
В отладчике ТипЗнч шапки и подвала — МакетГруппировкиТаблицыМакетаКомпоновкиДанных. Пустые строки или нулевые коллекции в неиспользуемых частях не считаются ошибкой.
Ожидаемый результат
Сформирована собственная матрица и показано отличие табличного заголовка-объекта от имени области обычной группировки.
На что обратить внимание
Не присваивайте readonly-контейнеры Группировка, Тело, ТелоИерархии, Порядок или ИерархическийПорядок. Возможность изменения дочерней коллекции не делает её свойство записываемым.
У обычной группировки МакетШапки — readonly-строка, МакетПодвала — записываемая строка. У табличной обе ссылки readonly и указывают на объекты МакетГруппировкиТаблицыМакетаКомпоновкиДанных; эти контракты нельзя смешивать.
Не подставляйте в отборы строки языка запросов без проверки языка выражений СКД. Для обычного фильтра меняйте настройки и пересобирайте макет.
Идентификаторы, имена областей, число частей макета и физические строки документа зависят от генератора и оформления. Урок не обещает фиксированные технические имена или высоту.
Поиск предназначен для созданной здесь простой структуры без иерархических группировок, вложенных схем и диаграмм, а не для произвольного промышленного отчёта.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.