Как исправить ошибку «Индекс находится за границами массива» при работе с таблицами в 1С

← На главную

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

Причина ошибки: Индекс против Идентификатора

Первое и самое важное, что нам необходимо усвоить: в управляемых формах 1С у строки таблицы есть две разные характеристики, которые часто путают. Рассмотрим их подробнее:

Идентификатор строки (ID): Это уникальное числовое значение, которое присваивается строке в момент её создания. Оно остается неизменным до тех пор, пока строка не будет удалена из коллекции. Именно идентификатор передается в параметры событий, таких как Выбор (параметр ВыбраннаяСтрока).
Индекс строки: Это порядковый номер строки в массиве данных (начиная с 0). Индекс — величина динамическая. Если вы удалите первую строку (индекс 0), то вторая строка автоматически получит индекс 0.

Ошибка «Индекс находится за границами массива» возникает тогда, когда мы пытаемся обратиться к коллекции РеестрКонтрактов[Значение], передавая в квадратных скобках Идентификатор вместо Индекса. Если идентификатор равен, например, 10, а в таблице всего 5 строк (индексы от 0 до 4), система закономерно выдаст ошибку, так как строки с индексом 10 не существует.

Проблема после очистки таблицы

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

Рассмотрим ситуацию, когда в обработчике события выбор используется старый подход:


&НаКлиенте
Процедура РеестрКонтрактовВыбор(Элемент, ВыбраннаяСтрока, Поле, СтандартнаяОбработка)
    // ОШИБКА: ВыбраннаяСтрока — это ID, а не индекс!
    ЗначениеНомерЗакупки = РеестрКонтрактов[ВыбраннаяСтрока].НомерЗакупки; 
КонецПроцедуры

Этот код будет работать только до тех пор, пока идентификаторы случайно совпадают с индексами. Как только вы удалите строку или очистите таблицу, программа «упадет».

Правильное решение: Метод НайтиПоИдентификатору()

Для безопасного получения данных строки в управляемых формах необходимо использовать специальный метод коллекции — НайтиПоИдентификатору(). Проанализируем правильный алгоритм работы:


&НаКлиенте
Процедура РеестрКонтрактовВыбор(Элемент, ВыбраннаяСтрока, Поле, СтандартнаяОбработка)
    СтандартнаяОбработка = Ложь;
    
    // Получаем объект строки по его уникальному ID
    ТекущаяСтрока = РеестрКонтрактов.НайтиПоИдентификатору(ВыбраннаяСтрока);
    
    // Обязательно проверяем, найдена ли строка (могла быть удалена другим процессом)
    Если ТекущаяСтрока <> Неопределено Тогда
        ЗначениеНомерЗакупки = ТекущаяСтрока.НомерЗакупки;
        // Дальнейшая логика обработки
        ОбновитьДанныеПоЗакупке(ЗначениеНомерЗакупки);
    КонецЕсли;
КонецПроцедуры

Этот метод гарантирует, что мы обращаемся к конкретному объекту данных, а не к «ячейке памяти» по случайному номеру.

Альтернативный подход: Использование ТекущихДанных

Часто программисты пытаются вручную вычислять строки, хотя платформа уже предоставляет готовый механизм. Посмотрим на объект Элементы.ИмяТаблицы.ТекущиеДанные. Этот метод возвращает объект строки, на которой в данный момент установлен курсор. Это избавляет от необходимости работать с идентификаторами в принципе.


&НаКлиенте
Функция ПолучитьДанныеВыбраннойСтроки()
    ТекДанные = Элементы.РеестрКонтрактов.ТекущиеДанные;
    Если ТекДанные = Неопределено Тогда
        Возврат Неопределено;
    КонецЕсли;
    Возврат ТекДанные;
КонецФункции

Важный момент: Если вы очистили таблицу программно, ТекущиеДанные станут равны Неопределено. Всегда делайте проверку перед обращением к свойствам (колонкам).

Удаление строк и несоответствие типов

В процессе обсуждения возникла еще одна ошибка: «Несоответствие типов (параметр 1)» при вызове метода Удалить(). Выясним причину. Метод Удалить() у коллекции ДанныеФормыКоллекция может принимать либо Индекс (число), либо Объект строки.

Если вы попытаетесь передать туда строковое значение (например, номер закупки "12345"), система выдаст ошибку. Рассмотрим правильный способ удаления конкретной строки на сервере:


&НаСервере
Процедура УдалитьСтрокуПоНомеру(НомерЗакупки)
    // 1. Сначала находим саму строку в коллекции
    ПараметрыПоиска = Новый Структура("НомерЗакупки", НомерЗакупки);
    НайденныеСтроки = РеестрКонтрактов.НайтиСтроки(ПараметрыПоиска);
    
    // 2. Если строка найдена, удаляем именно этот ОБЪЕКТ
    Для Каждого СтрокаДляУдаления Из НайденныеСтроки Цикл
        РеестрКонтрактов.Удалить(СтрокаДляУдаления);
    КонецЦикла;
КонецПроцедуры

Как правильно обновлять таблицу без потери позиции

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

Запоминаем идентификатор или ключевое поле текущей строки.
Выполняем запрос к базе данных.
Вместо прямой очистки используем временную таблицу значений и метод ЗначениеВРеквизитФормы.
После обновления ищем строку с сохраненным ключом и устанавливаем на нее ТекущаяСтрока.

Такой подход исключает возникновение ошибок обращения к несуществующим индексам, так как данные обновляются целиком на уровне платформенных механизмов.

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