Модульная разработка

Проект состоит из элементов, но в функциональном смысле он разделен на изолированные части, каждая из которых может использоваться в других частях проекта.

Для выделения изолированных частей используйте подсистемы (свойства) и пакеты. Внутрь подсистем и пакетов добавляйте элементы: справочники, перечисления, интерфейсные компоненты, модули и т. д.

Стандартно внутри одной подсистемы вы можете использовать только элементы этой подсистемы. Элементы других подсистем недоступны вам без дополнительных действий.

Чтобы элементы подсистемы Б использовать в подсистеме А, выполните следующие действия:

Область видимости элемента проекта

У любого элемента проекта есть свойство ОбластьВидимости со значениями:

  • ВПодсистеме — элемент виден внутри своей подсистемы во всех пакетах. Значение по умолчанию;
  • ВПроекте — элемент виден во всех подсистемах своего проекта;
  • Глобально — элемент виден в других проектах.

Стандартно элемент виден только внутри своей подсистемы (ВПодсистеме) и недоступен в других подсистемах. Если вам хочется использовать этот элемент в других подсистемах или в других проектах, нужно установить у него область видимости в значение ВПроекте или Глобально. 

ВидЭлемента: КомпонентИнтерфейса
Имя: ДемонстрационноеПриложение
Id: 76eb6f8f-e340-42ed-8dad-7a1104a6da02
ОбластьВидимости: ВПроекте

Тем самым вы сделаете элемент публичным, т. е. он может быть доступен в других подсистемах.

Видимость языковых конструкций

Переменным, методам, перечислениям, структурам, исключениям вы тоже можете задать в модуле область видимости. Для этого используйте аннотации видимости, которые могут принимать следующие значения:

  • @Локально — конструкция видна только в своем модуле. Значение по умолчанию;
  • @ВПодсистеме — конструкция видна только в подсистеме, которой принадлежит модуль;
  • @ВПроекте — конструкция видна только в проекте, которому принадлежит модуль;
  • @ВТипе — конструкция видна в данном типе и его наследниках;
  • @Глобально — конструкция видна в других проектах.

Например:

@Локально
конст СЕКУНД_В_ДНЕ = 60 * 60 * 24
 
@ВПодсистеме
перечисление ВидКнопки
    Круглая,
    Квадратная
;
 
@ВПроекте
метод ПолучитьОписание()
    возврат новый МодульОбъекта.ОписаниеТовара()
;

Квалифицированное имя элемента

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

Например, есть такой проект:

Тогда квалифицированные имена типов, порождаемых его элементами, будут выглядеть следующим образом:

  • КонтрольДанных::Пакет::СправочникВалюты
  • КонтрольДанных::СправочникСотрудники
  • Основная::ОбщийМодуль
  • Основная::СправочникТовары
Важно: Имена, которые вы даете элементам проекта, участвуют в создании системы типов встроенного языка. По этой причине в одном пространстве имен (в одной подсистеме или в одном пакете) не может быть двух элементов с одинаковыми именами.

Для того чтобы указать имя типа и имя элемента проекта из другой подсистемы/пакета, можно использовать либо квалифицированное, либо неквалифицированное имя. Это зависит от того, только ли использует данная подсистема другую подсистему, или дополнительно к этому был выполнен импорт пространства имен.

Использование подсистем

У подсистемы есть свойство Использование. В этом свойстве вы можете перечислить подсистемы, публичные элементы которых вы хотите использовать в данной подсистеме. К типам таких элементов вы сможете обращаться по квалифицированному имени, например: 

Реквизиты:
   -
      Имя: Владелец
      Тип: КонтрольДанных::Сотрудники.Ссылка

Более сложный пример. Возьмем проект из предыдущего раздела:

В нем подсистема Основная использует подсистему КонтрольДанных:

У СправочникВалюты и СправочникСотрудники область видимости установлена в значение Проект:

ВидЭлемента: Справочник
Имя: СправочникВалюты
Ид: f7c5212b-aa1b-4502-80c6-e40893f2a90d
ОбластьВидимости: ВПроекте
Реквизиты:
    -
        Имя: Код

У СправочникВалюты и СправочникСотрудники есть модули объекта и менеджера, в которых определены публичные методы:

@ВПроекте
метод Метод_Менеджера()
;
@ВПроекте
метод Метод_Объекта()
;

Тогда реквизиты справочника Товары будут иметь такой вид:

ВидЭлемента: Справочник
Имя: СправочникТовары
Ид: afca4a1f-851f-47aa-8085-08e47a0f4afb
Реквизиты:
    -
        Имя: Код
        Тип: Строка
    -
        Ид: 222d3946-8163-43ec-a851-4707ca436b2b
        Имя: Сотрудник
        Тип: КонтрольДанных::СправочникСотрудники.Ссылка?
    -
        Ид: 733fdb72-4304-4bea-a210-0aad34a492af
        Имя: Валюта
        Тип: КонтрольДанных::Пакет::СправочникВалюты.Ссылка?

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

@ВПроекте
метод Пример1()
    пер Сотрудник1 = новый КонтрольДанных::СправочникСотрудники.Объект()
     
    // Обращение к атрибуту справочника
    Сотрудник1.Код = "0"
     
    // Вызов публичного метода элемента справочника
    Сотрудник1.Метод_Объекта()
     
    // Вызов публичного метода менеджера справочника
    КонтрольДанных::СправочникСотрудники.Метод_Менеджера()
;
 
@ВПроекте
метод Пример2()
    пер Сотрудник2 = новый КонтрольДанных::Пакет::СправочникВалюты.Объект()
     
    // Обращение к атрибуту справочника
    Сотрудник2.Код = "0"
     
    // вызов публичного метода элемента справочника
    Сотрудник2.Метод_Объекта()
     
    // вызов публичного метода менеджера справочника
    КонтрольДанных::Пакет::СправочникВалюты.Метод_Менеджера()
;

Импорт пространств имен

В любые элементы проекта и в модули вы можете импортировать другие пространства имен.

В элементе проекта они перечисляются в свойстве Импорт, а в модуле для этого используется инструкция импорт.

Например, в справочнике:

ВидЭлемента: Справочник
Имя: ЛичныеКабинеты
Id: a79bd05e-800d-4d9c-a292-eeec023d3f07
ОбластьВидимости: ВПроекте
Импорт:
  - ПоказателиСтатистикиESSОбщее
  - ОбщиеСтандартные
  - ПодключаемыеСтандартные
  - ИнтерфейсныеКомпонентыСтандартные
  - КонтрольДоступаСтандартные
  - УведомленияСтандартные
  - ПриложениеОбщее

Например, в некотором модуле:

импорт ПоказателиСтатистикиESSОбщее
импорт ОбщиеСтандартные
импорт ПодключаемыеСтандартные
импорт ИнтерфейсныеКомпонентыСтандартные
импорт КонтрольДоступаСтандартные
импорт УведомленияСтандартные
импорт ПриложениеОбщее

метод ПередЗаписью()
   ...
;

Публичные элементы проекта и конструкции языка из импортированных пространств вы можете использовать по неквалифицированному имени. Как будто это «ваши собственные» элементы из этой же подсистемы.

Импорт, выполненный в элементе проекта, не влияет на его модули. То есть пространства имен, импортированные в элемент проекта, не становятся автоматически доступны в модулях этого элемента. Если эти же пространства имен нужны вам и в модулях, то в каждый модуль их нужно импортировать отдельно.