К статье
Практический материал

Разработка и Конфигурация · 9 мин

Как открыть код 1С в конфигураторе

Как открыть код 1С в конфигураторе: вход в режим разработки, поиск модулей объектов, форм и общих модулей, просмотр и редактирование кода, типичные ошибки.

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

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

Как запустить конфигуратор

Конфигуратор запускается из того же стартового окна 1С, что и обычный режим. Откройте ярлык 1С, выберите в списке нужную информационную базу и вместо кнопки «1С:Предприятие» нажмите кнопку «Конфигуратор» в нижней части окна. Если база защищена паролем, введите логин и пароль пользователя с правами разработчика.

Если кнопки «Конфигуратор» нет в списке режимов, проверьте, что на компьютере установлена полная версия платформы, а не только клиентское приложение. В учебных и базовых версиях некоторых продуктов конфигуратор может отсутствовать или быть ограничен. Также убедитесь, что в свойствах базы в списке не отключён запуск конфигуратора — параметр редактируется кнопкой «Изменить» в стартовом окне.

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

Как открыть конфигурацию для просмотра

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

После открытия появится дерево объектов: справочники, документы, отчёты, обработки, регистры, общие модули и другие разделы. Именно здесь находится весь код конфигурации, распределённый по модулям конкретных объектов. Дерево можно отфильтровать по подсистемам или искать объекты по имени через стандартный поиск.

Где именно лежит код: типы модулей

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

Тип модуляЧто содержитКак открыть
Модуль объектаОбработчики проведения, записи, заполнения документа или справочникаПравой кнопкой по объекту → «Открыть модуль объекта»
Модуль формыЛогика формы: обработчики кнопок, события открытияОткрыть форму объекта → вкладка «Модуль»
Модуль менеджераСерверные процедуры объекта без привязки к конкретному элементуКонтекстное меню объекта → «Открыть модуль менеджера»
Общий модульОбщие процедуры и функции, доступные всей конфигурацииВетка «Общие → Общие модули»
Модуль приложенияОбработчики запуска и завершения системыКорень дерева → контекстное меню → «Открыть модуль приложения»

Если вы ищете, где выполняется конкретное действие — например, расчёт суммы при проведении документа, — начинайте с модуля объекта этого документа, затем проверяйте общие модули, к которым он обращается. Вызовы вида ИмяМодуля.ИмяПроцедуры() ведут именно в общий модуль с указанным именем.

Поиск нужного кода по всей конфигурации

Когда неизвестно, в каком модуле находится нужная логика, используйте глобальный поиск: меню «Правка → Глобальный поиск по текстам» или сочетание Ctrl+Shift+F. Введите фрагмент текста — название процедуры, сообщение об ошибке, текст запроса — и платформа покажет все вхождения по всем модулям конфигурации.

Для поиска мест вызова конкретной процедуры поставьте курсор на её имя и вызовите «Поиск ссылок в объектах метаданных» из контекстного меню. Это помогает перед переименованием или удалением процедуры убедиться, что она нигде не используется. Полезен и поиск по конфигурации через «Конфигурация → Поиск ссылок в объектах» — он показывает связи между объектами метаданных.

Порядок действий: открыть модуль документа
  1. 1
    Запустите базу в режиме «Конфигуратор» с учётной записью разработчика
  2. 2
    Откройте конфигурацию: меню «Конфигурация → Открыть конфигурацию»
  3. 3
    В дереве метаданных разверните ветку «Документы» и найдите нужный документ
  4. 4
    Нажмите по нему правой кнопкой мыши и выберите «Открыть модуль объекта»
  5. 5
    Изучите код или внесите изменения, затем проверьте синтаксис: «Конфигурация → Проверка конфигурации»

Как разрешить редактирование типовой конфигурации

В типовых конфигурациях (1С:Бухгалтерия, Управление торговлей и других) код по умолчанию открывается только для чтения: изменения заблокированы поддержкой поставщика. Чтобы включить редактирование, откройте «Конфигурация → Поддержка → Настройка поддержки» и нажмите кнопку «Включить возможность изменения». Платформа предупредит о последствиях — соглашайтесь только осознанно.

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

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

Типичные ошибки
01
Снятие конфигурации с поддержки полностью вместо режима «редактируется с сохранением поддержки» — усложняет все последующие обновления
02
Изменение кода без резервной копии базы — при ошибке откатить изменения будет нечем
03
Редактирование кода в рабочей базе без проверки на копии — ошибка в модуле проведения остановит работу пользователей
04
Забытый шаг «Обновить конфигурацию базы данных» (F7) после изменений — изменения не применятся или база получит рассинхронизацию структуры

Сохранение и применение изменений

Изменённый модуль сохраняется обычным Ctrl+S, но этого недостаточно: изменения попадут в базу только после обновления конфигурации базы данных — клавиша F7 или меню «Конфигурация → Обновить конфигурацию базы данных». Если изменений в структуре данных нет (менялся только код), обновление проходит быстро и не требует монопольного доступа в серверных базах.

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

Контрольные точки

Как проверить результат

Сохранение модуля
Норма

Звёздочка в заголовке вкладки модуля исчезла после Ctrl+S

Тревожный признак

Звёздочка осталась — изменения не сохранены

Обновление конфигурации БД
Норма

Окно сообщений показывает «Обновление конфигурации базы данных успешно завершено»

Тревожный признак

Ошибки синтаксиса или требование монопольного доступа

Работа в режиме Предприятие
Норма

Изменённая логика выполняется при проверке на тестовом документе

Тревожный признак

Выполняется старый код — возможно, редактировался не тот модуль

Частые вопросы

Можно ли открыть код без конфигуратора?

Нет, штатного способа просматривать модули из режима «Предприятие» нет. Альтернатива — выгрузить конфигурацию в файлы через «Конфигурация → Выгрузить конфигурацию в файлы» и просматривать модули как текстовые файлы, но редактировать и применять изменения всё равно придётся через конфигуратор.

Почему модуль открывается только для чтения?

Наиболее вероятная причина — конфигурация находится на полной поддержке поставщика без возможности изменения. Включите редактирование через «Конфигурация → Поддержка → Настройка поддержки». Вторая причина — отсутствие у пользователя права «Администрирование» или ограничение лицензии.

Где искать код кнопки на форме документа?

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

Что делать, если конфигуратор требует монопольный доступ?

Монопольный доступ требуется при обновлении конфигурации базы данных с изменением структуры. Попросите пользователей выйти или завершите сеансы через консоль кластера (для серверных баз) либо через «Администрирование → Активные пользователи». Не завершайте сеансы принудительно без предупреждения — несохранённые данные пользователей будут потеряны.

Как открыть код внешней обработки или отчёта?

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

Безопасно ли менять код в рабочей базе напрямую?

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

Итог

Что важно запомнить

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