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