При автоматизации процессов CI/CD или создании скриптов для развертывания временных баз данных разработчики часто сталкиваются с проблемой: при попытке обновить расширение из хранилища в абсолютно чистой базе 1С выдает ошибку: «Операция не может быть выполнена, так как расширение конфигурации с указанным именем не найдено: ИМЯ_РАСШИРЕНИЯ». Это происходит даже в том случае, если все параметры подключения к хранилищу указаны верно.
В этой статье мы подробно разберем, почему возникает эта ситуация, проанализируем внутреннюю логику работы платформы «1С:Предприятие 8.3» и составим правильный алгоритм действий для успешной загрузки расширений в автоматическом режиме.
Проанализируем ситуацию: когда мы запускаем конфигуратор с параметрами подключения к хранилищу основной конфигурации, платформа понимает, что база является «приемником» и готова наполняться данными. Однако с расширениями ситуация иная. Для того чтобы команда обновления из хранилища отработала, в локальной информационной базе (ИБ) уже должен существовать объект «Расширение» с точно таким же именем, которое указано в параметрах командной строки.
Выясним причину: в новой базе список расширений пуст. Когда мы выполняем команду /ConfigurationRepositoryUpdateCfg -Extension "МоеРасширение", платформа ищет в локальных метаданных запись о расширении с именем МоеРасширение, чтобы понять, к какому именно объекту применить изменения из хранилища. Не найдя объекта, система прерывает выполнение с ошибкой.
Рассмотрим еще одну деталь: часто разработчики путают команды /UpdateDBCfg и /ConfigurationRepositoryUpdateCfg. Первая команда лишь обновляет структуру базы данных на основе уже загруженной конфигурации, а вторая — именно получает данные из репозитория. В пакетном режиме для новой базы нам понадобятся обе команды, выполненные в строгой последовательности.
Для того чтобы система «узнала» расширение, нам нужно предварительно создать его в базе. В интерактивном режиме мы бы нажали кнопку «Добавить» в списке расширений. В пакетном режиме мы можем воспользоваться командой /LoadCfg. Рассмотрим, как это сделать.
Рекомендуется иметь в распоряжении файл .cfe (даже если это пустая «болванка» расширения с нужным именем). Перед тем как обращаться к хранилищу, выполним загрузку этого файла в базу:
1cv8.exe CONFIG /F"C:\Bases\TempDB" /N"Admin" /P"Pass" /LoadCfg "C:\Deploy\MyExtension.cfe" -Extension "Мои_Доработки"
После этой команды в базе появится объект метаданных расширения, и последующие команды обращения к хранилищу смогут «зацепиться» за него.
Теперь, когда расширение существует в списке, мы можем инициировать получение данных из хранилища. Проанализируем правильный набор параметров для этой операции. Нам необходимо указать адрес хранилища, учетные данные и имя расширения.
Важный момент: для первой синхронизации в новой базе полезно использовать флаги -revised и -force, чтобы система принудительно сопоставила локальный объект с объектом в хранилище, игнорируя возможные различия в идентификаторах версий.
Пример команды для получения данных из хранилища расширения:
1cv8.exe CONFIG /F"C:\Bases\TempDB" /N"Admin" /P"Pass"
/ConfigurationRepositoryF "tcp://server/Extension_Repo"
/ConfigurationRepositoryN "RepoUser"
/ConfigurationRepositoryP "RepoPass"
/ConfigurationRepositoryUpdateCfg -Extension "Мои_Доработки" -revised -force
Загрузка данных из хранилища обновляет только «основную» часть расширения (аналогично нажатию кнопки «Загрузить» в конфигураторе). Чтобы изменения вступили в силу на уровне структуры таблиц базы данных, необходимо выполнить финальный этап — обновление конфигурации базы данных (аналог клавиши F7).
Рассмотрим команду обновления базы данных для конкретного расширения:
1cv8.exe CONFIG /F"C:\Bases\TempDB" /N"Admin" /P"Pass" /UpdateDBCfg -Extension "Мои_Доработки"
Соберем все наши действия в единый логический скрипт. Предположим, мы используем командные файлы (bat/cmd) или файлы параметров (/@). Посмотрим на структуру правильного процесса создания базы с расширениями:
CREATEINFOBASE..cfe файла для создания записи в метаданных./ConfigurationRepositoryUpdateCfg для получения последних правок из репозитория./UpdateDBCfg для расширения.Проанализируем пример файла параметров для пакетного выполнения, который решает проблему автора темы:
CONFIG /F"v8r_TempDB" /N"Admin" /P"Pass"
/Out "log_ext_load.log"
/WA+
/DisableStartupMessages
/DisableStartupDialogs
/LoadCfg "C:\Storage\Stub.cfe" -Extension "Мои_Доработки"
CONFIG /F"v8r_TempDB" /N"Admin" /P"Pass"
/Out "log_ext_sync.log"
/ConfigurationRepositoryF "tcp://hr1c/ZUP_ext"
/ConfigurationRepositoryN "NAME"
/ConfigurationRepositoryP "PASS"
/ConfigurationRepositoryUpdateCfg -Extension "Мои_Доработки" -revised
CONFIG /F"v8r_TempDB" /N"Admin" /P"Pass"
/Out "log_ext_db.log"
/UpdateDBCfg -Extension "Мои_Доработки"
При работе с пакетным режимом 1С существуют «подводные камни», которые могут привести к неудаче даже при правильной последовательности команд. Рассмотрим их подробнее:
Кодировка и спецсимволы: Как было отмечено в обсуждении, крайне важно следить за кодировкой файлов скриптов. Если имя расширения содержит кириллицу (например, "Мои_Доработки"), файл скрипта должен быть сохранен в кодировке CP866 (для Windows CMD) или UTF-8 с BOM, чтобы 1С корректно распознала символы. В противном случае платформа снова выдаст ошибку о том, что расширение не найдено, так как не сможет сопоставить искаженное имя из командной строки с реальным именем в базе.
Регистр имен: Хотя 1С часто лояльна к регистру, в пакетных параметрах расширений рекомендуется строго соблюдать регистр, указанный в свойстве «Имя» в конфигураторе. Помните, что используется именно Имя, а не Синоним.
Версия платформы: В версиях 8.3.18 и выше работа с хранилищами через протокол tcp:// стала более чувствительной к сетевым задержкам и стабильности сервера хранилища. Если вы получаете ошибки при подключении, попробуйте временно использовать путь к сетевой папке для диагностики проблемы доступа.
Права доступа в хранилище: Убедитесь, что пользователь, под которым выполняется подключение (параметр /ConfigurationRepositoryN), имеет права не только на просмотр, но и на административные действия, если планируется использование флага -force.
Таким образом, мы выяснили, что ключевым моментом в решении проблемы является предварительное создание объекта расширения в локальной базе перед попыткой его обновления из хранилища. Используя предложенный алгоритм, вы сможете стабильно автоматизировать развертывание любых расширений в пакетном режиме.