Документы, макеты, журналы документов

Записаться

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

6.1. Разработка печатной формы документа

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

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

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

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

Второй этап разработки печатной формы - это создание программного кода, который на основе данных документа и макета "собирает" печатную форму.

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

Появившееся окно конструктора печати, проведет вас через несколько шагов, необходимых для создания печатной формы. А именно, на первом шаге нужно указать имя процедуры печати и ее расположение. По умолчанию процедура называется ) и нажмем на кнопку Далее.

Во втором окне конструктора (рис 6.3) нам предлагается задать, какие реквизиты документа попадут в шапку печатной формы, то есть - в ее верхнюю часть.

В правой части формы, которая называется Реквизиты документа можно найти список реквизитов документа, в левой части, которая представляет собой список реквизитов шапки, отображаются реквизиты документа, перенесенные туда либо двойным щелчком, либо - с помощью кнопки с изображением стрелки. Для того, чтобы перенести все реквизиты в шапку - достаточно нажать на кнопку с двумя стрелками. Перенесем в шапку печатной формы все реквизиты документа кроме реквизита СтоимостьМатериалов. Его мы прибережем для того, чтобы вывести в подвале - то есть - в нижней части печатной формы.

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

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

Очередное нажатие кнопки .

Кнопка .

Обратите внимание на то, что на нижней панели управления формы появилась новая кнопка - Печать. Обратите так же внимание на то, что табличный документ, который представляет собой макет, разбит на именованные области. Здесь мы можем видеть области Заголовок, Шапка, МатериалыШапка, Материалы и Подвал. В этих областях мы можем видеть ячейки, содержащие обычный текст, без каких-либо специальных символов. При выводе именованной области в печатный документ, эти тексты будут выведены в том виде, в котором они представлены в макете, с использованием того же форматирования. Если же в макет выводится ячейка, текст в которой обрамлен значками "<>", в этой ячейке будет выведен какой-либо реквизит документа. В частности, в угловых скобках в данном случае выводятся параметры для вывода их в ячейках.Имена параметров совпадают с соответствующими именами реквизитов документа.

То, что вы сейчас узнали, сделает достаточно простым знакомство с процедурой печати, которая была сформирована автоматически. Напомним, что при работе конструктора печати мы указали, что хранить эту процедуру следует в модуле формы. Найдем процедуру в модуле формы (вкладка Модуль ). Вот как выглядит текст модуля:

Процедура Печать(Элемент)
	//{{_КОНСТРУКТОР_ПЕЧАТИ_ЭЛЕМЕНТ(Печать)
	// Данный фрагмент построен конструктором.
	// При повторном использовании конструктора, внесенные вручную изменения будут утеряны!!!
	ТабДок = Новый ТабличныйДокумент;
	Макет = Документы.ПоступлениеМатериалов.ПолучитьМакет("Печать");
	// Заголовок
	Область = Макет.ПолучитьОбласть("Заголовок");
	ТабДок.Вывести(Область);
	// Шапка
	Шапка = Макет.ПолучитьОбласть("Шапка");
	Шапка.Параметры.Заполнить(ЭтотОбъект);
	ТабДок.Вывести(Шапка);
	// Материалы
	Область = Макет.ПолучитьОбласть("МатериалыШапка");
	ТабДок.Вывести(Область);
	ОбластьМатериалы = Макет.ПолучитьОбласть("Материалы");
	Для Каждого ТекСтрокаМатериалы Из Материалы Цикл
		ОбластьМатериалы.Параметры.Заполнить(ТекСтрокаМатериалы);
		ТабДок.Вывести(ОбластьМатериалы);
	КонецЦикла;
	// Подвал
	Подвал = Макет.ПолучитьОбласть("Подвал");
	Подвал.Параметры.Заполнить(ЭтотОбъект);
	ТабДок.Вывести(Подвал);

	ТабДок.ОтображатьСетку = Ложь;
	ТабДок.Защита = Ложь;
	ТабДок.ТолькоПросмотр = Ложь;
	ТабДок.ОтображатьЗаголовки = Ложь;
	ТабДок.Показать();
	//}}_КОНСТРУКТОР_ПЕЧАТИ_ЭЛЕМЕНТ
КонецПроцедуры

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

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

В переменную ТабДок записываем ссылку на новый объект типа ТабличныйДокумент. Это именно тот документ, который, после работы процедуры, будет содержать готовую печатную форму. Сразу после создания табличный документ не виден пользователю, то есть все действия, которые мы с ним будем производить дальше, выполняются с невидимым документом. После завершения программного формирования документа, мы сделаем его видимым.

