Как правильно обновить Библиотеку электронных документов (БЭД) в конфигурации 1С

Программист 1С v8.3 (Управляемые формы) IT и автоматизация бизнеса
← На главную

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

Анализ состава дистрибутива и предварительная подготовка

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

  1. 1Cv8.cf — основной файл поставки библиотеки. Важно понимать, что это не самостоятельная база, а донор объектов для вашей конфигурации.
  2. 1Cv8_demo.cf и 1Cv8_demo.dt — демонстрационная конфигурация и база. Это наш главный справочник. Если документация на ИТС еще не обновлена для текущего релиза (например, для версии 1.9), именно в демо-базе мы сможем подсмотреть примеры реализации вызовов и настройки подсистем.
  3. UpdateLED.htm — файл с описанием изменений. Проанализируем его в первую очередь, чтобы выяснить, какие объекты были изменены, какие добавлены, а какие помечены на удаление.

Важный момент: Библиотека электронных документов имеет жесткую зависимость от версии Библиотеки стандартных подсистем (БСП). Перед обновлением БЭД обязательно проверьте совместимость. Если новая версия БЭД требует БСП версии 3.1.9, а у вас установлена 3.1.7, обновление приведет к многочисленным ошибкам компиляции из-за отсутствия необходимых процедур в общих модулях ОбщегоНазначения или СтандартныеПодсистемы. Для быстрой проверки версий встроенных подсистем можно использовать обработку для вывода информации о версиях библиотек.

Процесс сравнения и объединения конфигураций

После проверки системных требований (версия платформы «1С:Предприятие» должна соответствовать указанной в ReadMe.txt, обычно это не ниже 8.3.17 или 8.3.21 для свежих релизов), переходим к работе в Конфигураторе.

Выполним следующие шаги для интеграции кода:

  1. Откроем основную конфигурацию и выберем пункт меню Конфигурация — Сравнить, объединить с конфигурацией из файла.
  2. Выберем файл 1Cv8.cf из поставки новой версии БЭД.
  3. В появившемся окне сравнения необходимо быть предельно внимательными. Если вы ранее вносили изменения в объекты БЭД (кастомизировали логику формирования УПД или механизмы криптографии), убедитесь, что вы не затрете свои правки.
  4. Для стандартных объектов, которые не менялись, рекомендуется использовать режим Взять из конфигурации поставщика.
  5. Обратите внимание на подсистемы. Новые версии (например, переход с 1.8 на 1.9) часто добавляют новые подсистемы, отвечающие за МЧД (машиночитаемые доверенности) и работу с новыми форматами ФНС.

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

Инициализация и первый запуск в режиме Предприятие

Объединение в конфигураторе — это лишь половина дела. Теперь нам нужно зафиксировать изменения в базе данных. Нажмем F7 для обновления конфигурации базы данных. Если система сообщает об изменениях в структуре таблиц (новые реквизиты в справочниках НастройкиЭДО или регистрах сведений), подтверждаем их.

Следующий критический этап — запуск информационной базы в режиме «1С:Предприятие» от имени пользователя с полными правами (Администратор). В этот момент запускаются обработчики обновления данных. Разберем, что происходит «под капотом»:

Система проверяет номер версии БЭД в константах или регистрах сведений и сравнивает его с номером в коде. При несовпадении запускается цикл процедур, которые обновляют форматы электронных документов, пересчитывают кэши и настраивают новые параметры интеграции с сервисом 1С-ЭДО.

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

Работа с кодом и программная инициализация

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


Процедура ПриНачалеРаботыСистемы()
    // Инициализация стандартных подсистем
    СтандартныеПодсистемыКлиент.ПриНачалеРаботыСистемы();
    
    // Специфичные вызовы для БЭД, если они предусмотрены вашей архитектурой
    ИнтеграцияЭДОКлиент.ПриНачалеРаботыСистемы();
КонецПроцедуры

Если после обновления вы видите ошибки при попытке отправить документ через ЭДО, выясним причину. Скорее всего, изменился состав параметров в методах общего модуля ЭлектронныйДокументооборот. Проанализируем демо-базу из комплекта поставки, чтобы увидеть актуальную структуру вызовов API библиотеки. В версии 1.9 особое внимание стоит уделить механизмам работы с МЧД и форматам УПД по приказу № 820.

Особенности перехода на версию БЭД 1.9 и выше

Версия 1.9 принесла значительные архитектурные изменения. Разберем основные моменты, на которые стоит обратить внимание:

В завершение подчеркнем: если документации на ИТС по конкретному минорному релизу недостаточно, всегда обращайтесь к файлу ReadMe.txt в папке установки. Там содержится наиболее актуальная информация о минимальных требованиях к платформе и особенностях внедрения именно этой сборки библиотеки.

← На главную