Как правильно программно оформить массовый кадровый перевод сотрудников в 1С:ЗУП 8.3?

← К списку

Мы с вами сталкиваемся с распространенной задачей – необходимостью программно оформить кадровые переводы для большого количества сотрудников в системе 1С:ЗУП 8.3. На первый взгляд может показаться логичным использовать документ `КадровыйПереводСписком`, который предназначен для массовых операций. Однако, как показывает практика и опыт специалистов, при программной работе с такими документами возникают определенные сложности и риски. Давайте вместе разберем эту ситуацию, проанализируем причины, по которым не рекомендуется программное использование списочных документов, и рассмотрим наиболее надежные и управляемые решения.

Почему не стоит использовать документ «Кадровый перевод списком» программно?

Документ `КадровыйПереводСписком` в 1С:ЗУП 8.3 действительно существует и предназначен для удобства массового оформления кадровых перемещений сотрудников. Он позволяет одновременно переводить нескольких сотрудников, изменяя их подразделение, должность, график работы и другие параметры. Однако его основное предназначение – это **ручной ввод** данных. Когда мы пытаемся автоматизировать создание такого документа, сталкиваемся со следующими проблемами:

Сложность программной обработки табличной части: Программное заполнение списочного документа требует тщательной и сложной обработки данных для каждого сотрудника в его табличной части. Это увеличивает вероятность ошибок, особенно если требуется установить специфические параметры для каждого сотрудника.
Трудности отладки и исправления ошибок: В случае возникновения ошибок или необходимости корректировки данных по отдельным сотрудникам, работать со списочным документом становится крайне неудобно. Представьте, что из ста переведенных сотрудников у двух возникли проблемы. Придется либо перепроводить весь документ, затрагивая всех остальных сотрудников, либо пытаться точечно изменить данные в табличной части, что может привести к еще большим проблемам. При использовании индивидуальных документов мы можем легко перепровести или исправить конкретный документ, не затрагивая других.
Потенциальные «баги» и непредсказуемое поведение: Как отмечают опытные разработчики, программная работа со списочными формами часто оказывается более тяжелой для восприятия кодом и может приводить к появлению неочевидных ошибок, которые сложно отловить и исправить в дальнейшем.
Проблемы с перепроведением: При изменении конфигурации или возникновении необходимости перепроведения документов за прошлые периоды, индивидуальные документы `КадровыйПеревод` гораздо удобнее. Мы можем выборочно перепровести только те документы, которые требуют обновления движений, минимизируя нагрузку на систему и риски некорректных изменений для других сотрудников.

Таким образом, хотя документ `КадровыйПереводСписком` существует для удобства ручного ввода массовых операций, при программной реализации массовых кадровых переводов более надежным и управляемым подходом является создание отдельных документов `КадровыйПеревод` для каждого сотрудника.

Решение: Программное создание индивидуальных документов «Кадровый перевод»

Наиболее надежный и рекомендуемый подход при программном оформлении массовых кадровых переводов — это создание отдельного документа `КадровыйПеревод` для каждого сотрудника. Этот метод обеспечивает максимальную гибкость, упрощает поддержку, отладку и снижает риски возникновения ошибок в долгосрочной перспективе. Давайте разберем этот процесс по шагам:

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

Инициализация нового документа «Кадровый перевод»: Для каждого сотрудника из нашего списка мы будем создавать новый экземпляр документа `КадровыйПеревод`. Мы используем стандартные методы платформы 1С для работы с объектами метаданных.


НовыйКадровыйПеревод = Документы.КадровыйПеревод.СоздатьДокумент();
НовыйКадровыйПеревод.Дата = ТекущаяДата(); // Или любая другая дата перевода
НовыйКадровыйПеревод.Организация = ВашаОрганизация; // Ссылка на элемент справочника "Организации"
НовыйКадровыйПеревод.Ответственный = Пользователи.ТекущийПользователь(); // Или конкретный пользователь
НовыйКадровыйПеревод.Комментарий = "Программный кадровый перевод (массовый)";

Заполнение основных реквизитов сотрудника: Каждый документ `КадровыйПеревод` предназначен для одного сотрудника. Поэтому нам необходимо установить ссылку на этого сотрудника.
```
// Предположим, что у нас есть переменная СотрудникСсылка,
// содержащая ссылку на элемент справочника "Сотрудники"
НовыйКадровыйПеревод.Сотрудник = СотрудникСсылка;
```
Если в системе 1С:ЗУП используется механизм «Кадровый учет по нескольким рабочим местам», то возможно потребуется заполнить реквизит `ФизическоеЛицо` и `РабочееМесто` (если применимо).