Макет = Документы.ПоступлениеМатериалов.ПолучитьМакет("Печать");

В переменную Макет записываем ссылку на макет с именем Печать, который принадлежит нашему документу. Будем использовать эту переменную для доступа к макету.

// Заголовок
	Область = Макет.ПолучитьОбласть("Заголовок");
	ТабДок.Вывести(Область);

В этом участке кода мы сначала получаем именованную область макета, которая носит имя Заголовок. Фактически, метод ПолучитьОбласть объекта Макет возвращает новый табличный документ, который представляет собой область, полученную по имени или другим способом. Ссылка на документ записывается в переменную Область. Используя метод Вывести объекта ТабДок мы выводим полученную область в наш табличный документ.

// Шапка
	Шапка = Макет.ПолучитьОбласть("Шапка");
	Шапка.Параметры.Заполнить(ЭтотОбъект);
	ТабДок.Вывести(Шапка);

В заголовке, если посмотреть на макет, есть лишь текст, содержащий название документа и никаких полей, которые нужно заполнять данными документа. А вот в шапке такие параметры имеются. Область, соответствующую шапке, мы получаем уже рассмотренным методом. А вот следующая команда - Шапка.Параметры.Заполнить(ЭтотОбъект); позволяет заполнить ячейки области, содержащие параметры, реквизитами объекта, переданного в качестве параметра (в данном случае мы имеем дело с объектом ЭтотОбъект - он позволяет получить тот документ, с которым мы в данный момент работаем). Соответствия между параметрами и реквизитами документа устанавливаются по именам. Ячейка, содержащая параметр <Номер> будет заполнена реквизитом документа с именем Номер и так далее.

// Материалы
	Область = Макет.ПолучитьОбласть("МатериалыШапка");
	ТабДок.Вывести(Область);

В данном участке кода мы получаем область, соответствующую шапке таблицы и выводим ее в табличный документ. Далее следует обработка таблицы и ее построчный вывод:

ОбластьМатериалы = Макет.ПолучитьОбласть("Материалы");
	Для Каждого ТекСтрокаМатериалы Из Материалы Цикл
		ОбластьМатериалы.Параметры.Заполнить(ТекСтрокаМатериалы);
		ТабДок.Вывести(ОбластьМатериалы);
	КонецЦикла;

Здесь мы видим цикл, который перебирает каждую строку табличной части Материалы. На основе каждой из строк (переменная ТекСтрокаМатериалы ) он заполняет параметры области Материалы и выводит ее в табличный документ.

// Подвал
	Подвал = Макет.ПолучитьОбласть("Подвал");
	Подвал.Параметры.Заполнить(ЭтотОбъект);
	ТабДок.Вывести(Подвал);

Подвал выводится уже знакомым вам образом. Далее настраиваются некоторые свойства формируемого документа, влияющие на его внешний вид:

ТабДок.ОтображатьСетку = Ложь;
	ТабДок.Защита = Ложь;
	ТабДок.ТолькоПросмотр = Ложь;
	ТабДок.ОтображатьЗаголовки = Ложь;
	ТабДок.Показать();

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

Запустим наше прикладное решение в режиме 1С:Предприятие и посмотрим, как выглядит печатная форма для какого-нибудь документа, ).

Для того чтобы распечатать эту форму, достаточно воспользоваться командой главного меню программы Файл > Печать.

Выше, говоря об устройстве макета, мы рассмотрели лишь результаты работы конструктора печати. Вы можете видеть то, что получилось на выходе конструктора печати, позволяет получить вполне стандартно выглядящую печатную форму. Если нам нужно что-то большее - как в плане внешнего вида формы, так и в плане использования параметров для ее заполнения, нам нужно будет воспользоваться ручным редактированием (или созданием с нуля) макетов и модулей печати.

На данном этапе не будем больше улучшать и дорабатывать документ ПоступлениеМатериалов. Займемся еще одним документом нашей конфигурации.

6.2. Разработка документа ОтпускМатериаловМастеру

В соответствии с логикой нашей учетной системы, мы создали документ, который отражает поступление материалов, которые хранятся у определенного материально ответственного лица - сотрудника организации. Теперь создадим документ, который используется для отпуска материалов, вверенных материально-ответственным лицам. Назовем его ОтпускМатериаловМастеру.

