Как выгрузить модуль из 1С

Под выгрузкой модуля из 1С обычно понимают сохранение программного кода объекта конфигурации — общего модуля, модуля объекта, модуля формы — во внешний текстовый файл. Это нужно для переноса кода между базами, резервного копирования перед доработкой, передачи фрагмента кода коллеге или анализа модуля во внешнем редакторе.

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

Ниже разобраны основные сценарии: сохранение текста модуля в файл, выгрузка через пакетный режим конфигуратора, работа с модулями расширений и внешних обработок, а также проверка результата и типичные ошибки.

Что нужно проверить перед выгрузкой модуля

Перед началом убедитесь, что у вашей учётной записи есть права «Конфигуратор» и достаточные права на объект. Если модуль принадлежит объекту, поставленному на поддержку без возможности изменения, открыть его на просмотр можно, но при закрытой поставке кода текст будет недоступен.

Определите, какой именно модуль вам нужен. У одного объекта может быть несколько модулей: модуль объекта, модуль менеджера, модули форм, модуль команды. У справочника или документа код часто распределён между ними, и выгрузка только модуля объекта даст неполную картину.

Если база рабочая и в ней ведётся учёт, любые действия выполняйте в режиме просмотра: выгрузка модуля сама по себе не меняет данные, но случайное изменение кода с последующим обновлением конфигурации — меняет. Перед экспериментами сделайте выгрузку информационной базы в файл .dt.

Выгрузка модуля через конфигуратор в файл

Штатный способ сохранить код одного модуля — меню сохранения в окне редактора. Откройте конфигуратор, в дереве конфигурации найдите нужный объект, например «Общие модули», и двойным щелчком откройте модуль.

Когда текст модуля открыт в редакторе, выберите «Файл → Сохранить как» (или «Сохранить копию» в зависимости от версии платформы) и укажите путь к файлу. Сохраняйте с расширением .bsl — это общепринятое расширение для файлов кода встроенного языка 1С, его корректно открывают сторонние редакторы и инструменты анализа.

Обратите внимание на кодировку при сохранении. Для кириллицы безопаснее использовать UTF-8 с BOM: так файл корректно откроется и в конфигураторе другой базы, и во внешних редакторах без «кракозябр».

1. 1
   Откройте конфигуратор и дерево конфигурации
2. 2
   Найдите объект и откройте нужный модуль (модуль объекта, формы или общий модуль)
3. 3
   Убедитесь, что текст модуля отображается, а не скрыт поставкой
4. 4
   Выберите «Файл → Сохранить как» и укажите файл с расширением .bsl в кодировке UTF-8
5. 5
   Откройте сохранённый файл и проверьте, что код читается полностью

Выгрузка модуля формы и модуля объекта

Модуль формы открывается иначе, чем общий модуль. В дереве конфигурации разверните объект, перейдите в раздел «Формы», откройте нужную форму и перейдите на вкладку «Модуль» в нижней части окна редактора формы. Дальше сохранение выполняется так же — через меню «Файл».

Модуль объекта и модуль менеджера открываются через контекстное меню объекта в дереве конфигурации: правый клик по объекту, затем выбор соответствующего пункта. У регистров сведений и накопления есть также модуль набора записей — его легко пропустить, если выгружать код «на глаз».

Если задача — получить весь код объекта целиком, удобнее не сохранять модули по одному, а выгрузить конфигурацию в файлы: тогда платформа сама разложит все модули по отдельным файлам в структуре каталогов.

Массовая выгрузка модулей через пакетный режим

Когда нужно выгрузить не один модуль, а весь код конфигурации, используется команда «Конфигурация → Выгрузить конфигурацию в файлы». Платформа создаст дерево каталогов, где каждый объект представлен набором файлов, а модули лежат в файлах Module.bsl внутри соответствующих папок.

Ту же операцию можно выполнить из командной строки без открытия интерфейса — пакетным режимом конфигуратора. Это удобно для регулярного резервного копирования кода и интеграции с системами контроля версий.

"C:\Program Files\1cv8\<версия>\bin\1cv8.exe" DESIGNER /F"C:\Bases\MyBase" /N"ИмяПользователя" /P"Пароль" /DumpConfigToFiles "C:\Export\Config" /Out "C:\Export\log.txt"

Путь к исполняемому файлу зависит от установленной версии платформы, параметры подключения — от способа развёртывания базы (файловый или клиент-серверный вариант, для которого используется ключ /S вместо /F). Результат и ошибки смотрите в файле журнала, указанном в параметре /Out.

Выгрузка в файлы большой конфигурации занимает заметное время и создаёт тысячи файлов — это нормально. Не прерывайте процесс: незавершённая выгрузка даст неполный набор модулей без явного сообщения об ошибке в интерфейсе.

Выгрузка модуля из расширения и внешней обработки

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

Модуль внешней обработки или отчёта (.epf, .erf) открывается через «Файл → Открыть» в конфигураторе. Дальше доступны модуль объекта и модули форм обработки, которые сохраняются в .bsl тем же способом. Управляемая форма внешней обработки открывается из дерева обработки, а не сразу.

Проверка результата и типичные ошибки

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

Частая ошибка — сохранение модуля при открытой конфигурации базы данных вместо основной конфигурации. Конфигурация базы данных может отличаться от основной, если изменения не были обновлены. Перед выгрузкой проверьте наличие значка несохранённых изменений в заголовке дерева конфигурации.

Частые вопросы о выгрузке модулей из 1С