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

В этой статье мы разберём 6 проверенных способов вызова процедур из общих модулей — от базового синтаксиса до продвинутых техник с учётом особенностей платформы 1С 8.3. Вы узнаете, как избежать типичных ошибок (например, Неопределённый идентификатор), когда использовать Экспорт, а когда — Глобальный, и как правильно передавать параметры. Материал будет полезен как новичкам, так и опытным программистам, которые хотят систематизировать знания.

⚠️ Важно: Примеры в статье актуальны для платформы 1С:Предприятие 8.3.20+. Если вы работаете с более ранними версиями (например, 8.2), некоторые конструкции могут требовать адаптации. Всегда проверяйте синтаксис в официальной документации.

Почему не работает вызов процедуры из общего модуля?

Чаще всего проблемы возникают из-за неправильных настроек самого модуля или ошибок в синтаксисе вызова. Вот топ-3 причины, по которым ваш код может не работать:

1. Не указан флаг «Экспорт»

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

2. Неверно выбрано свойство «Глобальный»

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

3. Конфликт имён с другими модулями

Если в конфигурации есть несколько общих модулей с одинаковыми именами процедур, платформа может «путаться», какой именно метод вызывать. Всегда используйте полное имя (например, ОбщийМодуль.ИмяПроцедуры()) для избежания неоднозначностей.

📊 Как часто вы сталкиваетесь с ошибками при вызове процедур из общих модулей 1С?
Часто, это моя головная боль
Иногда, но решаю быстро
Рядом, но не моя задача
Никогда, я гуру 1С

Способ 1: Прямой вызов через точку (базовый синтаксис)

Это самый простой и распространённый способ. Он работает, если:

- Общий модуль не помечен как глобальный.

- Вы вызываете процедуру из другого модуля конфигурации (например, из формы или документа).

Синтаксис:

ОбщийМодуль.ИмяПроцедуры(Параметр1, Параметр2);

Пример: Допустим, у вас есть общий модуль РаботаСКлиентами с процедурой ПолучитьСкидку(), которая принимает ID клиента и возвращает размер скидки. Вызов из модуля документа ЗаказКлиента будет выглядеть так:

Скидка = РаботаСКлиентами.ПолучитьСкидку(Клиент.Ссылка);
  • ✅ Плюсы: Простота, наглядность, нет риска конфликтов имён.
  • ❌ Минусы: Не работает для глобальных модулей (нужно убирать имя модуля).
💡

Если имя общего модуля длинное (например, ОбщийМодульРаботаСКонтрагентамиИДоговорами), используйте псевдонимы через директиву #Использовать в начале вашего модуля. Это сократит код и улучшит читаемость.

Способ 2: Вызов из глобального модуля

Если общий модуль помечен как Глобальный, его процедуры становятся доступны весь конфигурации без указания имени модуля. Это удобно для часто используемых функций (например, работы с датами или строками).

Синтаксис:

ИмяПроцедуры(Параметр1, Параметр2);

Пример: В глобальном модуле Утилиты есть функция ФорматироватьТелефон(Номер). Вызов из любого места:

ТелефонДляОтображения = ФорматироватьТелефон("79123456789");
⚠️ Внимание: Злоупотребление глобальными модулями ведёт к «загрязнению» пространства имён. Если два модуля содержат процедуры с одинаковыми именами, платформа выберет первую попавшуюся, что может привести к трудноотслеживаемым ошибкам. Используйте глобальные модули только для универсальных утилит!
Сценарий Способ вызова Пример кода
Локальный общий модуль Через точку МойМодуль.МояПроцедура()
Глобальный модуль Без указания модуля МояПроцедура()
Вызов из другого модуля с псевдонимом Через псевдоним #Использовать МойМодуль
ММ.МояПроцедура()
Вызов с передачей параметров Через запятую Модуль.Процедура(Парам1, Парам2)

Способ 3: Использование директивы #Использовать

Директива #Использовать позволяет:

1. Сократить имена длинных модулей.

2. Явно указать, какие модули нужны в текущем контексте (улучшает читаемость кода).

3. Избежать конфликтов имён при работе с несколькими модулями.

Синтаксис:

#Использовать <ИмяМодуля> [Как <Псевдоним>]


Псевдоним.ИмяПроцедуры(Параметры);

