Записать значение периодического реквизита справочника с привязкой к документу.
Синтаксис:
УстановитьРеквизитСправочника(<ЭлементСправочника>, <НазваниеРеквизита>,
<3начение>, <ДатаУстановки>, <ИмяТипа>, <Длина>, <Точность>)
Англоязычный синоним:
SetRefField
Параметры:
<ЭлементСправочника> |
Выражение, задающее элемент справочника, в котором требуется записать новое значение периодического реквизита. |
<НазваниеРеквизита> |
Строковое выражение — название периодического реквизита справочника (как он назван в конфигураторе) в котором требуется записать новое значение периодического реквизита. |
<3начение> |
Новое значение периодического реквизита. |
<ДатаУстановки> |
Выражение типа «дата», на которую требуется установить новое значение периодического реквизита. Этот параметр имеет смысл только для не оперативных документов и позволяет установить значение на другую дату чем дата документа, но тогда с пустым временем. |
<ИмяТипа> |
Необязательный параметр. Строковое выражение — название типа данных (или Вид субконто). |
<Длина> |
Необязательный параметр. Число — длина числового или строкового значения. |
<Точность> |
Необязательный параметр. Число знаков после десятичной точки для числового значения. |
Описание:
Метод УстановитьРеквизитСправочника записывает новое значение периодического реквизита справочника с привязкой к документу. Использование Данного метода позволяет вносить изменения в справочники с привязкой к проведению документа. Это значит, что при удалении или редактировании или отказе от проведения документа все сделанные им изменения в справочнике будут корректно отменены. Средства языка позволяют выбирать такие движе-иия справочника по документу или определять документ, который произвел изменения в справочнике (см. «Работа с объектом Периодический»).
Параметры <ИмяТипа>, <Длина> и <Точность> следует указывать при установке значения периодического реквизита справочника имеющего неопределенный тип.
Данный метод доступен только в контексте Модуля документа в предопределенной процедуре ОбработкаПроведения (см. Гл. «Системные предопределенные процедуры»).
Пример:
// при работе в контексте документа, его реквизит "Сотрудник"
// является переменной типа "справочник",
// чтобы установить новое значение периодического
// реквизита "Оклад" этого элемента
// справочника с привязкой к документу
Процедура ОбработкаПроведения();
// .....
Моклад = Константа.МаксимальныйОклад;
УстановитьРеквизитСправочника(Сотрудник, "Оклад", МОклад, ДатаДок);
// .....
КонецПроцедуры