Как открыть модуль в 1С: подробная инструкция

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

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

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

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

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

Также проверьте режим запуска. Если база открыта только в режиме «Предприятие», модули недоступны — там выполняется код, но не редактируется. Запуск конфигуратора выполняется из стартера 1С: выделите базу в списке и нажмите кнопку «Конфигуратор».

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

Как проверить готовность к работе

Запуск конфигуратора

Норма

Конфигуратор открывается, дерево конфигурации видно

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

Кнопка «Конфигуратор» неактивна или выдаётся ошибка прав — нужны права администратора

Статус поддержки

Норма

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

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

Замок на объектах без понимания, зачем он стоит

Резервная копия

Норма

Есть свежая выгрузка базы или .cf конфигурации

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

Копии нет, а править планируется рабочую базу

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

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

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

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

Как открыть модуль объекта (справочника, документа)

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

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

Если пункты меню неактивны, проверьте, не заблокирован ли объект хранилищем конфигурации. В этом случае сначала выполните захват объекта: правой кнопкой → «Захватить в хранилище».

Как открыть модуль формы

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

Быстрый альтернативный путь: правой кнопкой по объекту → «Открыть основную форму», затем закладка «Модуль». В управляемых формах обратите внимание на директивы компиляции: &НаКлиенте, &НаСервере, &НаСервереБезКонтекста — они показывают, где выполняется код, и помогают сориентироваться в модуле.

Как открыть общий модуль и модуль приложения

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

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

Там же, в контекстном меню корня, находятся модуль сеанса и модуль внешнего соединения — они нужны реже, но открываются тем же способом.

Как найти нужный модуль через глобальный поиск

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

Результаты отобразятся списком с указанием объекта и модуля. Двойной щелчок по строке результата открывает модуль сразу на нужной строке. Это самый быстрый способ добраться до кода, который вы видели в сообщении об ошибке или в отладчике.

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

Ещё один способ — отладка. Поставьте точку останова (F9) в предполагаемом месте или включите «Остановку по ошибке» в меню «Отладка»: при возникновении ошибки конфигуратор сам откроет модуль на проблемной строке.

Открытие модуля внешней обработки или отчёта

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

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

Типичные ошибки при открытии модулей

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

Часто задаваемые вопросы

Почему пункт «Открыть модуль» неактивен в меню?

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

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

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

Как найти, в каком модуле находится нужная процедура?

Используйте глобальный поиск (Ctrl+Shift+F) по имени процедуры или уникальному фрагменту кода. Результаты покажут объект и модуль, двойной щелчок откроет код на нужной строке.

Чем модуль формы отличается от модуля объекта?

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

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

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