Создание клиентской схемы

Общие сведения

Клиентские модули — это отдельные блоки функциональности, которые загружаются и запускаются по требованию, в соответствии с технологией AMD. Реализация всей пользовательской функциональности выполняется в клиентских модулях. Несмотря на некоторые функциональные различия, все клиентские модули Creatio имеют одинаковую структуру описания, которая соответствует формату описания модулей AMD. Подробнее о клиентских модулях можно узнать из статьи "Типы модулей и их особенности".

В Creatio можно выделить несколько разновидностей клиентских модулей:

• невизуальный модуль (схема модуля);
• визуальный модуль (схема модели представления);
• модуль расширения и замещающий клиентский модуль (замещающая схема клиентского модуля).

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

Создание новой схемы невизуального модуля

Невизуальный модуль содержит в себе реализацию функциональности системы, которая, как правило, не сопряжена с привязкой данных и их отображением в интерфейсе. Примерами невизуальных модулей в системе являются модули бизнес-правил (BusinessRuleModule) и утилитные модули, которые реализуют служебные функции.

Для создания схемы невизуального модуля необходимо выполнить следующую последовательность действий.

1. Перейти в раздел [Конфигурация] и выбрать пользовательский пакет, в который будет добавлена новая схема.

2. На вкладке [Схемы] выполнить команду Добавить — Модуль (рис. 1).

Рис. 1. — Добавление новой схемы модуля

3. В появившемся дизайнере клиентского модуля необходимо выбрать корневой элемент структуры (рис. 2, 1) и заполнить свойства создаваемой схемы модуля (2):

Рис. 2. — Дизайнер клиентского модуля

К основным свойствам схемы модуля относятся:

• [Название] — название схемы. Может содержать только символы латинского алфавита и цифры. Содержит префикс, указанный в системной настройке [Префикс названия объекта] (SchemaNamePrefix).
• [Заголовок] — заголовок схемы. Может быть локализован.
• [Пакет] — пользовательский пакет, в котором создается схема.

4. На вкладке [Исходный код] дизайнера модуля добавить исходный код модуля (рис. 2, 3). При этом необходимо удостовериться, что название модуля в функции define() совпадает с названием схемы модуля.

5. После внесения всех изменений схему модуля нужно сохранить (рис. 3):

Рис. 3. — Сохранение клиентской схемы модуля

Создание новой схемы модели представления

Клиентская схема модели представления — это схема визуального модуля. Она является неким конфигурационным объектом для генерации представления и модели представления генераторами Creatio ViewGenerator и ViewModelGenerator. Подробнее о клиентских схемах модели представления можно узнать из статьи "Структура клиентской схемы".

Для создания схемы визуального модуля необходимо выполнить следующую последовательность действий.

1. Перейти в раздел [Конфигурация] и выбрать пользовательский пакет, в который будет добавлена новая схема.

2. На вкладке [Схемы] выполнить одну из команд добавления схемы модели представления, доступных в расширенном меню команд (рис. 4):

Рис. 4. — Команды добавления схем модели представления

С помощью этих команд можно добавить следующие типы схем визуальных модулей:

• [Схема модели представления карточки] — схема страницы редактирования записи раздела.
• [Схема модели представления раздела] — схема страницы раздела с реестром и итогами.
• [Схема модели представления детали с реестром] — схема страницы редактирования детали с реестром.
• [Схема модели представления детали с полями] — схема страницы редактирования детали с полями.

3. В открывшемся дизайнере клиентской схемы модели представления выбрать корневой элемент структуры (рис. 5, 1) и заполнить свойства создаваемой схемы (2).

Рис. 5. — Дизайнер клиентской схемы модели представления

Основные свойства схемы модели представления совпадают с основными свойствами схемы невизуального модуля, приведенными выше.

4. На вкладке [Исходный код] дизайнера модуля нужно добавить исходный код схемы модели представления (рис. 5, 3). При этом необходимо удостовериться, что название визуального модуля в функции define() совпадает с названием схемы модели представления.

После внесения всех изменений схему модуля нужно сохранить (рис. 3).

Создание замещающей схемы

Замещающие схемы предназначены для расширения функциональности уже существующих схем. Причем существующие схемы могут также быть замещающими и принадлежать разным пакетам.

Для создания замещающей схемы невизуального или визуального модуля необходимо выполнить следующие шаги.

1. Перейти в раздел [Конфигурация] и выбрать пользовательский пакет, в который будет добавлена новая схема модуля.

2. На вкладке [Схемы] выполнить команду [Добавить] — [Замещающий клиентский модуль] (рис. 6).

Рис. 6. — Команда создания замещающей схемы

3. В открывшемся дизайнере клиентского модуля нужно выбрать корневой элемент структуры (рис. 7, 1).

Рис. 7. — Создание замещающей схемы

4. Для того чтобы модуль замещал определенный раздел или страницу, необходимо в поле [Родительский объект] свойств схемы указать заголовок той базовой схемы модели представления, которую требуется заместить. Например, для создания замещающей схемы раздела [Контакты] необходимо указать в качестве родительского объекта схему ContactSectionV2. Для этого в поле [Родительский объект] свойств замещающей схемы необходимо начать вводить заголовок схемы "Раздел контакты" и выбрать нужное значение из выпадающего списка (рис. 7, 2).

После подтверждения выбранного родительского объекта (рис. 8) остальные поля свойств заполнятся автоматически (рис. 9, 1).

Рис. 8. — Диалог подтверждения использования родительской схемы

Рис. 9. — Замещающая клиентская схема в дизайнере клиентских схем

5. На вкладке [Исходный код] дизайнера модуля нужно добавить исходный код схемы модели представления (рис. 9, 2). При этом необходимо удостовериться, что название замещающего модуля в функции define() совпадает с названием схемы модели представления.

6. После внесения всех изменений схему модуля нужно сохранить (рис. 3).