Стандарт разработки: №455. Структура модуля

Данные > Статьи и инструкции > Инструкция

ИНСТРУКЦИЯ 1С 8 → перейти в меню [СТАТЬИ И ИНСТРУКЦИИ]

Шаблон (заготовка для копирования) разделов для общих модулей в 1С 8.3:

#Область ПрограммныйИнтерфейс
  // Код процедур и функций
#КонецОбласти

#Область СлужебныйПрограммныйИнтерфейс
  // Код процедур и функций
#КонецОбласти

#Область СлужебныеПроцедурыИФункции
  // Код процедур и функций
#КонецОбласти

Раздел «Программный интерфейс» содержит экспортные процедуры и функции, предназначенные для использования другими объектами конфигурации или другими программами (например, через внешнее соединение).

Раздел «Служебный программный интерфейс» предназначен для модулей, которые являются частью некоторой функциональной подсистемы. В нем должны быть размещены экспортные процедуры и функции, которые допустимо вызывать только из других функциональных подсистем этой же библиотеки.

Раздел «Служебные процедуры и функции» содержит процедуры и функции, составляющие внутреннюю реализацию общего модуля. В тех случаях, когда общий модуль является частью некоторой функциональной подсистемы, включающей в себя несколько объектов метаданных, в этом разделе также могут быть размещены служебные экспортные процедуры и функции, предназначенные только для вызова из других объектов данной подсистемы.

Для объемных общих модулей рекомендуется разбивать этот раздел на подразделы, по функциональному признаку. Например:

#Область ОбновлениеИнформационнойБазы
// Код процедур и функций
#КонецОбласти

Шаблон оформления разделов для модулей объектов, менеджеров в 1С 8.3:

#Область ОписаниеПеременных

#КонецОбласти

#Область ПрограммныйИнтерфейс
  // Код процедур и функций
#КонецОбласти

#Область ОбработчикиСобытий
  // Код процедур и функций
#КонецОбласти

#Область СлужебныйПрограммныйИнтерфейс
  // Код процедур и функций
#КонецОбласти

#Область СлужебныеПроцедурыИФункции
  // Код процедур и функций
#КонецОбласти

#Область Инициализация

#КонецОбласти

Раздел «Программный интерфейс» содержит экспортные процедуры и функции, предназначенные для использования в других модулях конфигурации или другими программами (например, через внешнее соединение). Не следует в этот раздел помещать экспортные функции и процедуры, которые предназначены для вызова исключительно из модулей самого объекта, его форм и команд. Например, процедуры заполнения табличной части документа, которые вызываются из обработки заполнения в модуле объекта и из формы документа в обработчике команды формы не являются программным интерфейсом модуля объекта, т.к. вызываются только в самом модуле и из форм этого же объекта. Их следует размещать в разделе «Служебные процедуры и функции».

Раздел «Обработчики событий» содержит обработчики событий модуля объекта (ПриЗаписи, ПриПроведении и др.)

Раздел «Служебный программный интерфейс» имеет такое же предназначение, как и в общих модулях.

Раздел «Служебные процедуры и функции» имеет такое же предназначение, как и в общих модулях.

Шаблон оформления разделов для модулей форм в 1С 8.3:

#Область ОписаниеПеременных

#КонецОбласти

#Область ОбработчикиСобытийФормы
  // Код процедур и функций
#КонецОбласти

#Область ОбработчикиСобытийЭлементовШапкиФормы
  // Код процедур и функций
#КонецОбласти

#Область ОбработчикиСобытийЭлементовТаблицыФормы
  // Код процедур и функций
#КонецОбласти

#Область ОбработчикиКомандФормы
  // Код процедур и функций
#КонецОбласти

#Область СлужебныеПроцедурыИФункции
  // Код процедур и функций
#КонецОбласти

Раздел «Обработчики событий формы» содержит процедуры-обработчики событий формы: ПриСозданииНаСервере, ПриОткрытии и т.п.

Раздел «Обработчики событий элементов шапки формы» содержит процедуры-обработчики элементов, расположенных в основной части формы (все, что не связано с таблицами на форме).

В разделах «Обработчики событий элементов таблицы формы <имя таблицы формы>» размещаются процедуры-обработчики таблиц формы и элементов таблиц. Для процедур-обработчиков каждой таблицы должен быть создан свой раздел.

Раздел «Обработчики команд формы» содержит процедуры-обработчики команд формы (имена которых задаются в свойстве Действие команд формы).

Раздел «Служебные процедуры и функции» имеет такое же предназначение, что и в общих модулях.

Шаблон оформления разделов для модулей команд в 1С 8.3:

#Область ОбработчикиСобытий
// Код процедур и функций
#КонецОбласти

#Область СлужебныеПроцедурыИФункции
// Код процедур и функций
#КонецОбласти

Раздел «Обработчики событий» содержит процедуру-обработчик команды ОбработкаКоманды.
Раздел «Служебные процедуры и функции» имеет такое же предназначение, что и в общих модулях.

комментарии

____________________

Перепечатка текста и фотографий разрешена при наличии прямой ссылки на источник