Виды модулей

Глобальный модуль – определяет глобальный контекст задачи.

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

Модуль формы группы справочника – запускается при открытии формы группы справочника.

Модуль формы элемента справочника – запускается при вводе значения элемента.

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

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

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

Формат программного модуля

ПМ состоит из операторов и комментариев. Комментарий начинается с двойной наклонной черты (//). Оператор заканчивается символом точка с запятой (;). Операторы подразделяются на операторы объявления переменных и на исполняемые операторы.

Исполняемый оператор может иметь метку, являющейся точкой перехода в операторе Перейти.

Метка начинается с символа ~.

Пример:

~ метка А=В;

Структура программного модуля

ПМ состоит из следующих разделов:

• раздел определения переменных;

• раздел процедур и функций;

• раздел основной программы.

Специальные символы, используемые в контексте модуля:

| – вертикальная черта в начале строки используется только в строковых константах – означает, что данная строка является продолжением предыдущей;

() – в круглые скобки заключается, список параметров методов, процедур и функций;

[] – в квадратные скобки заключается значение размерности массива;

“” – в кавычки заключаются строковые константы;

‘’ – в апострофы заключаются константы дат;

. – точка является разделителем в описаниях агрегатных типов данных.

Объявление переменных

Для объявления переменной используется следующий синтаксис:

Перем <Имя_перем> [<размерность>] [Экспорт]

Пример фрагмента модуля:

Перем Результат;

Перем Массив_Результатов [20];

Управляющие операторы Условный оператор

Для условного оператора используется следующий синтаксис:

Если <логическое выражение> Тогда

// операторы;

[ИначеЕсли < логическое выражение > Тогда] // операторы;

[Иначе]

// операторы;

КонецЕсли;

Пример фрагмента модуля:

Если ДатаК < ДатаН Тогда

ДатаК = ДатаН;

ИначеЕсли ДатаК > ПолучитьДатуТА() Тогда

ДатаК = ПолучитьДатуТА();

КонецЕсли;

Если конечная дата меньше начальной, то переменной ДатаК присваивается значение начальной даты, в противном случае конечная дата сравнивается с результатом работы функции ПолучитьДатуТА() (функция возвращает дату точки актуальности) и, если условие выполняется, переменной ДатаК присваивается значение точки актуальности.

Оператор цикла Для

Для данного оператора цикла используется следующий синтаксис:

Для <имя перем> = <выражение1> По <выражение2> Цикл

// операторы;

КонецЦикла;

Пример фрагмента модуля:

Выв=СоздатьОбъект(“Текст”);

Выв.Открыть (“имя файла”);

Для i=1 по Выв.КоличествоСтрок() Цикл

Сообщить (Выв.ПолучитьСтроку(i));

КонецЦикла;

Пример демонстрирует вывод всех строк текста, содержащегося в объекте агрегатного типа Текст.

Оператор цикла Пока

Синтаксис оператора выглядит следующим образом:

Пока < логическое выражение > Цикл

// операторы;

КонецЦикла;

Циклическое повторение операторов, находящихся внутри конструкции, выполняется, пока логическое выражение – истина.

Пример использования цикла:

ВыбратьСтроки();

Пока ПолучитьСтроку()=1 Цикл

Регистр.Доставка.Товар=Товар;

Регистр.Доставка.Сумма=Сумма;

Регистр.Доставка.ДвижениеПриходВыполнить();

КонецЦикла;

Метод ВыбратьСтроки открывает выборку строк табличной части документа. В качестве логического выражения используется метод ПолучитьСтроку, который возвращает число 1, пока строки в выборке есть. Таким образом, для каждой табличной строки выполняются действия, связанные с занесением значений реквизитов Товар и Сумма в соответствующие параметры регистра Доставка.