Глава 6. Табличный документ

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

6.1. Команда "Вывести список" режима "1с: Предприятие"

Режим "1С: Предприятие" умеет формировать отчет в табличной форме без какого-либо программирования, для того чтобы познакомиться с этой возможностью - выполните следующее упражнение.

У пражнение №6.1.

З апустите конфигурацию в режиме "1С: Предприятие". Откройте форму списка регистра сведений "Курсы" и выберете пункт меню "Действия – Вывести список" (см. рис. 6.1).

Рис. 6.1. Команда "Вывести список".

На втором этапе в диалоге "Вывести список" сбросьте флаг у колонки "Картинка" и нажмите на кнопку "ОК" (см. рис. 6.2).

Рис. 6.2. Определение типа выходного документа и состава колонок.

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

Рис. 6.3. Результат выполнения упражнения №6.1

Если содержимое табличного документа, полученное таким образом устраивает пользователя, то настройку конфигурации можно оставить без изменения.

Однако постановка нашей задачи требует, чтобы "Во всех отчетах, формируемых ИБ, должно появляться название объединения". Для решения этой задачи нам придется прибегнуть к программированию.

И в последующих разделах мы рассмотрим работу с объектом "ТабличныйДокумент" встроенного языка.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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