Как исправить ошибку «Индекс находится за границами массива» при печати формы «Прием на работу» в 1С:ЗУП

← На главную

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

Суть проблемы и механизм возникновения ошибки

Ошибка Индекс находится за границами массива во время выполнения длительной операции печати обычно означает, что программный код пытается обратиться к элементу коллекции (массиву), которого не существует. В контексте печати в 1С:ЗУП это чаще всего происходит так: программа выполняет запрос к базе данных, чтобы собрать сведения о сотруднике, его окладе, паспортных данных и адресе. Если запрос по какой-то причине возвращает пустой результат, массив данных остается пустым. Когда код пытается извлечь из него первую строку (например, через Результат[0]), программа аварийно завершается.

Рассмотрим пошагово, как диагностировать и устранить эту проблему.

Шаг 1. Использование отладчика и остановка по ошибке

Первым делом нам необходимо понять, в каком именно месте происходит сбой. Для этого нам потребуется запустить 1С:Предприятие в режиме отладки из Конфигуратора.

Откроем Конфигуратор и перейдем в меню Отладка — Настройка остановки по ошибке.
В появившемся окне нажмем кнопку Добавить и выберем тип исключения (или просто установим флаг «Останавливаться по всем ошибкам»).
Запустим сеанс пользователя (F5), откроем проблемный документ «Прием на работу» и нажмем кнопку печати.

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

Шаг 2. Поиск пустого массива в модуле объекта

Как правило, проблема кроется во внешней печатной форме или в логике формирования данных в модуле менеджера документа. Нам нужно найти функцию, которая собирает данные для макета. Рассмотрим примерный участок кода, который часто становится источником ошибки:


// Пример проблемного участка
МассивДанныхЗаполнения = СформироватьЗапросПоСотруднику(ПараметрыПечати);
// Ошибка происходит здесь, если МассивДанныхЗаполнения пуст
ДанныеСотрудника = МассивДанныхЗаполнения[0];

Чтобы программа не «вылетала», необходимо добавить проверку на заполненность коллекции. Разберем, как это реализовать правильно:


МассивДанныхЗаполнения = СформироватьЗапросПоСотруднику(ПараметрыПечати);

Если МассивДанныхЗаполнения.Количество() = 0 Тогда
    ТекстОшибки = "Не удалось получить данные для печати по сотруднику. 
                  |Возможно, не заполнены обязательные реквизиты (адрес, паспорт или ИНН).";
    ОбщегоНазначенияКлиентСервер.СообщитьПользователю(ТекстОшибки);
    Возврат;
КонецЕсли;

ДанныеСотрудника = МассивДанныхЗаполнения[0];

Шаг 3. Анализ запроса через консоль

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

Почему запрос может возвращать 0 строк для одного сотрудника?

Внутренние соединения (Inner Join): В запросе могут использоваться связи таблиц по сотруднику, физическому лицу и его контактной информации. Если у сотрудника не заполнен, например, Адрес регистрации, а в запросе стоит ВНУТРЕННЕЕ СОЕДИНЕНИЕ с таблицей адресов, то вся строка данных исчезнет из результата.
Паспортные данные: Проверьте, заполнена ли серия, номер и дата выдачи паспорта. Часто внешние формы требуют наличия этих данных «жестко».
Склонение ФИО: Если в форме используется функция склонения имен, и ФИО содержит некорректные символы, компонент склонения может вернуть ошибку, которая прервет выполнение запроса.
Дата актуальности: Проанализируем дату документа. Если запись в регистре сведений (например, о плановых начислениях) сделана позже, чем дата самого документа приема, запрос на дату документа вернет пустоту.

Шаг 4. Проверка прав доступа (RLS)

Иногда причина кроется не в данных, а в правах пользователя. Если у бухгалтера включены ограничения на уровне записей (RLS), он может видеть документ приема, но не иметь прав на чтение данных физического лица (его личных сведений). В этом случае запрос, запущенный от имени такого пользователя, вернет пустой результат, что приведет к ошибке индекса массива.

Выясним это, попробовав сформировать ту же печатную форму под пользователем с полными правами. Если под администратором все работает — проблема в настройках прав доступа.

Шаг 5. Работа с внешними печатными формами

Если вы используете Внешнюю печатную форму (ВПФ), алгоритм действий будет следующим:

Выгрузим ВПФ из справочника «Дополнительные отчеты и обработки» в файл .epf.
Откроем этот файл в Конфигураторе.
Найдем в модуле объекта процедуру Печать или функцию СформироватьПечатнуюФорму.
Проанализируем формирование таблицы или массива данных. Посмотрим, какие параметры передаются в запрос.

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


// Безопасный метод получения структуры данных
ДанныеДляВывода = Новый Структура;
Если ТипЗнч(РезультатЗапроса) = Тип("ТаблицаЗначений") И РезультатЗапроса.Количество() > 0 Тогда
    ДанныеДляВывода = РезультатЗапроса[0];
КонецЕсли;

// Дальнейшая работа через проверку ЗначениеЗаполнено()
Если ЗначениеЗаполнено(ДанныеДляВывода) Тогда
    // Заполняем параметры макета
Иначе
    // Выводим предупреждение
КонецЕсли;