6.9 Только определения процедур и функций может содержать следующий вид модуля

❓ 6.9 Только определения процедур и функций может содержать следующий вид модуля:

📚 Документация

• ИТС: Руководство разработчика — 4.2.3. Виды программных модулей https://its.1c.ru/db/v8327doc#bookmark:dev:TI000000123

• ИТС: Руководство разработчика — 4.2.4. Формат программного модуля https://its.1c.ru/db/v8327doc#bookmark:dev:TI000000132

---

🧠 Краткая теория

В общем случае программный модуль может включать три раздела:

1. раздел определения переменных;
2. раздел процедур и функций;
3. раздел основной программы — тело модуля.

Только раздел процедур и функций предусмотрен для следующих модулей:

• модуля сеанса;
• общего модуля;
• модуля менеджера объекта;
• модуля команды.

Назначение модулей

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

Модуль сеанса

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

Код обработчика выполняется на сервере в привилегированном режиме. Модуль сеанса может содержать только неэкспортируемые процедуры и функции.

Процедура УстановкаПараметровСеанса(
        ТребуемыеПараметрыСеанса)

    // Инициализация параметров сеанса

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

Вызов УстановкаПараметровСеанса выполняется до обработчика ПередНачаломРаботыСистемы модуля управляемого приложения и до ПриНачалеРаботыСистемы модуля внешнего соединения.

Общий модуль

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

Модуль менеджера объекта

Модуль менеджера позволяет добавлять методы, относящиеся не к отдельному экземпляру объекта, а ко всему виду объектов.

Например, метод модуля менеджера справочника Контрагенты может быть вызван через менеджер этого справочника:

Функция ПолучитьСписокДебиторов() Экспорт

    // Формирование списка

КонецФункции

Вызов метода:

Дебиторы =
    Справочники.Контрагенты.ПолучитьСписокДебиторов();

Для обращения процедура или функция должна быть объявлена с ключевым словом Экспорт.

Модуль команды

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

Точкой начала выполнения является клиентский обработчик ОбработкаКоманды:

&НаКлиенте
Процедура ОбработкаКоманды(
        ПараметрКоманды,
        ПараметрыВыполненияКоманды)

    // Выполнение команды

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

Из клиентского обработчика можно вызывать серверные процедуры этого же модуля:

&НаСервере
Процедура ВыполнитьНаСервере()

    // Серверная часть команды

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

В модуле команды разрешено указывать ключевое слово Экспорт, но обратиться к такому методу из другого программного модуля нельзя.

🧠 Ключевая мысль

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