Логика бизнес-процесса организации, который мы собираемся автоматизировать с помощью данного документа, такова. К сотруднику, за которым закреплены материалы (назовем его "кладовщик") обращается другой сотрудник (назовем его "мастер"), которому материалы нужны для проведения каких-либо работ. В заказе мастера есть количество требуемых материалов. На основании требования мастера, кладовщик должен передать ему требуемое количество материалов - но не больше, чем за ним числится - и выдать документ, который содержит информацию о количестве и стоимости выданных материалов. Если у одного из кладовщиков не хватает материалов для выдачи мастеру - он может выполнить заказ в пределах своих возможностей, а мастер, в свою очередь, может воспользоваться услугами нескольких кладовщиков.

Материалы отпускают по средней стоимости. Наш документ должен иметь печатную форму, он так же должен проводиться по регистру ОстаткиМатериалов, отражая в нем факт выбытия материалов.

Документ будет иметь следующие реквизиты, табл. 6.1:

Документ будет иметь табличную часть Материалы, которая будет иметь следующие реквизиты:

Вот как выглядит окно редактирования объекта и форма документа после создания реквизитов и автоматического создания формы, рис 6.8. Напомним, что если какие-либо объекты конфигурации имеют реквизиты, схожие с теми, которые нужны в новых объектах - их можно копировать - это ускоряет работу.

Прежде чем заниматься дальнейшей работой над документом, нам нужно модифицировать регистр накопления ). Запись в этот реквизит будет осуществляться документом ОтпускМатериаловМастеру.

Не забудем добавить документ ОтпускМатериаловМастеру в список регистраторов регистра ОстаткиМатериалов, установив галочку напротив наименования документа на вкладке Регистраторы окна редактирования свойств регистра.

При вводе информации в табличную часть документа, мы будем заполнять лишь реквизиты Номенклатура и Количество. Сумма для списания будет вычисляться по нажатию специальной кнопки. В частности, при нажатии на эту кнопку будет проверяться, достаточно ли материалов каждого вида числится за ответственным лицом, и, если достаточно - будет рассчитываться средняя стоимость материалов, которые предполагается списать.

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

Теперь заблокируем поле табличной части Сумма от изменений, установим его свойство ТолькоПросмотр. Поле мы собираемся рассчитывать по нажатию на кнопку Рассчитать и заполнять программно.

Если поразмышлять над тем, как реализовать расчет средней стоимости, то, основываясь на тех знаниях, которые у вас уже есть, можно прийти к выводу о том, что нужно выполнить следующую последовательность действий:

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

Процедура ДействияФормыРассчитать(Кнопка)
	 ОстМатериалов=РегистрыНакопления.ОстаткиМатериалов;
	 Фильтр=Новый Структура;
	 Фильтр.Вставить("ЦентрОтветственности", ОтветственныйСотрудник);
	 Для Каждого ТекСтрокаМатериалы Из Материалы Цикл
		Фильтр.Вставить("Номенклатура", ТекСтрокаМатериалы.Номенклатура);
		ТабОстатков = ОстМатериалов.Остатки(,Фильтр,,); 
		ТекСтрокаТабОстатков = ТабОстатков.Получить(0);		
		ТекСтрокаМатериалы.Сумма=(ТекСтрокаТабОстатков.Сумма/ТекСтрокаТабОстатков.Количество)
*ТекСтрокаМатериалы.Количество;
	 КонецЦикла;
СтоимостьМатериалов = Материалы.Итог("Сумма");  
КонецПроцедуры

Прежде чем рассматривать процедуру, следует дать некоторые пояснения. Здесь мы пользуемся объектом типа РегистрНакопленияМенеджер, доступ к которому обеспечивается с помощью свойства глобального контекста РегистрыНакопления. То есть, другими словами, для того, чтобы получить доступ к регистру накопления ОстаткиМатериалов, определенному в конфигурации, нам следует обратиться к нему с помощью конструкции РегистрыНакопления.ОстаткиМатериалов. Эта конструкция имеет тип РегистрНакопленияМенеджер.

У менеджера регистра накопления ( ОстМатериалов ) есть различные методы, один из которых - а именно - Остатки() - предназначен для получения остатков. Причем, полный вызов этого метода выглядит так:

Остатки(<Момент времени>, <Отбор>, <Измерения>, <Ресурсы>)

Нас, в данном случае, интересует получение текущих остатков, то есть, остатков на наибольшую дату движения регистра. Поэтому параметр Момент времени мы не используем. Параметры Измерения и Ресурсы мы так же не используем - нам нужно получить остатки по всем измерениям и ресурсам в рамках, заданных параметром Отбор. Параметр Отбор для нас важен, так как мы собираемся получать данные об одном из видов номенклатуры, числящемся за материально ответственным лицом. Параметр Отбор имеет тип Структура. Структура - это набор ключей и соответствующих им значений. В нашем случае структура должна содержать имена измерений регистра, по которым мы хотим получить остатки, и значения, которые нужно отобрать среди указанных измерений. Имена задаются в виде строк, значения имеют тот же тип, что и тип соответствующих измерений.

