Как исправить ошибку «Получение элемента по индексу для значения не определено» в 1С:Конвертация данных?

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

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

Техническая природа ошибки

С точки зрения платформы «1С:Предприятие», данная ошибка означает, что в коде происходит обращение вида Объект["ИмяСвойства"] или Объект.ИмяСвойства, но переменная Объект не является структурой, соответствием или иным коллекционным типом. В контексте правил обмена (ПКО, ПКС, ПВД) это чаще всего случается, когда движок конвертации ожидает получить структуру ВходящиеДанные или ИсходящиеДанные, но вместо неё получает пустое значение.

Рассмотрим основные сценарии, в которых возникает этот сбой, и способы их устранения.

Решение 1: Синхронизация структуры ИсходящиеДанные и ПКС

Типичная ситуация: вы используете Правило выгрузки данных (ПВД) с произвольным алгоритмом. Вы формируете запрос, обходите выборку и пытаетесь передать данные в правило конвертации объектов (ПКО) через структуру ИсходящиеДанные. Проанализируем пример кода, который может привести к ошибке:

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Ссылка, Код, Наименование ИЗ Справочник.Номенклатура";
Выборка = Запрос.Выполнить.Выбрать();

Пока Выборка.Следующий() Цикл
    ИсходящиеДанные = Новый Структура;
    ИсходящиеДанные.Вставить("Артикул", Выборка.Код);
    ИсходящиеДанные.Вставить("НаименованиеПолное", Выборка.Наименование);
    
    ВыгрузитьПоПравилу(,, ИсходящиеДанные,, "Номенклатура");
КонецЦикла;

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

1. В каждом Правиле конвертации свойства (ПКС), которое должно заполниться из вашей структуры, необходимо установить флаг «Получать из входящих данных».
2. Имена ключей в структуре ИсходящиеДанные (например, "Артикул") должны символ в символ совпадать с именами свойств Источника в настройках ПКС. Если источник в ПКС пустой, движок будет искать соответствие по имени свойства приемника.
3. Если вы используете поиск по этим полям, убедитесь, что все поля поиска переданы в структуре. Если хотя бы одно поле поиска будет отсутствовать, система вернет Неопределено при попытке обращения к нему, что и вызовет ошибку индексации.

Решение 2: Использование переменной Значение в обработчиках ПКС

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

Алгоритм действий следующий:

1. Создаем ПКО для нужного справочника (например, «Маршруты»). Источник и Приемник оставляем пустыми, если структуры баз сильно различаются.
2. Внутри этого ПКО создаем ПКС для поля, по которому будет идти поиск (например, «Код» или «Наименование»). У этого ПКС оставляем источник пустым, но ставим флаг «Поиск».
3. В ПКО основного объекта (например, Документа) находим ПКС нужного реквизита и в обработчике «Перед выгрузкой» пишем код, формирующий структуру поиска:

// В обработчике ПКС "Перед выгрузкой"
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ ЗначениеИзРегистра ИЗ РегистрСведений.Синхронизация ГДЕ Объект = &ТекущийОбъект";
Запрос.УстановитьПараметр("ТекущийОбъект", Источник.Ссылка);
Выборка = Запрос.Выполнить.Выбрать();

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

В этом случае переменная Значение сама становится структурой параметров для поиска. Система подхватит эти данные и не будет пытаться обращаться к свойствам объекта-источника, что предотвратит падение с ошибкой индексации.

Решение 3: Отладка через модуль отладки выгрузки

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

Разобраться помогут следующие шаги:

1. Откройте обработку выгрузки в режиме «1С:Предприятие».
2. На вкладке «Дополнительные настройки» найдите возможность выгрузки модуля отладки.
3. Сформируйте и сохраните модуль (внешний файл .txt или .epf).
4. Загрузите этот код в конфигуратор.
5. Найдите строку, указанную в тексте ошибки (например, в районе функции ПолучитьСвойстваСамостоятельно или в процедурах обработки ПКС).
6. Установите точку останова.

При остановке системы посмотрите на переменную, к которой идет обращение в квадратных скобках []. Если она равна Неопределено, посмотрите вверх по стеку вызовов: какой обработчик (ПВД или ПКС) передал данные в таком виде. Чаще всего выясняется, что структура ВходящиеДанные просто не была инициализирована из-за невыполненного условия Если или неудачного запроса.

Рекомендации для стабильной работы правил

Чтобы минимизировать появление ошибок индексации, придерживайтесь следующих принципов при проектировании обмена в КД 2.0:

Проверка инициализации: Всегда проверяйте, что структура создана, прежде чем вставлять в неё ключи. Используйте конструкцию:

Если ИсходящиеДанные = Неопределено Тогда
    ИсходящиеДанные = Новый Структура;
КонецЕсли;

Контроль типов в запросах: Если данные для структуры ИсходящиеДанные берутся из запроса, убедитесь, что запрос не возвращает NULL. Движок конвертации при попытке сопоставить NULL из структуры со ссылочным типом приемника может повести себя непредсказуемо.

Очистка коллекции: В циклах ПВД всегда пересоздавайте структуру ИсходящиеДанные = Новый Структура; на каждой итерации. Это гарантирует, что данные от предыдущего объекта не «просочатся» в следующий, вызывая логические ошибки сопоставления.

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