Как исправить ошибку «Ошибка внешней компоненты» при формировании штрихкода DataMatrix (ТипКода = 18)?

← На главную

При разработке функционала печати этикеток и маркировки в системе 1С:Предприятие часто возникает неприятная ситуация: механизм формирования штрихкодов, который стабильно работал долгое время, внезапно начинает выдавать ошибку. Особенно часто это проявляется при работе с форматом DataMatrix (соответствующему значению ТипКода = 18). Проблема носит «плавающий» характер — ошибка может возникать не при каждом вызове, но если она появилась на одном клиентском месте, то часто распространяется на все сеансы в рамках одного рабочего процесса сервера.

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

Анализ причин возникновения ошибки

Прежде чем переходить к коду, давайте выясним причину сбоя. Внешняя компонента (обычно это 1CBarCode.dll или её аналоги из БСП) представляет собой программный модуль, который загружается в адресное пространство процесса. Если формирование штрихкода происходит на стороне сервера, компонента живет внутри процесса rphost. Рассмотрим основные факторы, приводящие к ошибке:

Утечки памяти и дефрагментация: При длительной работе сервера 1С без перезапуска рабочие процессы накапливают ошибки в управлении памятью. Это особенно актуально для x64-систем, где взаимодействие с 32-битной компонентой через обертки может быть нестабильным.
Лимиты GDI (Graphics Device Interface): Компонента печати штрихкодов активно использует графическую подсистему Windows для отрисовки изображения. В серверных операционных системах существуют жесткие лимиты на количество одновременно открытых дескрипторов GDI. Когда лимит исчерпан, любая попытка изменить свойства компоненты (например, ТипКода), инициирующая перерисовку объекта, вызывает отказ.
Особенности платформы 8.3.13: Данная версия платформы имеет известные проблемы с изоляцией внешних компонент. В более поздних релизах механизмы работы с Native API были существенно доработаны.
Состояние объекта: Иногда компонента «зависает» в состоянии ошибки, если в неё сначала передали некорректные данные, а затем попытались сменить тип штрихкода.

Способ 1. Программный обход через переподключение компоненты

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


Процедура СформироватьШтрихкодНаСервере(ПараметрыШтрихкода)
    
    Попытка
        // Пытаемся установить тип кода
        ВнешняяКомпонента.ТипКода = ПараметрыШтрихкода.ТипКода;
    Исключение
        // Если произошла ошибка, пробуем переподключить компоненту
        ЗаписьЖурналаРегистрации("ПечатьШтрихкода", УровеньЖурналаРегистрации.Предупреждение, , , 
            "Произошла ошибка внешней компоненты. Выполняется повторная загрузка.");
            
        // Принудительно обнуляем объект, чтобы освободить ресурсы
        ВнешняяКомпонента = Неопределено;
        
        // Вызываем типовой метод БСП для подключения (или ваш метод загрузки)
        РезультатПодключения = ПодключитьВнешнююКомпонентуПечатиШтрихкода();
        
        Если РезультатПодключения Тогда
            // Повторная попытка после переподключения
            Попытка
                ВнешняяКомпонента.ТипКода = ПараметрыШтрихкода.ТипКода;
            Исключение
                ВызватьИсключение "Не удалось установить ТипКода даже после перезагрузки компоненты.";
            КонецПопытки;
        КонецЕсли;
    КонецПопытки;

    // Продолжаем установку остальных параметров (Текст, Ширина, Высота)
    ВнешняяКомпонента.Текст = ПараметрыШтрихкода.Текст;
    
КонецПроцедуры

Важный момент: Обратите внимание, что мы устанавливаем ВнешняяКомпонента = Неопределено;. Это критически важно для того, чтобы сборщик мусора и система управления памятью попытались выгрузить сбойный экземпляр библиотеки.

Способ 2. Изменение порядка инициализации параметров

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

Создание/Подключение объекта компоненты.
Установка Типа кода (свойство ТипКода).
Установка параметров отображения (прозрачность, шрифт, ориентация).
Передача Данных (свойство Текст).

Если передать Текст штрихкода до установки ТипКода, компонента может попытаться провалидировать строку по старому алгоритму (например, как EAN13), войти в режим ошибки и не позволить сменить тип на DataMatrix.

Способ 3. Настройка серверной части (Администрирование)

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

Перезапуск рабочих процессов: В настройках локального кластера установите параметр Выключать процессы через (например, 86400 секунд — раз в сутки) или настройте Допустимый объем памяти. Это заставит сервер создавать новые «чистые» процессы rphost, что предотвратит накопление ошибок GDI и дефрагментацию памяти.
Очистка временных файлов: Внешние компоненты при подключении распаковываются в папку временных файлов пользователя, под которым запущен сервер 1С (обычно USR1CV8). Убедитесь, что эта папка не переполнена и у пользователя есть полные права на чтение/запись в каталоге %TEMP% на сервере.

Способ 4. Переход на Native API

Выясним причину использования конкретной версии компоненты. Если ваша конфигурация использует старый метод через COM-объект (например, ActiveX компоненту), это будет постоянным источником проблем на x64 серверах. Мы рекомендуем использовать актуальную версию компоненты из последних релизов Библиотеки Стандартных Подсистем (БСП), которая работает через технологию Native API.

Проверить это можно в коде инициализации. Современное подключение выглядит примерно так:


Результат = УстановитьВнешнююКомпоненту("ОбщийМакет.КомпонентаПечатиШтрихкодов");
Если Результат Тогда
    ПодключитьВнешнююКомпоненту("ОбщийМакет.КомпонентаПечатиШтрихкодов", "BarCode", ТипВнешнейКомпоненты.Native);
    ОбъектКомпоненты = Новый("AddIn.BarCode.Barcode");
КонецЕсли;

Использование ТипВнешнейКомпоненты.Native гарантирует более стабильную работу в разных операционных средах и отсутствие зависимости от регистрации библиотек в реестре Windows (regsvr32).

Резюме

Для решения проблемы с ошибкой ТипКода = 18 выполните следующие шаги:

Оберните установку параметров в блок Попытка...Исключение с механизмом переподключения.
Убедитесь, что ТипКода устанавливается до того, как в компоненту передается текст штрихкода.
Настройте автоматическую перезагрузку рабочих процессов сервера 1С в консоли администрирования.
По возможности обновите платформу до версии 8.3.15 и выше, где работа с внешней памятью реализована более корректно.

Применяя эти методы в комплексе, вы сможете добиться стабильной печати маркировки и минимизировать простои в работе пользователей.