Данные, полученные из регистра накопления, собраны в таблице значений. Это - таблица, которая имеет несколько строк (в нашем случае это одна строка, нумерация строк начинается с 0) и столбцов. Имена столбцов соответствуют данным, которые хранятся в таблице. В нашем случае таблица будет, кроме прочих, иметь столбцы Сумма и Количество, которые и хранят нужные нам данные.

Теперь рассмотрим процедуру.

ОстМатериалов=РегистрыНакопления.ОстаткиМатериалов;

Записываем в переменную ОстМатериалов ссылку на менеджер регистра ОстаткиМатериалов.

Фильтр=Новый Структура;

В переменную Фильтр запишем ссылку на только что созданную пустую структуру.

Фильтр.Вставить("ЦентрОтветственности", ОтветственныйСотрудник);

Мы планируем получать остатки различных материалов по одному ответственному сотруднику, который указан в шапке документа. Поэтому сразу же вставляем в структуру пару - ключ - "ЦентрОтветственности", значение - ОтветственныйСотрудник.

Обратите внимание на то, что остальные операции процедуры выполняются в цикле.

Для Каждого ТекСтрокаМатериалы Из Материалы Цикл

Открываем цикл перебора строк табличной части Материалы, записывая ссылку на текущую строку в переменную ТекСтрокаМатериалы.

Фильтр.Вставить("Номенклатура", ТекСтрокаМатериалы.Номенклатура);

Вставляем в структуру еще одну пару Ключ - Значение. Она будет применяться для отбора по номенклатуре, указанной в текущей строке табличной части. Метод Вставить у структур действует следующим образом. Если ключа, указанного при вызове метода, еще нет в структуре, он создается. Если есть - его значение заменяется на то, которое передано при вызове метода. Мы вызываем этот метод столько раз, сколько строк есть в табличной части документа. Получается, что лишь первый вызов создает в структуре ключ "Номенклатура". Последующие вызовы лишь меняют его значение на номенклатуру, указанную в строке.

ТабОстатков = ОстМатериалов.Остатки(,Фильтр,,);

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

ТекСтрокаТабОстатков = ТабОстатков.Получить(0);

В переменную ТекСтрокаТабОстатков будет записан результат выполнения метода таблицы значений Получить(). В качестве параметра ему передается номер строки.

ТекСтрокаМатериалы.Сумма=(ТекСтрокаТабОстатков.Сумма/ТекСтрокаТабОстатков.Количество)
*ТекСтрокаМатериалы.Количество;

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

КонецЦикла;

Закрываем цикл.

СтоимостьМатериалов = Материалы.Итог("Сумма")

Выводим в реквизит шапки документа итоговую стоимость списываемых материалов.

Проверим работу механизма на практике, рис 6.11.

На этом мы завершим разработку формы и ее механизмов, хотя, безусловно, здесь можно сделать еще множество доработок, повышающих удобство работы пользователя, предотвращающих возникновение ошибок. Вы можете проделать эти работы самостоятельно.

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

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

И, наконец, создадим печатную форму документа, воспользовавшись конструктором печати. Проверим правильность работы механизмов (рис 6.13).

После проведения документа в регистре накопления появились движения с видом движения Расход.

6.3. Журнал документов

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

Перейдем на вкладку .

Теперь, если мы откроем конфигурацию в режиме 1С:Предприятие и выполним команду меню .

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

Если попытаться создать новый элемент журнала, нажав на кнопку .

Для создания документа, нужно выбрать его вид и нажать кнопку ОК в окне Выбор вида документа.

Улучшим журнал. Добавим в него две новые графы. Для этого перейдем в режим конфигурирования, откроем окно редактирования свойств объекта СкладскиеДокументы на вкладке Данные.

В поле для добавления граф добавим новую графу, в открывшемся окне ее свойств введем имя - .

В нашем случае выбраны реквизиты ОтветственныйСотрудник. Каждый документ может отобразить в графе журнала лишь один из своих реквизитов.

Точно так же создадим новую графу с именем СтоимостьМатериалов, настроим отображение в ней реквизитов документов СтоимостьМатериалов.

На рис 6.18 представлен измененный журнал в режиме 1С:Предприятие.

6.4. Выводы

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