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

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

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

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

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

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

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

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

увеличить изображение
Рис. 6.8. Документ Отпуск материалов мастеру

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

Рис. 6.9. Дополнительный реквизит регистра накопления ОстаткиМатериалов

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

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

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

увеличить изображение
Рис. 6.10. Добавление и настройка кнопки Рассчитать

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

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

1. Поочередно перебрать строки табличной части;
2. Получить для номенклатурной позиции, упомянутой в строке, сведения о количестве и сумме из регистра ОстаткиМатериалов ;
3. Вычислить стоимость единицы материала (делением общего суммового остатка на общий количественный остаток);
4. Вычислить стоимость списываемых материалов;
5. Записать в поле Сумма табличной части результат вычисления.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

КонецЦикла;

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

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

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

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

увеличить изображение
Рис. 6.11. Проверка правильности работы созданного механизма

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

Напомним, что документ ОтпускМатериаловМастеру пока не формирует движений по регистру ОстаткиМатериалов. Создадим процедуру проведения документа, воспользовавшись конструктором движений регистров. Обратите внимание на то, что документ фиксирует расход материалов (тип движения регистра - Расход ). На рис. 6.12 вы можете видеть форму конструктора движений после заполнения ее параметров.

Рис. 6.12. Настройка проведения документа

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

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

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

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