С журналом в системе связана форма отображения списка проводок и программный модуль формы журнала проводок (см. «Виды программных модулей»). В локальном контексте этого программного модуля непосредственно доступны реквизиты формы. Кроме того, здесь непосредственно доступен объект «Операция», содержащий значение операции, которой принадлежит выбранная в журнале проводка. Другими словами, в модуле формы журнала проводок обращение к атрибутам и методам текущей операции выполняется напрямую.
Методы контекста Модуля формы журнала проводок
Описанные в данном разделе методы доступны только в контексте модуля формы журнала проводок (см. «Виды программных модулей»).
ВидыОтбора
Установить доступные виды отборов для журнала проводок.
Синтаксис:
ВидыОтбора(<СписокОтборов>)
Англоязычный синоним:
KindsOfSelection
Возвращаемое значение:
Строковое значение, содержащее текущий (на момент до вызова метода) список отборов для журнала. Имена отбора в возвращаемой строке разделяются запятыми.
Описание:
Метод ВидыОтбора устанавливает доступные виды отборов журнала проводок. Использование данного метода влияет на полноту списка видов отбора, который выдается пользователю в диалоге «Отбор» при работе с системой 1С:Предприятие.
Метод ВидыОтбора позволяет ограничить число видов отбора, доступных конкретному пользователю при работе с журналом проводок, или совсем запретить выполнение отбора в журнале проводок. Данный метод доступен только в контексте модуля формы журнала проводок (см. «Виды программных модулей»).
Можно выделить 4 варианта использования данного метода.
1. Если параметр <СписокОтборов> не указан, метод возвращает текущий список отборов, установленных для журнала проводок.
2. Чтобы ограничить использование отборов какими-либо конкретными видами отбора, список этих видов отбора следует передать методу в качестве параметра. Указывать в списке можно как имена отборов, автоматически задаваемые системой 1С:Предприятие, так и отборы, созданные в процессе конфигурирования: по реквизитам проводки и по субконто проводки.
«Системные» отборы задаются включением соответствующих опций в окне редактирования свойств проводки в конфигураторе. Каждому виду отбора соответствует «системное» имя отбора — то, которое выдается пользователю в диалоге «Отбор», и которое можно использовать во встроенном языке (в том числе, и при вызове метода ВидыОтбора).
Для журнала проводок допустимы следующие «системные» имена отборов:
Сумма — отбор по сумме проводки;
ВалСумма — отбор по валютной сумме проводки;
Валюта — отбор по валюте проводки;
Количество — отбор по количеству проводки;
Счет — отбор по счетам проводки;
СчетДт — отбор по счетам дебета проводки;
СчетКт — отбор по счетам кредита проводки;
ПланСчетов — отбор по плану счетов.
Кроме этого, в конфигураторе можно включить возможность выполнять отборы по субконто проводки и дополнительным реквизитам проводки. Для этого используется опция «Отбор» в закладке «Дополнительные» палитры свойств вида субконто или дополнительного реквизита проводки. В этих случаях в качестве имен отбора следует использовать идентификаторы видов субконто или дополнительных реквизитов проводки.
3. Если параметр <СписокОтборов> равен «*», разрешаются все виды отборов, установленные для журнала проводок в конфигураторе. Вызов метода ВидыОтбора с таким параметром позволяет отключить ранее установленное ограничение на использование видов отборов.
4. Если в качестве параметра методу ВидыОтбора передана пустая строка, метод запрещает пользователю выполнение любых отборов в журнале проводок.
Замечание. Ограничение списка отборов, выполненное при помощи метода ВидыОтбора, не исключает использование «запрещенного» отбора средствами встроенного языка. Например, методом ВидыОтбора("") можно запретить использование любых отборов в журнале проводок, но установить отбор проводок по конкретной организации. В этом случае пользователь будет просматривать проводки, относящиеся только к указанной организации, но не будет иметь возможность изменить организацию.
Пример:
ВидыОтбора("Склад, Клиент, Автор");
ЗакладкиОтбора
Установить в форме журнала проводок закладки для интерактивного отбора.
Синтаксис:
ЗакладкиОтбора(<ИмяОтбора>, <ВИнтервалеЖурнала>, <УстановитьНаЗначение>,
<ЗначениеОтбора>)
Англоязычный синоним:
TabCtrlSelection
Описание:
Метод ЗакладкиОтбора устанавливает в форме журнала проводок закладки для интерактивного осуществления отбора. При включении закладок в верхней части журнала проводок появляются ярлыки, соответствующие значениям отбора. Щелчком мыши по ярлыку можно открыть «страницу» журнала проводок: такая «страница» будет содержать проводки, отобранные по указанному значению.
Для включения отбора необходимо в качестве параметра <ИмяОтбора> передать методу имя отбора. Можно использовать как имена отборов, автоматически задаваемые системой 1С:Предприятие, так и отборы, созданные в процессе конфигурирования: по реквизитам проводки и по субконто проводки.
«Системные» отборы задаются включением соответствующих опций в окне редактирования свойств проводки в конфигураторе. Каждому виду отбора соответствует «системное» имя отбора — то, которое выдается пользователю в диалоге «Отбор», и которое можно использовать во встроенном языке.
Для журнала проводок допустимы следующие «системные» имена отборов:
Сумма — отбор по сумме проводки;
ВалСумма — отбор по валютной сумме проводки;
Валюта — отбор по валюте проводки;
Количество — отбор по количеству проводки;
Счет — отбор по счетам проводки;
СчетДт — отбор по счетам дебета проводки;
СчетКт — отбор по счетам кредита проводки;
ПланСчетов — отбор по плану счетов.
Кроме этого, в конфигураторе можно включить возможность выполнять отборы по субконто проводки и дополнительным реквизитам проводки. Для этого используется опция «Отбор» в закладке «Дополнительные» палитры свойств вида субконто или дополнительного реквизита проводки. В этих случаях в качестве имен отбора следует использовать идентификаторы видов субконто или дополнительных реквизитов проводки.
Данный метод доступен только в контексте модуля формы журнала проводок (см. «Виды программных модулей»).
Пример:
ЗакладкиОтбора("Склады", 1, 1, Константа.ОснСклад);
УстановитьОтбор
Установить отбор журнала проводок.
Синтаксис:
УстановитьОтбор(<ИмяОтбора>, <ЗначениеОтбора>)
Англоязычный синоним:
SetSelection
Описание:
Метод УстановитьОтбор принудительно устанавливает отбор для журнала проводок. Для установки отбора методу должны быть переданы 2 параметра: имя отбора и значение отбора.
Возможные виды отбора для журнала проводок задаются в конфигураторе. В окне редактирования свойств проводки можно включить опции, соответствующие различным видам отбора. Для таких отборов система 1С:Предприятие использует зарезервированные имена:
Сумма — отбор по сумме проводки;
ВалСумма — отбор по валютной сумме проводки;
Валюта — отбор по валюте проводки;
Количество — отбор по количеству проводки;
Счет — отбор по счетам проводки;
СчетДт — отбор по счетам дебета проводки;
СчетКт — отбор по счетам кредита проводки;
ПланСчетов — отбор по плану счетов.
Кроме этого, в конфигураторе можно включить возможность выполнять отборы по субконто проводки и дополнительным реквизитам проводки. Для этого используется опция «Отбор» в закладке «Дополнительные» палитры свойств вида субконто или дополнительного реквизита проводки. В этих случаях в качестве имен отбора следует использовать идентификаторы видов субконто или дополнительных реквизитов проводки.
Отбор устанавливается по значению, указанному в параметре <ЗначениеОтбора>.
Данный метод доступен только в контексте модуля формы журнала проводок (см. «Виды программных модулей»).
Пример:
Изм = УстановитьОтбор("Склады", Склад1);