Заполнение новых условий труда: Это ключевой шаг, где мы указываем, какие именно параметры сотрудника изменяются. Документ `КадровыйПеревод` имеет множество реквизитов и табличных частей для этого. Рассмотрим основные:

Подразделение и Должность:


НовыйКадровыйПеревод.Подразделение = НовоеПодразделениеСсылка; // Ссылка на элемент справочника "ПодразделенияОрганизаций"
НовыйКадровыйПеревод.Должность = НоваяДолжностьСсылка; // Ссылка на элемент справочника "Должности"

График работы:


НовыйКадровыйПеревод.ГрафикРаботы = НовыйГрафикРаботыСсылка; // Ссылка на элемент справочника "ГрафикиРаботы"

Вид занятости:


// Например, для основного места работы:
НовыйКадровыйПеревод.ВидЗанятости = Перечисления.ВидыЗанятости.ОсновноеМестоРаботы;
// Или для внешнего совместительства:
// НовыйКадровыйПеревод.ВидЗанятости = Перечисления.ВидыЗанятости.ВнешнееСовместительство;

Изменение плановых начислений: Если при переводе меняется оклад, надбавки или другие плановые начисления, необходимо заполнить табличную часть `Начисления`. Для этого мы сначала очищаем ее, а затем добавляем новые строки с актуальными начислениями.
```
НовыйКадровыйПеревод.Начисления.Очистить();
НоваяСтрокаНачисления = НовыйКадровыйПеревод.Начисления.Добавить();
НоваяСтрокаНачисления.ВидРасчета = ПланыВидовРасчета.Начисления.ОкладПоДням; // Ссылка на элемент ПВР
НоваяСтрокаНачисления.Показатель1 = 50000; // Например, сумма оклада
// Могут быть и другие показатели в зависимости от вида расчета
```
Важно помнить, что если вид начисления не меняется, но меняется его размер, то необходимо сначала **завершить** старое начисление, а затем **назначить** новое. Это делается через свойства строки табличной части `Начисления` (`ДействуетДо` и `ДействуетС`).

Изменение отпусков: Если при переводе изменяется право на отпуск (например, количество дней ежегодного отпуска), то это также отражается в документе.


// Пример заполнения табличной части отпусков (если требуется)
// НовыйКадровыйПеревод.Отпуска.Очистить();
// НоваяСтрокаОтпуска = НовыйКадровыйПеревод.Отпуска.Добавить();
// НоваяСтрокаОтпуска.ВидЕжегодногоОтпуска = Справочники.ВидыОтпусков.ЕжегодныйОсновной;
// НоваяСтрокаОтпуска.КоличествоДней = 28;

Запись и проведение документа: После заполнения всех необходимых реквизитов и табличных частей, документ необходимо записать и провести. Метод `Записать()` сохраняет данные, а `Записать(РежимЗаписиДокумента.Проведение)` записывает и проводит документ, формируя его движения.


Попытка
    НовыйКадровыйПеревод.Записать(РежимЗаписиДокумента.Проведение);
    Сообщить("Кадровый перевод для сотрудника " + СотрудникСсылка.Наименование + " успешно проведен.");
Исключение Э
    Сообщить("Ошибка проведения кадрового перевода для сотрудника " + СотрудникСсылка.Наименование + ": " + Э.Описание);
КонецПопытки;

Таким образом, мы будем выполнять шаги 2-5 в цикле для каждого сотрудника. Это обеспечивает чистоту кода, простоту отладки и высокую надежность.


