Описание встроенного языка системы 1С Предприятие


         

УстановитьРеквизит


Установить значение реквизита журнала расчетов для последующей записи.

Синтаксис:

УстановитьРеквизит(<ИмяРеквизита>, <Значение>)

Англоязычный синоним:

SetAttribute

Параметры:



<ИмяРеквизита>

Строка — наименование реквизита журнала расче­тов.

<Значение>

Значение, устанавливаемое для записи в реквизит <ИмяРеквизита>.

Описание:

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

  • ВвестиРасчет;
  • ВвестиРасчетНаОсновании;
  • ЗаписатьРасчет;
  • ЗаписатьРасчетНаОсновании.
  • Во-вторых, при вводе произвольных новых записей журнала расчетов (ме­тоды Новая и Записать).

    В этих двух случаях метод УстановитьРеквизит работает по-разному. В случае, когда метод применяется перед вводом записей при проведении документа, не имеет смысла устанавливать значения для следующих реквизи­тов:

    • Объект,
    • Документ,
    • РодительскийДокумент,
    • ВидРасчета,
    • ДатаНачала,
    • ДатаОкончания,
    • ПервичнаяЗапись.
    • Данные установки игнорируются последующими методами ВвестиРасчет, ЗаписатьРасчет и им подобными. Т. е. при вводе записей журнала этими мето­дами возможна установка только реквизитов журнала, заданных при конфигу­рировании, реквизита Результат и таких признаков записи журнала, как: Рас­считана, Исправлена, Сторно, Фиксирована, Перерасчет.

      В случае, когда метод применяется при вводе записей методами Новая и Записать, в качестве первого параметра <ИмяРеквизита> могут применятся наименования реквититов журнала расчетов, заданные при конфигураировании системы или следующие атрибуты, соответствующие предопределенным рекви­зитам журнала расчетов:

      • Документ
      • РодительскийДокумент
      • Объект
      • ВидРасч
      • ДатаНачала
      • ДатаОкончания
      • Сторно
      • Рассчитана
      • Исправлена
      • Фиксирована
      • Перерасчет
      • ПервичнаяЗапись



      • Результат


      • Внимание! Атрибуты журнала расчетов ПериодДействия и ПериодРегистрации не устанавливаются пользователем. Атрибут ПериодРегистрации при вводе записи принимает значение текущего (установленного в данный момент для журнала расчетов) периода, а атри­бут ПериодДействия соответствует установленным значениям ДатаНачала и ДатаОкончания.

        Замечание. Установленные методом значения используются однократно, при первом же вызове одного из вышеперечисленных методов ввода новых записей журнала расчетов установленные значения «сбрасываются». Для записи нескольких реквизитов необходимо использовать метод несколько раз.

        Пример:

        Процедура ВвестиЗапись(Сотр, ВР, Сумма, Процент)

           ЖЗ = СоздатьОбъект("ЖурналРасчетов.Зарплата");

           // будем записывать несколько реквизитов

           ЖЗ.УстановитьРеквизит("Сторно", 1);

           ЖЗ.УстановитьРеквизит("Рассчитана", 1);

           // введенные записи будут сторнированными и отмеченными

           // как рассчитанные

           ЖЗ.ВвестиРасчет(Сотр, ВР, Нач, Оконч, Сумма*Процент);

        КонецПроцедуры

        См. также: ВвестиРасчет, ЗаписатьРасчет


        Содержание раздела