6.2. Объект "ТабличныйДокумент"

Для работы с табличными документами в "1С: Предприятии" служит одноименный объект типа "ТабличныйДокумент", который относится к группе Общие объекты.

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

Прежде чем формировать отчет средствами встроенного языка с использованием объекта этого типа необходимо его создать. Это можно сделать с помощью конструктора:

ТабДок = Новый ТабличныйДокумент();

Этот объект с помощью коллекций предоставляет доступ к объектам типа ОбластьЯчеекТабличногоДокумента и РисунокТабличногоДокумента. Он также имеет в своем составе объект типа КолонтитулТабличногоДокумента для доступа к его колонтитулам.

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

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

В общем случае, методику формирования отчета можно представить следующим образом:

ТабДок = Новый ТабличныйДокумент(); // алгоритм формирования табличного документа ТабДок.Показать();

При этом метод .Показать() используется для отображения результата работы алгоритма в окне программы. В этом случае согласно терминологии, которая используется в документации к программе, можно говорить о том, что по этому методу в окне будет отображен результирующий табличный документ.

Впрочем, в конце работы алгоритма Вы можете использовать методы:

• Записать(<Имя файла>, <Тип файла таблицы>) для сохранения результатов работы во внешнем файле;

• Напечатать(<Диалог печати>) для вывода отчета на печать вместо метода .Показать().

В этой главе мы рассмотрим формирование отчета как с использованием макета, так и без него.

6.3. Формирование отчета с использованием макета

1. Одним из способов формирования результирующего табличного документа является использование заранее составленного макета.

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

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

4. Если макет находится в составе прикладного объекта метаданных, то тогда получить макет можно, используя метод ПолучитьМакет() соответствующего менеджера объекта метаданных ПолучитьОбщийМакет():

//Получение макета Макет = ПолучитьОбщийМакет("ИмяМакета");