Пример: У вас есть модуль ОбщийМодульРаботаСОтчетамиИАналитикой. Чтобы не писать его полностью, используйте псевдоним:

#Использовать ОбщийМодульРаботаСОтчетамиИАналитикой Как Отчеты


Результат = Отчеты.СформироватьОтчетПоПродажам(ДатаНачала, ДатаКонца);

  • 🔹 Где размещать директиву? В начале модуля (до первого оператора).
  • 🔹 Можно ли использовать без псевдонима? Да, тогда имя модуля останется полным.
  • 🔹 Работает ли с глобальными модулями? Да, но псевдоним не обязателен.
Что делать, если директива #Использовать не работает?

Если платформа игнорирует директиву #Использовать, проверьте:

1. Правильность написания имени модуля (регистр не важен, но опечатки критичны).

2. Отсутствие пробелов вокруг знака = при указании псевдонима (синтаксис: Как Отчеты, а не Как=Отчеты).

3. Что директива расположена до любого исполняемого кода в модуле.

4. Что модуль, который вы подключаете, существует в конфигурации и доступен в текущем режиме (1С:Предприятие или Конфигуратор).

Способ 4: Вызов через Выполнить() для динамического кода

Иногда имя процедуры или модуля известно только во время выполнения (например, хранится в базе данных или зависит от условий). В таких случаях используйте метод Выполнить().

Синтаксис:

Выполнить("ИмяМодуля.ИмяПроцедуры(Параметр1, Параметр2)");

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

ИмяПроцедуры = Справочники.ТипыОбработки.НайтиПоНаименованию(ТипОбработки).Процедура;

Выполнить("ОбщийМодульОбработкаЗаказов." + ИмяПроцедуры + "(ДокументОбъект)");

⚠️ Внимание: Метод Выполнить() обходит статическую проверку синтаксиса, поэтому ошибки в строке кода вы узнаете только во время исполнения. Всегда проверяйте корректность формируемой строки перед выполнением!
  • ✨ Когда использовать:
    • 📌 Имя процедуры определяется динамически.
    • 📌 Нужно вызвать процедуру из модуля, который подключается плагином.
    • 📌 Требуется гибкость при модификации логики без изменения кода.
  • ⚠️ Риски:
    • 🔴 Уязвимость для инъекций кода (если строка формируется из пользовательского ввода).
    • 🔴 Сложность отладки (ошибки не видны на этапе компиляции).

Имя процедуры сформировано корректно|Параметры передаются в правильном порядке|Строка не содержит опасных символов (кавычки, точка с запятой)|Есть обработка исключений (Try..Except)|-->

Способ 5: Вызов из клиентского кода (тонкости)

При работе с клиент-серверной архитектурой (например, в управляемых формах) важно помнить, что:

- Клиентские процедуры (помеченные как Клиент или Клиент, Сервер) можно вызывать напрямую.

- Серверные процедуры (помеченные как Сервер) требуют явного указания контекста через НаСервере или НаКлиенте.

Пример 1: Вызов клиентской процедуры из формы

// В модуле управляемой формы:

Процедура ПриОткрытии(Отказ)


ОбщийМодульКлиентскиеУтилиты.ПоказатьПодсказку("Добро пожаловать!");


КонецПроцедуры

Пример 2: Вызов серверной процедуры с клиента

// В модуле формы:

Процедура ОбновитьДанные(Команда)


ОбщийМодульСерверныеПроцедуры.НаСервереОбновитьДанные(Параметр);


КонецПроцедуры



// В общем модуле (серверная процедура):


Процедура НаСервереОбновитьДанные(Параметр) Экспорт


// Логика обновления


КонецПроцедуры

⚠️ Типичная ошибка: Попытка вызвать серверную процедуру напрямую из клиентского кода без обёртки приведёт к ошибке Вызов серверной процедуры из клиентского контекста запрещён.

💡

Всегда проверяйте контекст выполнения процедуры в общем модуле! Если она помечена как Сервер, её нельзя вызвать напрямую из клиентского кода (например, из кнопки формы) без обёртки в НаСервере.

Способ 6: Вызов через механизм расширений

Если вы работаете с расширениями конфигурации, вызов процедур из общих модулей имеет особенности:

1. Общие модули расширения не видны в основной конфигурации по умолчанию.

