88
2.3.3 Структурная схема пакета (дерево вызова процедур и программ)
Технология внутримашинной организации создается последовательностью
разработанных процедур - схем взаимосвязи программных модулей и
информационных массивов. Подобная схема представляет собой разбиение
общего процесса решения задачи на отдельные процедуры преобразования
массивов, называемые модулями (это - ввод, контроль, перезапись информации с
одного МН на другой, сортировка, уплотнение данных, редактирование,
накопление, вывод на печать и т.п.).
Основываясь на результатах, полученных при разработке дерева функций и
сценария диалога, построим дерево программных модулей, отображающее
структурную схему пакета, содержащей программные модули разных классов.
Для создания встроенного текста были созданы модули приложений. Эти модули
расположены в разных местах конфигурации и имеют разное призвание. Большее
количество модулей прикрепляется к указанным объектам конфигурации или к
самому решению приложения. Эти модули называются в нужный момент
применения.
Так, если модуль, содержит какой то код, то этот код будет выполнен и
работа прикладного решения продолжена. Эти модули могут содержать
процедуры обработки событий, определенные для различных объектов
прикладного решения. Эти процедуры будут проводиться в момент проведения
мероприятия.
В сотрудничестве с модулями приложений существуют модули совместной
работы, которые не используются в процессе применения. Они служат только для
89
размещения в них текстовых функций и процедур, которые могут вызываться из
других модулей прикладного решения.
Таким образом, код, находящийся в этих общих модулях, будет
выполняться только при явном доступе к нему из другого модуля конфигурации
или интерфейса управления.
Общий модуль задания будет доступен для всех программных модулей. Он
появляется с помощью значений свойств и методов глобального модуля,
системных перечислений и наборов системных значений. Как правило, связь
между модулями выражается в схеме, представленной на рис. 2.28.
Рис. 2.28 Структурная схема пакета
Каждый модуль связан с оставшейся частью конфигурации, и такая связь
называется контекстом выполнения данного модуля. Контекст определяется
набором доступных для модуля объектов, переменных, процедур и функций
(таблица 2.7).
Таблица № 2.7
90
Таблица «Описания функций модулей»
№
п/п
Наименование модуля
Функции модуля
1.
Глобальный модуль
Содержит глобальные процедуры и функции,
предопределенные процедуры, процедуры и
функции, которые необходимо выполнить при
запуске системы «1С:Предприятие 8».
2.
Модуль справочника
«Группы товаров»
Содержит предопределенные процедуры формы
списка и элемента справочника
3.
Модуль справочника «Товары»
Содержит предопределенные процедуры формы
списка и элемента справочника
4.
Модуль справочника
«Контрагенты»
Содержит предопределенные процедуры формы
списка и элемента справочника
№
п/п
Наименование модуля
Функции модуля
5.
Модуль справочника
«Реализация»
Содержит предопределенные процедуры формы
списка и элемента справочника
6.
Модуль отчета «Счетфактура»
Содержит предопределенные процедуры формы
списка и элемента справочника
7.
Модуль отчета
«С параметрами»
Содержит предопределенные процедуры формы
списка и элемента справочника
2.3.4 Описание программных модулей
Общий модуль
Конфигурация может определять случайное количество общих модулей,
включая ни одного. Контекст общего модуля создается в общем и локальном
контексте самого общего модуля, то есть с помощью процедур и функций,
определенных на рис. 2.29.
Поскольку общий модуль не используется непосредственно системой, он не
содержит ни раздела описания переменных, ни раздела основной программы.
Общий модуль определяет процедуры и функции.
Если процедуры или функции общего модуля определены как
экспортируемые, они являются частью массового контекста и доступны для всех
модулей приложений.
91
Поскольку общий модуль не "связан" с объектом конфигурации, но связан
со всем решением приложения, во всех модулях различны имена экспортируемых
переменных, процедур и функций. В противном случае будет создана
синтаксическая ошибка, так как глобальный модуль будет содержать
повторяющиеся имена.
Модуль приложения.
В конфигурации есть один модуль приложения. Контекст модуля
приложения будет образовываться [14] (рис. 2.30):
• Глобальным модулем, включающим экспортируемые функциями и
процедуры общих модулей;
• Локальным контекстом модуля приложения.
Выполняется при запуске системы или при доступе к приложению в
качестве сервера автоматизации. Этот модуль необходим для обработки действий,
связанных с временем работы конечного пользователя. Кроме описанных
переменных и основной программы, модуль приложения обычно содержит
описание процедур-обработчиков событий, связанных с сеансом пользователя и
прикладным решением в целом.
Рис. 2.29 Контекст общего модуля
92
Ключевыми событиями, обрабатываемыми в модуле приложения,
считаются события начала и завершения работы приложения. Схема вызова
представлена на рис.2.31. [14]
Событие ПередНаломРаботыСистемы появляется во время запуска
системы перед открытием главного окна. При обработке этого события у
дизайнера есть возможность не запустить систему, если условия не выполнены.
Необходимо учитывать, так как это событие вызывается в момент, когда ключевое
окно программы еще не открыто, больше невозможно выполнять действия,
которые требуют главного окна.
Событие ПриНачалеРаботыСистемы появляется при запуске системы.
Разработчик уже не может отказаться от запуска системы, но может выполнять
действия, которые обязательно должны быть выполнены при начале работы
пользователя системы (например открыть форму, содержащую справочную
информацию и т.д.)
Событие ПередЗавершениемРаботыСистемы появляется при завершении
работы системы до момента закрытия главного окна. Обрабатывая это событие,
дизайнер имеет возможность отказаться от завершения, если условия не
выполнены.
Событие ПриЗавершенииРаботыСистемы появляется после завершения
работы системы после закрытия главного окна. В менеджере событий разработчик
больше не может отказывать в закрытии приложения, но может выполнять
действия, которые должны быть выполнены в конце пользователя.
Рис. 2.30 Контекст модуля приложения
93
Модуль объекта
Всякий прикладной объект конфигурации, данные которого имеют все
шансы быть изменены, содержит личный модуль. Такой модуль используют при
создании объектов встроенного языка, которые позволяют модифицировать
данные объектов конфигурации. Соответствующие объекты встроенного языка
создаются, например, при введении нового объекта, при копировании, при
получении данных существующего объекта и т.д. для различных объектов
конфигурации этот модуль имеет различные имена.
Рис. 2.31 Последовательность вызова событий модуля приложения
Контекст модуля объекта создается [14]:
• глобальный контекст, включая экспортируемые функции
и
процедуры общих модулей (в зависимости от места создания объекта);
• процедуры и функции модуля применения или
внешнего
подключения (в зависимости от места создания объекта);
• свойства и методы встроенного языкового объекта, контекст
ПередНа
чаломРаботыСистемы
ПриНачалеРаботыСистемы
ПередЗаРавершениемботыСистемы
ПриЗавершенииРаботыСистемы
Модуль приложения
Открытие главного окна
программы
Закрытие главного окна
программы
94
которого распространяется на модуль;
• информация об объекте конфигурации, к которому принадлежит
модуль;
• локальный контекст самого объекта.
Когда переменные, процедуры и функции модуля объекта определяются
как экспортируемые, они будут доступны в качестве свойств и методов
соответствующих объектов встроенного языка.
Не считая описания переменных и основной программы, модуль объекта
имеет описание процедур-обработчиков событий, связанных с данным объектом.
Состав этих событий варьируется в зависимости от объекта – ПередЗаписью и
ПриЗаписи. Последовательность их вызова определена на рис. 2.32.
Событие ПередЗаписью вызывается для записи данных, а затем для начала
операции регистрации, но до сохранения данных в базе данных. В обработчике
этого события разработчик может отказаться от записи данных, если например,
не выполнены требуемые условия.
Событие ПриЗаписи вызывается во время выполнения записи данных в базу
данных, но до завершения операции регистрации. В обработчике этого события
разработчик может отказаться от записи данных, если, например, в результате
записи этих данных в базу нарушаются какие-либо условия.
Модуль формы.
Любая форма, определяемая в конфигурации, имеет свой модуль. Этот
модуль выполняется при создании объекта Форма встроенного языка. Этот объект
создается при открытии формы прикладного объекта (например, при открытии
формы элемента справочника) или явно получается средствами встроенного
языка. Контекст модуля формы образуется:
• Глобальным контекстом, включающим экспортируемыми функциями и
процедурами общих модулей (если для этих модулей установлено хотя
бы одно из свойств Клиент или Сервер);
95
• Экспортируемыми переменными, процедурами и функциями модуля
приложений;
• Свойствами и методами объекта, который назначен основным
реквизитом формы, включая экспортируемые переменные, процедуры и
функции, определённые в модуле этого объекта;
• Свойствами и методами расширения формы, определяемого основным
реквизитом формы;
• Свойствами и методами объекта Форма встроенного языка;
• Реквизитами формы, которой «принадлежит» модуль; Локальным
контекстом самого модуля формы.
Рис. 2.32 Последовательность вызова событий модуля объекта
Если переменные, процедуры и функции модуля формы определены как
экспортируемые, они доступны как свойства и методы соответствующих объектов
Встроенная языковая форма.
Не считая описания переменных и ведущей программы, модуль формы
имеет описание процедур-обработчиков событий, связанных с формой.
Основными событиями, обработанными в модуле формы, являются события
открытия и закрытия формы. Последовательность их вызова показана на рис
2.33.
Модуль объекта
ПередЗаписью
ПриЗаписи
Транзакция
записи
Запись данных
96
Событие ПередОткрытием появляется, когда форма открыта перед тем, как
открыть окно пользователю. Изменения значений информации о форме,
сделанные в этом менеджере, не приводят к установке изменения формы, что
позволяет определить исходные значения и инициализировать важную
информацию.
Рис. 2.33 Последовательность вызова событий модуля формы В
обработчике представленного действия создатель имеет
возможность отречься как от открытия формы, так и от выполнения стандартных
действий при открытии формы, в случае если, к примеру, будут не выполнены
необходимые условия. Стандартный набор действий, выполняемых в дальнейшем
действием ПередОткрытием и до события ПриОткрытии, отличается от форм и
определяется расширением фигуры, соответствующей основной части формы.
Так, для формы объекта справочника после события ПередОткрытием будет
выполнена процедура генерации нового кода справочника (если это необходимо)
и, также, будет вызван обработчик события ПриУстановкеНовогоКода.
Событие ПриОткрытии оявляется, когда форма открыта перед тем, как
открыть окно пользователю. Это событие необходимо для выполнения действий,
которые должны выполняться только в том случае, если форма, вероятно,
открыта. В отличие от процедуры ПередОткрытием, изменение значений
информации о форме в этом менеджере позволяет установить изменение формы.
Модуль формы
ПередОткрытием
ПриОткрытии
ПередЗакрытием
ПриЗакрытии
Открытие окна
формы
Закрытие окна
формы
97
Событие ПередЗакрытием появляется при закрытии формы до закрытия
окна формы. В обработчике этого события разработчик может отказаться как от
закрытия формы, так и от выполнения стандартных действий при закрытии
формы, если, например, не выполнены требуемые условия. Стандартный набор
действий, выполненных после выполнения действий ПередЗакрытием, также
отличается для всех видов форм и определяется расширением соответствующей
формы до основной части формы. Так, если документ был изменен, одним из
стандартных действий станет запрос сохранения изменений перед закрытием
формы.
Событие ПриЗакрытии появляется при закрытии формы после закрытия
окна формы. В обработчике этого события можно создать метод, который будет
выполняться, если форма, вероятно, закрыта.
В качестве примера рассмотри модуль формирования отчета «С
параметрами». При вызове модуля создается отчет обо всех запросах,
отсортированных по отделам. Развернутая блок – схема представлена на рисунке
2.34.