// Пример общего алгоритма в цикле
Для Каждого СтрокаДанныхСотрудника Из СписокДанныхДляПеревода Цикл

    // Получаем ссылку на сотрудника
    СотрудникСсылка = СтрокаДанныхСотрудника.Сотрудник; // Предполагается, что в СтрокаДанныхСотрудника есть поле Сотрудник

    // Проверяем, что сотрудник найден
    Если СотрудникСсылка = Неопределено Тогда
        Сообщить("Не найден сотрудник по данным: " + СтрокаДанныхСотрудника.Представление, СтатусСообщения.Внимание);
        Продолжить;
    КонецЕсли;

    // 1. Создаем новый документ "Кадровый перевод"
    НовыйКадровыйПеревод = Документы.КадровыйПеревод.СоздатьДокумент();
    НовыйКадровыйПеревод.Дата = СтрокаДанныхСотрудника.ДатаПеревода;
    НовыйКадровыйПеревод.Организация = СтрокаДанныхСотрудника.Организация;
    НовыйКадровыйПеревод.Сотрудник = СотрудникСсылка;
    НовыйКадровыйПеревод.Ответственный = Пользователи.ТекущийПользователь();
    НовыйКадровыйПеревод.Комментарий = "Программный кадровый перевод";

    // 2. Заполняем новые параметры (пример)
    Если СтрокаДанныхСотрудника.НовоеПодразделение <> Неопределено Тогда
        НовыйКадровыйПеревод.Подразделение = СтрокаДанныхСотрудника.НовоеПодразделение;
    КонецЕсли;

    Если СтрокаДанныхСотрудника.НоваяДолжность <> Неопределено Тогда
        НовыйКадровыйПеревод.Должность = СтрокаДанныхСотрудника.НоваяДолжность;
    КонецЕсли;

    Если СтрокаДанныхСотрудника.НовыйГрафикРаботы <> Неопределено Тогда
        НовыйКадровыйПеревод.ГрафикРаботы = СтрокаДанныхСотрудника.НовыйГрафикРаботы;
    КонецЕсли;

    // Заполнение начислений (более сложный пример, может потребовать анализа текущих начислений)
    // Здесь упрощенный пример: всегда назначаем оклад
    НовыйКадровыйПеревод.Начисления.Очистить();
    НоваяСтрокаНачисления = НовыйКадровыйПеревод.Начисления.Добавить();
    НоваяСтрокаНачисления.ВидРасчета = ПланыВидовРасчета.Начисления.ОкладПоДням;
    НоваяСтрокаНачисления.Показатель1 = СтрокаДанныхСотрудника.НовыйОклад; // Сумма оклада
    НоваяСтрокаНачисления.ДействуетС = СтрокаДанныхСотрудника.ДатаПеревода;
    НоваяСтрокаНачисления.ДействуетДо = '00010101'; // Без даты окончания, если постоянно

    // 3. Записываем и проводим документ
    Попытка
        НовыйКадровыйПеревод.Записать(РежимЗаписиДокумента.Проведение);
        Сообщить("Успешно проведен кадровый перевод для: " + СотрудникСсылка.Наименование);
    Исключение Э
        Сообщить("Ошибка проведения кадрового перевода для " + СотрудникСсылка.Наименование + ": " + Э.Описание, СтатусСообщения.Ошибка);
    КонецПопытки;

КонецЦикла;

Альтернативные специализированные документы для массовых изменений

Помимо общего документа `КадровыйПеревод`, в 1С:ЗУП существуют более специализированные документы для массовых изменений определенных параметров. Использование этих документов при программной работе может быть более целесообразным, так как они ориентированы на конкретный тип изменений и зачастую имеют более простую структуру для программного заполнения. Рассмотрим некоторые из них:

«Перемещение в другое подразделение»: Если задача заключается исключительно в массовом переводе сотрудников между подразделениями, этот документ может быть более подходящим. Он фокусируется только на изменении подразделения и, возможно, должности в новом подразделении.
«Изменение графика работы списком»: Для массового изменения графиков работы сотрудников предусмотрен отдельный документ. Его программное заполнение будет значительно проще, если вам нужно изменить только график, не затрагивая другие параметры кадрового перевода.
«Изменение плановых начислений»: Если при переводе меняются только плановые начисления (например, оклады или надбавки), то можно использовать этот документ. Он позволяет массово изменить размеры существующих начислений или назначить новые.

Мы рекомендуем проанализировать вашу конкретную задачу. Если массовый перевод подразумевает изменение только одного или двух параметров для всех сотрудников, возможно, использование одного из этих специализированных документов будет более эффективным и менее трудоемким с точки зрения программной реализации. Однако, если требуется комплексное изменение многих параметров (подразделение, должность, график, начисления, отпуска), то создание индивидуальных документов `КадровыйПеревод` остается наиболее универсальным и надежным решением.

Заключение

Мы выяснили, что хотя в 1С:ЗУП 8.3 существует документ `КадровыйПереводСписком`, его программное использование сопряжено с рядом трудностей. Наиболее надежным, гибким и удобным для поддержки подходом является **создание отдельных документов `КадровыйПеревод` для каждого сотрудника в цикле**. Этот метод позволяет точно контролировать все параметры перевода, упрощает отладку и минимизирует риски ошибок. Кроме того, мы рассмотрели возможность использования специализированных документов для массовых изменений, если ваша задача ограничивается одним-двумя типами кадровых перемещений.

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

← К списку