Программное добавление реквизитов в справочник «Штатное расписание»

В данной статье рассмотрено программное добавление реквизитов в справочник «Штатное расписание» при включенной и выключенной настройке «Ведется история изменения штатного расписания». Все примеры приведены на демонстрационной базе конфигурации 1С:ЗУП, релиз 3.1.31.67.

Настройка «Ведется история изменения штатного расписания» отключена

Сначала рассмотрим добавление реквизита без ведения истории изменений штатного расписания. Добавим новый строковый реквизит «НР_КатегорияДолжности» в справочник «Штатное расписание»:

Данный реквизит будем выводить в конец левой колонки на форме элемента справочника «Штатное расписание»:

Добавим программно реквизит на форму элемента справочника «Штатное расписание»:

На форме появится новый реквизит. После нажатия на кнопку «Записать» его значение сохранится для объекта.

Настройка «Ведется история изменения штатного расписания» включена

Рассмотрим второй случай. При включенной настройке справочник «Штатное расписание» изменяется с помощью документов «Изменение штатного расписания» и «Утверждение штатного расписания». Соответственно добавленный реквизит не должен быть доступен к редактированию из формы элемента справочника «Штатное расписание». Для этого установим для элемента формы свойство «Только просмотр» в значение «Истина»:

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

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

Добавим созданный реквизит на форму документа:

Редактирование позиций штатного расписания выполняется не в форме документа, а в общей форме «ФормаСтрокиДокументаИзмененияШтатногоРасписания», которая открывается при нажатии на любую область строки в форме документа «Изменение штатного расписания». Поэтому для добавленного элемента формы необходимо установить свойство «Только просмотр» в значение «Истина». В противном случае может возникнуть ситуация, при которой пользователь откроет форму изменения позиции штатного расписания, нажав на область, содержащую новый реквизит:

В таком случае после закрытия формы изменения позиции штатного расписания данная область станет активной для редактирования.

Как было описано выше, изменения позиции происходят в общей форме «ФормаСтрокиДокументаИзмененияШтатногоРасписания». Поэтому на нее  необходимо добавить новый элемент:

Попробуем изменить категорию должности:

После закрытия формы «ФормаСтрокиДокументаИзмененияШтатногоРасписания» категория должности осталась пустой:

Чтобы в строке позиции отображался новый реквизит, необходимо изменить структуру штатного расписания в функции «ОписаниеПозицииштатногоРасписания» общего модуля «УправлениеШтатнымРасписанием»:

Теперь строка позиции штатного расписания заполняется корректно:

Но после проведения документа добавленный реквизит в элементе справочника «Штатное расписание» по-прежнему остается пустым.

Проблема заключается в том, что данные не были зарегистрированы к изменению. Регистрация изменений производится в модуле менеджера регистра сведений «ИсторияИспользованияШтатногоРасписания». Соответственно, для начала реквизит необходимо добавить в данный регистр:

Теперь нужно доработать запрос перед его выполнением в процедуре «ОбновитьТекущиеСведенияПозицииШтатногоРасписания» модуля менеджера.

Установим категорию должности для позиции штатного расписания и проведем документ изменения штатного расписания:

Откроем элемент справочника «Штатное расписание», категория должности не заполнилась:

Аналогично категория не подтягивается при следующем создании документа «Изменение штатного расписания»:

Выведем категорию должности с помощью обработки «Консоль запросов» для позиции штатного расписания, изменяемой в документе:

Получается, что реквизит объекта записан корректно, но при отображении на формах не заполняется. Так происходит, потому что данные для отображения получаются не на прямую из объекта, а с помощью запроса. Доработаем запрос в функции «ЗапросВТШтатноеРасписание» общего модуля «УправлениеШтатнымРасписанием»:

Теперь категория должности будет отображается корректно:

Аналогично при создании нового документа «Изменения штатного расписания» на форму подтягивается актуальное значение реквизита:

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