Общий модуль
Общие модули содержат общие алгоритмы, которые могут вызываться из других модулей.
- доступен только раздел описания процедур и функций (нельзя описывать переменные и программы).
- режимы компиляции определяются опциями общего модуля
- не требуется указывать директивы компиляции вначале процедур и функций, и хотя они не вызывают ошибок компиляции, использование директив &НаСервереБезКонтекста и &НаКлиентеНаСервереБезКонтекста сделает процедуру или функцию недоступной для любых серверных вызовов.
- управлять компиляцией отдельных фрагментов модуля следует инструкциями препроцессора #ЕСЛИ #ИНАЧЕ #КОНЕЦЕСЛИ
Опции Общего модуля
- Глобальный — объявленные в модуле экспортные методы будут доступны за пределами модуля напрямую без указания имени модуля, глобальный модуль компилируется при старте системы, поэтому увеличивает время старта системы.
- Опции компиляции и доступности
- Клиент (управляемое приложение) — модуль будет скомпилирован и доступен на Клиенте
- Сервер — модуль будет скомпилирован и доступен на Сервере
- Внешнее соединение — модуль будет скомпилирован и доступен при Внешнем соединении
- Вызов сервера — делает экспортные процедуры и функции доступными для вызова из модулей исполняемых на Клиенте, предполагает возможность двунаправленного XDTO преобразования параметров и возвращаемых значений (см. подробней Передача параметров и возвращаемых значений ниже).
- Привилегированный — применим только к модулям на Сервере, отменяет контроль доступа к объектам данных, что существенно увеличивает скорость выполнения, особенно при горизонтальном разграничении доступа к записям таблицы.
- Повторное использование возвращаемых значений — позволяет ускорить выполнение функций неглобального общего модуля путем оптимизации XDTO преобразования параметров повторяющихся вызовов.
Вызов метода общего модуля
Вызов методов общего модуля из других модулей возможен, если они были определены экспортными и область компиляции метода соответствует вызывающему методу. Пример непосредственного вызова метода общего модуля:
Пример косвенного вызова метода общего модуля:
Модуль объекта
Основное назначение модуля — обрабатывать события записи объекта где и как бы оно не возникло, в т.ч. программно, а также расширять набор методов объекта.
- присутствует у Справочников, Документов, Отчетов, Обработок, ПВХ
- отсутствует у Констант, Перечислений, Журналов, Внешних источников данных
- у Регистров аналогичную роль выполняет Модуль Записи
- переменные объявленные как Экспорт доступны у объекта как реквизиты <объект>.<Переменная>, но в отличие от реквизита она не сохраняется при записи
- процедуры и функции описанные как Экспорт доступны у объекта как методы <объект>.<Процедура>(<параметры>)
- по неизвестной причине доступ к переменным и методам у Обработок не действует
Примеры
Пример описания переменной, конструктора объекта, экспортной функции и пример вызова:
Модуль менеджера
Модуль предназначен для описания общих статических процедур и функций применимых к прикладному типу без контекста отдельного элемента семейства. Модуль менеджера похож на Общий модуль, но инкапсулирован в своем прикладном типе.
- присутствует у Справочников, Документов, Журналов, Перечислений, Отчетов, Обработок, ПВХ, Регистров, Бизнес-процессов, Задач
- отсутствует у Внешних источников данных
- доступность обеспечивается только из модулей на Сервере
- могут при необходимости получить объект или ссылку в параметре вызова
Примеры
Пример описания статической экспортной функции и ее вызов из другого модуля , где эти типы доступны (на Сервере). :
Модуль менеджера значения
Основное назначение модуля — обрабатывать события записи константы.
Модуль формы
Очень похож на Общий модуль, но инкапсулирован в форму, поэтому ему доступны реквизиты данных, реквизиты формы, элементы формы и статические переменные.
- компиляция по умолчанию выполняется на Сервере, но отдельные фрагменты модуля могут устанавливать другую область компиляции директивами компиляции
- НаКлиенте
- реквизиты объекта формы доступны через Объект.<Реквизит>
- реквизиты формы доступны непосредственно по имени <Реквизит>
- элементы формы доступны через Элементы.<Элемент>
- статические переменные существуют только на время обработки события формы, а затем удаляются
- реквизиты объекта формы доступны через Объект.<Реквизит>
- реквизиты формы доступны непосредственно по имени <Реквизит>
- элементы формы на Сервере недоступны
- статические переменные существуют только на время вызова метода на Сервере, а затем удаляются
- данные реквизитов при каждом вызове НаКлиенте->НаСервере и возврате НаСервере->НаКлиенте все (целиком в полном объеме) проходят через XDTO сериализацию
- доступные методы реквизитов на Клиенте и на Сервере отличаются
Модуль набора записей
Модуль команды
Временный динамический модуль
Временный динамический модуль создается платформой при использовании оператора Выполнить() :
- временный модуль создается и компилируется в контексте текущего модуля и процедуры
- модулю доступны все объекты доступные в текущем модуле (включая элементы, реквизиты и объект формы, модули и объекты конфигурации)
- модулю доступны все параметры и локальные переменные текущей процедуры
- декларация переменной оператором Перем вызовет ошибку
- ошибка без обработки исключения вызовет сообщение аналогичное обычной ошибке в модуле и прерывание выполнения
- ошибка в обработчике исключения имеет возможность получить описание ошибки через ИнформацияОбОшибке()
- текст описания ПодробноеПредставлениеОшибки(ИнформацияОбОшибке()) содержит больше сведений, но в менее удобной форме
Разделы модулей
- объявления переменных (кроме общих модулей)
- процедур и функций
- основной программы (кроме общих модулей)
Директивы компиляции и выполнения
Пять директив определяют область исполнения функций и процедур. Их следует применять только в коде модулей управляемых форм и в коде модулей команд, в остальных модулях рекомендуется применять инструкции препроцессора.
- директива должна предшествовать каждому определению в модуле
- по умолчанию действует директива &НаСервере
- директива &НаСервереБезКонтекста имеет смысл только в формах (чей контекст директива подразумевает)
- определение в общем модуле с директивой &НаСервере в общем модуле имеет
- директива &НаСервереНаКлиенте применяется только в коде модулей команд
- приведенный в таблице порядок директив соответствует иерархии доступности, так функции и процедуры определенные с некоторой директивой имеют доступ к процедурам и функциям определенным с той же директивой, либо с любой директивой следующей ниже, но не имеют доступа к определенным с предшествующей директивой
- определениям с директивой &НаКлиенте доступны все определения на Клиенте и все определения на Сервере, для которых предусмотрен серверный вызов
- определениям с директивой &НаКлиентеНаСервереБезКонтекста доступны определения только с такой же директивой
Инструкции препроцессора
Инструкции препроцессора управляют включением и исключением фрагментов модуля прежде чем он будет скомпилирован для выполнения, все инструкции препроцессора и исключенные ими фрагменты кода отсутствуют в коде передаваемом компилятору модуля.
Предусмотрены четыре инструкции
- #Если <Логическое выражение> Тогда
- #ИначеЕсли <Логическое выражение> Тогда
- #Иначе
- #КонецЕсли
- <Логическое выражение> = [НЕ] <Символ препроцессора> [<Булева операция> [НЕ] <Символ препроцессора> [<Булева операция> [НЕ] <Символ препроцессора>]…]
- <Символ препроцессора> = <НаКлиенте | НаСервере | ТолстыйКлиентОбычноеПриложение | ТолстыйКлиентУправляемоеПриложение | Клиент | Сервер | ВнешнееСоединение >
<Булева операция> =
Области
Области дают возможность выделять произвольные области кода, группировать и сворачивать их в окне редактора модуля и служат только для облегчения работы разработчика над исходным кодом большого объема. Инструкции определения Области относятся к препроцессору, хотя они не влияют ни на работу препроцессора, ни на дальнейшую компиляцию модуля, поскольку перед компиляцией они полностью исключаются из кода.
Области выделяются с помощью двух инструкций препроцессора #Область и #КонецОбласти :
- <имя области> должно соответствовать общим требованиям к именам переменных (не может начинаться с цифры, содержать пробелы, знаки и символы и т.п.).
- области могут быть вложены друг в друга или в другие группируемые конструкции языка.
- это возможно, но 1С не рекомендует разрывать областями отдельные грамматические конструкции, выражения, а также объявления и места вызова процедур и функций:
Области типовых конфигураций 1С:
- Модуль объекта
- ПрограммныйИнтерфейс
- ОбработчикиСобытий
- СлужебныеПроцедурыИФункции
- ИнициализацияИЗаполнение
- Прочее
- ПрограммныйИнтерфейс
- ОбработчикиСобытий
- СлужебныеПроцедурыИФункции
- СлужебныйПрограммныйИнтерфейс
- Обеспечение
- НаправленияДеятельности
- Проведение
- Отчеты
- Печать
- ШаблоныСообщений
- Прочее
- ТекущиеДела
- ОбновлениеИнформационнойБазы
- ФормированиеГиперссылкиВЖурналеДокументыПродажи
- Назначения
- ОписаниеПеременных
- ОбработчикиСобытийФормы
- ОбработчикиСобытийЭлементовШапкиФормы
- ОбработчикиСобытий
- ОбработчикиСобытийЭлементовТаблицыФормыТовары
- ОбработчикиКомандФормы
- СлужебныеПроцедурыИФункции
Предопределенные Объекты конфигурации
В модулях используются объекты данных с предопределенными именами
ЭтаФорма
- Используется в модуле формы в процедурах &НаКлиенте и &НаСервере для обращения к элементам формы и реквизитам
- Пример обращения к элементу формы через объект Элементы: ЭтаФорма.Элементы.НомерВерсии.Заголовок = ‘My God!’;
- Пример обращения к реквизиту формы: ЭтаФорма.ТекстОбъявления=’Hello!’;
- В модуле формы ключевое слово ЭтаФорма необязательно и допускается: Элементы.НомерВерсии.Заголовок = ‘My God!’;
- Описанные выше способы применимы только к простым типам
- Для сложных типов (ТаблицаЗначений, ДеревоЗначений) обращение приводит к объекту типа ДанныеФормыКоллекция
- Для получения значения объекта формы сложного типа применяется метод: <переменная>=РеквизитФормыВЗначение(<ИмяРеквизита>);
- Для установки значения объекта формы сложного типа применяется: ЗначениеВРеквизитФормы(<Значение>, <ИмяРеквизита>);
- Функции РеквизитФормыВЗначение() и ЗначениеВРеквизитФормы() доступны только на Сервере.
Объект
- Является именем основного реквизита управляемой формы, который хранит данные ИБ открытые в управляемой форме, например: Объект.Ссылка;
- Имя реквизита Объект может быть изменено, но делать это не принято.
- Полный формат: ЭтаФорма.Объект.Ссылка;
ЭтотОбъект
- Указывает на объект формы для доступа к реквизитам формы
- Допускает только чтение
- Доступен для Сервер, Толстый клиент, Внешнее соединение
Запись
В модуле записи регистра.
Элементы
Коллекция Элементы В модуле формы НаКлиенте содержит все элементы формы
- Элементы.<имя элемента>
- Элементы(«<имя элемента>»)
- ?Получить значение элемента ни свойством, ни методом нельзя
Аннотации расширения модулей
Три аннотации позволяют определить перехват порядка вызова типовых методов новыми методами.
- &Перед — перехватчик будет выполнен до того, как начнётся выполнение типового метода.
- &После — перехватчик будет выполнен после того, как выполнится типовой метод.
- &Вместо — реализует возможность полного перекрытия типового метода (типовой метод вообще не будет выполнен)
- в методе-перехватчике в произвольном месте можно вызвать типовой метод вызовом ПродолжитьВызов().
Источник: Расширение модулей //wonderland.v8.1c.ru
Объекты модулей
Модули конфигурации являются объектами, процедуры и функции тоже.
Передача параметров и возвращаемых значений
Для характеристики типов значений в 1С используется понятие мутабельность (от англ. Mutable — изменчивый), которое нуждается в разъяснении. Немутабельными типами являются простые типы (Число, Строка, Дата, Булево, Цвет, Ссылка), для которых определены пустые значения. Мутабельными типами являются сложные типы (Структура, Массив, СписокЗначений, ТаблицаЗначений, ДеревоЗначений, Объект, Форма и т.п.), свойства которых могут быть изменены после создания, а проверка на пустое значение лишена смысла.
Мутабельные значения 1с что это
Иногда в технической документации встречается понятие «мутабельный тип». Например, в описании функции ЗначениеЗаполнено (ValueIsFilled) мы встречаем:
Функция проверяет, отличается ли переданное значение от значения по умолчанию того же типа.
Не работает с мутабельными значениями. При передаче мутабельного значения функция вызывает исключение.И возникает вопрос, а что такое «мутабельное значение»?
Мутабельный тип (от англ. Mutable — изменчивый) — сложный тип данных (как правило — объекты), который после своего создания допускает изменение своих свойств.
Проверка мутабельных значений на заполненность
Данная ошибка характерна для 1С 8 версии, преимущественно проявлялась при переходе с версии 8.1. Раньше в типовых конфигурациях была встроенная глобальная функция НеЗаполнено(), которая умела проверять более продумано, но не медленнее и не так универсально. Замена ее на встроенную провоцировало такие ошибки.
Сейчас ошибка возникает, когда переменной неопределенного(произвольного) типа, присваивается значение, которое невозможно проверить на заполненность.
Полное сообщение ошибки:
Проверка мутабельных значений на заполненность не поддерживается
Причина этой ошибки кроется в некорректном типе переменных:
- Имя общего модуля (в моём случае совпадало с именем переменной)
- Форма
- Элементы формы
- ТаблицаЗначений, СписокЗначений, ДеревоЗначений
- Com-объект
- Другие сложные типы, не связанные с данными системы кроме примитивных (дата, строка, число)
Исправление ошибки
Заключается изменении программного кода для отсутствии такой проверки:
- отсутствие такого типа для данной переменной
- добавление дополнительной проверки на тип: например
Если ТипЗнч(МояПеременная)<>Тип(«ОбщийМодуль») и ЗначениеЗаполнено(МояПеременная) Тогда
Мода имеет такое же отношение к оригинальности, как любая другая реклама к товару.
— Стас Янковский
Ошибка «Проверка мутабельных значений на заполненность не поддерживается»
Ошибка возникает при попытке использования функции ЗначениеЗаполнено() для проверки заполнения объекта агрегатного типа.
К таким объектам относятся программные объекты типа:
- СправочникОбъект, СправочникСписок, СправочникВыборка, ДокументОбъект, ДокументСписок, ДокументВыборка и т.п.;
- ОбработкаОбъект, ОтчетОбъект и т.п.
- ТабличныйДокумент, ТекстовыйДокумент, ДиаграммаГанта и т.п.;
Указанные объекты поддерживают только сравнение со значением Неопределено :
- СлужебныйПрограммныйИнтерфейс