2. Чтобы их использовать, нужно явно подключать модуль через директиву #Использовать или обращаться через полное имя с префиксом расширения.

Пример: В расширении ДопФункционал есть общий модуль МойМодуль с процедурой ОбработатьДанные(). Вызов из основной конфигурации:

#Использовать ДопФункционал.ОбщийМодуль.МойМодуль


МойМодуль.ОбработатьДанные(Параметр);

  • 🔧 Важно: Имена модулей в расширениях должны быть уникальными, иначе возможны конфликты.
  • 🔧 Совет: Используйте префиксы (например, ДФ_МойМодуль) для избежания пересечений.

Типичные ошибки и как их исправить

Даже опытные разработчики иногда сталкиваются с ошибками при работе с общими модулями. Вот самые распространённые из них и способы их решения:

Ошибка Причина Решение
{ОбщийМодуль.ИмяПроцедуры}: Метод не найден Не указан флаг Экспорт или модуль не глобальный, а вызывает без точки. Добавьте Экспорт к процедуре или укажите имя модуля через точку.
Неопределённый идентификатор (ИмяМодуля) Опечатка в имени модуля или модуль не подключён директивой #Использовать. Проверьте регистр и наличие модуля в конфигурации. Подключите его явно.
Вызов серверной процедуры из клиентского контекста запрещён Попытка вызвать серверную процедуру напрямую из клиентского кода. Оберните вызов в НаСервере или пометьте процедуру как Клиент, Сервер.
Ошибка при вызове метода объекта (Выполнить) Ошибка в строке кода, передаваемой в Выполнить(). Проверьте синтаксис строки и экранируйте кавычки (\").

💡 Совет по отладке: Если процедура не вызывается, проверьте её видимость в дереве конфигурации (правая кнопка на модуле → Показать в дереве). Убедитесь, что:

- Модуль не помечен как Помечен на удаление.

- У процедуры стоит галочка Экспорт.

- Нет конфликтов имён с другими модулями.

FAQ: Ответы на частые вопросы

Можно ли вызвать процедуру из общего модуля, который находится в другом расширении?

Да, но нужно явно указать имя расширения в пути. Например:

#Использовать МоеРасширение.ОбщийМодуль.ИмяМодуля

ИмяМодуля.Процедура();

Если модуль глобальный, можно вызвать без указания расширения, но это не рекомендуется из-за риска конфликтов.

Почему при вызове процедуры из общего модуля падает 1С с ошибкой "Защита от несанкционированного доступа"?

Эта ошибка возникает, если:

  • Вы пытаетесь вызвать процедуру из внешней обработки или отчёта без прав доступа.
  • В настройках информационной базы включена Защита от опасных действий, а ваша процедура выполняет потенциально опасные операции (например, работу с файлами).

Решение: Проверьте права пользователя в Администрирование → Пользователи или временно отключите защиту для отладки (не рекомендуется для рабочих баз!).

Как передать в процедуру общего модуля ссылку на текущий документ?

Передавайте ЭтотОбъект (для управляемых форм) или Ссылка (для обычных форм). Пример:

// В модуле документа:

ОбщийМодуль.ОбработатьДокумент(ЭтотОбъект.Ссылка);



// В общем модуле:


Процедура ОбработатьДокумент(СсылкаНаДокумент) Экспорт


Док = СсылкаНаДокумент.ПолучитьОбъект();


// Работа с документом


КонецПроцедуры

Можно ли вызвать процедуру из общего модуля в фоновом задании?

Да, но учитывайте:

  • Если модуль не глобальный, его нужно подключить через #Использовать в модуле фонового задания.
  • Фоновые задания выполняются на сервере, поэтому клиентские процедуры в них не работают.
  • Для долгих операций используйте ПриостановитьОбработку(), чтобы не блокировать сервер.
Как узнать, какие процедуры доступны для вызова в общем модуле?

Откройте модуль в конфигураторе и:

  1. Нажмите Ctrl+Shift+F для поиска по тексту модуля.
  2. Или воспользуйтесь панелью Процедуры и функции (вид → Процедуры и функции).
  3. Отфильтруйте список по ключевому слову Процедура или Функция.

Обратите внимание: в списке будут только те процедуры, которые помечены как Экспорт.