Методы журнала расчетов
УстановитьРеквизит
Установить значение реквизита журнала расчетов для последующей записи.
Синтаксис:
УстановитьРеквизит(<ИмяРеквизита>, <Значение>)
Англоязычный синоним:
SetAttribute
Параметры:
| <ИмяРеквизита> | Строка – наименование реквизита журнала расчетов. |
| <Значение> | Значение, устанавливаемое для записи в реквизит <ИмяРеквизита>. |
Описание:
Метод предназначен для организации заполнения дополнительных реквизитов журнала расчетов при вводе новых записей в журнал расчетов. Метод применяется в двух случаях: во-первых, при вводе записей журнала расчетов в процедуре проведения документа одним из перечисленных ниже методов:
- ВвестиРасчет;
- ВвестиРасчетНаОсновании;
- ЗаписатьРасчет;
- ЗаписатьРасчетНаОсновании.
Во-вторых, при вводе произвольных новых записей журнала расчетов (методы Новая и Записать).
В этих двух случаях метод УстановитьРеквизит работает по-разному. В случае, когда метод применяется перед вводом записей при проведении документа, не имеет смысла устанавливать значения для следующих реквизитов:
- Объект,
- Документ,
- РодительскийДокумент,
- ВидРасчета,
- ДатаНачала,
- ДатаОкончания,
- ПервичнаяЗапись.
Данные установки игнорируются последующими методами ВвестиРасчет, ЗаписатьРасчет и им подобными. Т. е. при вводе записей журнала этими методами возможна установка только реквизитов журнала, заданных при конфигурировании, реквизита Результат и таких признаков записи журнала, как: Рассчитана, Исправлена, Сторно, Фиксирована, Перерасчет.
В случае, когда метод применяется при вводе записей методами Новая и Записать, в качестве первого параметра <ИмяРеквизита> могут применятся наименования реквититов журнала расчетов, заданные при конфигураировании системы или следующие атрибуты, соответствующие предопределенным реквизитам журнала расчетов:
- Документ
- РодительскийДокумент
- Объект
- ВидРасч
- ДатаНачала
- ДатаОкончания
- Сторно
- Рассчитана
- Исправлена
- Фиксирована
- Перерасчет
- ПервичнаяЗапись
- Результат
Внимание
Атрибуты журнала расчетов ПериодДействия и ПериодРегистрации не устанавливаются пользователем. Атрибут ПериодРегистрации при вводе записи принимает значение текущего (установленного в данный момент для журнала расчетов) периода, а атрибут ПериодДействия соответствует установленным значениям ДатаНачала и ДатаОкончания.
Замечание
Установленные методом значения используются однократно, при первом же вызове одного из вышеперечисленных методов ввода новых записей журнала расчетов установленные значения "сбрасываются". Для записи нескольких реквизитов необходимо использовать метод несколько раз.
Пример:
Процедура ВвестиЗапись(Сотр, ВР, Сумма, Процент)
ЖЗ = СоздатьОбъект("ЖурналРасчетов.Зарплата");
// будем записывать несколько реквизитов
ЖЗ.УстановитьРеквизит("Сторно", 1);
ЖЗ.УстановитьРеквизит("Рассчитана", 1);
// введенные записи будут сторнированными и отмеченными
// как рассчитанные
ЖЗ.ВвестиРасчет(Сотр, ВР, Нач, Оконч, Сумма*Процент);
КонецПроцедуры
См. также: ВвестиРасчет, ЗаписатьРасчет.