Разработка и Конфигурация · 11 мин
Как обновить расширение из хранилища 1С
Как обновить расширение конфигурации из хранилища 1С: подключение к хранилищу, получение изменений, разрешение конфликтов, проверка результата и типичные ошибки.
Расширения конфигурации в 1С позволяют дорабатывать типовое решение, не снимая его с поддержки. Когда над одним расширением работает несколько разработчиков, используется хранилище — централизованный репозиторий версий. Обновление расширения из хранилища означает получение в локальную базу изменений, которые внесли коллеги, и синхронизацию рабочей копии с актуальным состоянием проекта.
Процедура похожа на обновление основной конфигурации из хранилища, но имеет особенности: у расширения собственное хранилище (или отдельный каталог в общем), свой механизм захвата объектов и свои правила разрешения конфликтов. Ошибка на этом этапе может привести к потере чужих доработок или к рассинхронизации версий у команды.
Ниже разобран полный цикл: от подключения к хранилищу расширения до проверки результата обновления, с типичными ошибками и способами их обхода.
Что нужно подготовить перед обновлением
Обновление из хранилища — операция, которая меняет содержимое расширения в вашей информационной базе. Прежде чем запускать её, убедитесь, что выполнены базовые условия: у вас есть права на работу с расширением в конфигураторе, известны адрес хранилища (путь к каталогу или сетевой ресурс) и учётные данные пользователя хранилища.
Отдельно проверьте, что расширение вообще подключено к хранилищу. Если связь не настроена, пункты работы с хранилищем будут недоступны. Подключение выполняется один раз: откройте нужное расширение в конфигураторе, перейдите в меню «Конфигурация → Хранилище конфигурации → Подключиться к хранилищу» и укажите путь к каталогу хранилища, имя пользователя и пароль.
Полезно заранее выгрузить текущее состояние расширения в файл (меню «Конфигурация → Выгрузить в файлы» или сохранение расширения в файл *.cfe). Это страховка: если обновление пройдёт с конфликтами или вы случайно отмените чужие изменения, исходное состояние можно будет восстановить.
Подключение расширения к хранилищу
Хранилище расширения — это обычное хранилище конфигурации 1С, созданное отдельно для файла расширения. Администратор создаёт его через конфигуратор (меню «Конфигурация → Хранилище конфигурации → Создать хранилище») в момент, когда расширение открыто на редактирование. Дальше каждый разработчик подключается к этому хранилищу со своей учётной записью.
Чтобы подключиться, откройте в конфигураторе список расширений («Конфигурация → Расширения конфигурации»), дважды щёлкните по нужному расширению — откроется его конфигурация. Затем выберите «Конфигурация → Хранилище конфигурации → Подключиться к хранилищу» и заполните параметры: путь к каталогу хранилища, пользователь, пароль. После успешного подключения в дереве конфигурации расширения появятся признаки захвата объектов.
Если хранилище лежит на сетевом ресурсе, проверьте доступность пути из вашей сессии и наличие прав на чтение и запись в каталог. Медленное сетевое подключение — частая причина обрывов при получении изменений, поэтому при больших объёмах лучше работать по стабильному каналу.
Пошаговое обновление расширения из хранилища
Когда подключение настроено, само обновление занимает несколько минут. Откройте конфигуратор под пользователем с правами администратора, перейдите в список расширений и откройте нужное расширение на редактирование. Дальше действуйте по стандартному сценарию работы с хранилищем.
- 1Откройте конфигуратор и перейдите в «Конфигурация → Расширения конфигурации»
- 2Дважды щёлкните по нужному расширению, чтобы открыть его конфигурацию
- 3Выберите «Конфигурация → Хранилище конфигурации → Обновить из хранилища»
- 4В окне сравнения просмотрите список изменённых объектов и отметьте, что принимать
- 5Подтвердите обновление и дождитесь завершения загрузки изменений
- 6Обновите конфигурацию базы данных (F7), если изменения затрагивают структуру данных
- 7Проверьте работу расширения в режиме предприятия
В диалоге обновления конфигуратор покажет различия между вашей версией расширения и последней версией в хранилище. Объекты, изменённые только в хранилище, обновляются без вопросов. Объекты, которые изменяли и вы, и коллеги, требуют решения: принять версию хранилища, оставить свою или объединить вручную.
После загрузки изменений платформа может потребовать обновить конфигурацию базы данных — это обязательный шаг, если в расширении добавлялись реквизиты, регистры или другие объекты, влияющие на структуру данных. Без него расширение в базе останется в старом состоянии.
Как разрешить конфликты при обновлении
Конфликт возникает, когда один и тот же объект расширения изменяли несколько разработчиков. Механизм захвата объектов снижает вероятность конфликтов: пока объект захвачен вами, другие не могут поместить в хранилище его изменённую версию. Но если захват не использовался или был снят, столкновение версий неизбежно.
При обновлении конфликтующие объекты помечаются в окне сравнения. Для модулей с кодом используйте построчное сравнение: конфигуратор показывает обе версии текста, и вы вручную переносите нужные фрагменты. Для форм и макетов ручное слияние сложнее — часто рациональнее принять версию хранилища и повторно внести свои правки.
Правило команды должно быть простым: кто последним помещает объект в хранилище, тот и отвечает за корректное слияние. Если вы обновляетесь и видите чужой конфликтующий объект, не отменяйте чужие изменения молча — согласуйте с автором, какая версия должна остаться.
Проверка результата после обновления
После завершения обновления убедитесь, что расширение не просто загрузилось, а реально работает. Откройте список расширений в режиме предприятия («Все функции → Стандартные → Управление расширениями конфигурации») и проверьте, что расширение подключено, не имеет ошибок применения и его версия соответствует ожидаемой.
Прогоните ключевые сценарии, которые затрагивает расширение: откройте изменённые формы, выполните типовые операции, проверьте печатные формы и отчёты. Если расширение меняет проведение документов, проведите тестовый документ на копии базы.
Как проверить результат
Подключено, ошибок применения нет
Пометка об ошибке или расширение отключено
Изменённые коллегами объекты присутствуют в новой версии
Чужие доработки отсутствуют или откатились
Изменённые формы и операции работают как задумано
Ошибки при открытии форм, падение операций
Ваша версия совпадает с последней версией хранилища
Остались неполученные изменения
Если после обновления расширение не применяется, первым делом смотрите журнал регистрации: там фиксируются ошибки совместимости расширения с основной конфигурацией. Частая причина — расширение рассчитано на другую версию основной конфигурации, и после обновления самой конфигурации контролируемые объекты изменились.
Особые сценарии и ограничения
Не все ситуации укладываются в стандартный сценарий. Ниже — варианты, которые встречаются на практике, и рекомендации по каждому.
Обновление, если хранилище недоступно
Если сетевое хранилище временно недоступно, получить изменения штатно нельзя. Временный обходной путь — попросить коллегу сохранить расширение в файл *.cfe и загрузить его в вашу базу через «Конфигурация → Расширения конфигурации → Загрузить из файла». Учтите: такая загрузка полностью заменяет расширение и не синхронизируется с хранилищем, поэтому после восстановления доступа потребуется аккуратное сравнение.
Обновление расширения в файловой базе
В файловых базах хранилище расширения работает так же, но обновление конфигурации базы данных требует монопольного доступа. Перед обновлением попросите всех пользователей выйти или завершите сеансы через консоль. В клиент-серверном варианте монопольный режим устанавливается из конфигуратора без полного отключения базы.
Расширение без хранилища: когда хранилище не нужно
Если расширение поддерживает один разработчик и доработки немногочисленны, хранилище может быть избыточным. В этом случае версионирование ведётся через периодическое сохранение расширения в файлы *.cfe с понятными именами. Но как только над расширением начинают работать двое и более — хранилище становится необходимостью, иначе конфликты версий неизбежны.
Как выбрать действие
FAQ
Можно ли обновить расширение из хранилища без конфигуратора?
Нет, работа с хранилищем конфигурации выполняется только в конфигураторе. В режиме предприятия можно лишь подключить или отключить уже готовое расширение из файла, но получить изменения из хранилища там нельзя. Для автоматизации используют пакетный режим конфигуратора с параметрами командной строки.
Что делать, если при обновлении пропали мои изменения?
Если вы заранее сохранили расширение в файл *.cfe — восстановите свою версию из него и аккуратно объедините с версией хранилища через сравнение. Если резервной копии нет, а изменения не были помещены в хранилище, восстановить их штатными средствами не получится: обновление перезаписало объекты. Поэтому правило «сначала поместить или сохранить, потом обновлять» — обязательное.
Нужно ли обновлять конфигурацию базы данных после обновления расширения?
Да, если изменения затрагивают структуру данных: добавленные реквизиты, регистры, справочники и тому подобное. Без обновления конфигурации базы данных (клавиша F7 в конфигураторе) расширение в базе останется в прежнем состоянии, даже если в конфигураторе отображается новая версия.
Почему расширение после обновления отключилось с ошибкой?
Чаще всего причина — несовместимость с текущей версией основной конфигурации: объект, на который опирается расширение, был изменён или удалён при обновлении самой конфигурации. Откройте журнал регистрации, найдите текст ошибки применения расширения и адаптируйте расширение под актуальное состояние основной конфигурации.
Можно ли использовать одно хранилище для нескольких расширений?
Штатно одно хранилище конфигурации обслуживает одну конфигурацию или одно расширение. Для нескольких расширений создают отдельные хранилища — по одному на каждое. Это упрощает историю версий и исключает путаницу при получении изменений.
Что важно запомнить
Обновление расширения из хранилища выполняется в конфигураторе через «Хранилище конфигурации → Обновить из хранилища» и требует предварительного подключения расширения к хранилищу. Перед обновлением зафиксируйте или сохраните свои изменения, при конфликтах согласуйте слияние с коллегами, а после — обновите конфигурацию базы данных и проверьте работу расширения в режиме предприятия.