Creatio development guide
PDF
Это документация Creatio версии 7.16.0. Мы рекомендуем использовать новую версию документации.

Создание нового раздела

Glossary Item Box

Общие положения

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

Результатом выполненных настроек будут схемы объектов и страниц раздела, добавленные в текущий пользовательский пакет (табл. 1, 2).

Табл. 1. — Схемы объектов, создаваемые мастером разделов

Правила именования Назначение Родитель
[Имя объекта раздела] Основной объект раздела Базовый объект (BaseEntity)
[Имя объекта раздела]Folder

Группа объекта.

Служебный объект для корректной группировки записей в разделе. Формирует общую структуру дерева групп раздела.

Базовая группа (BaseFolder)
[Имя объекта раздела]InFolder

Объект в группе.

Служебный объект для корректной работы группировки записей в разделе. Определяет связи между записями раздела и группами, в которые они входят.

Базовый элемент в группе (BaseItemInFolder)
[Имя объекта раздела]File Объект для детали [Файлы и ссылки]. Файл (File)
[Имя объекта раздела]Tag Тег раздела. Базовый тег (BaseTag)
[Имя объекта раздела]InTag Тег в объекте раздела. Базовый тег в базовом объекте (BaseEntityInTag)

Табл. 2. — Клиентские схемы, создаваемые мастером раздела

Правила именования Назначение Родитель
[Имя объекта раздела]Section Схема раздела

Базовая схема раздела (BaseSectionV2)

[Имя объекта раздела]Page Схема страницы редактирования раздела Базовая схема страницы редактирования раздела (BaseModulePageV2)

Мастер разделов и пакет [Custom]

Мастер разделов не только создает различные схемы, но и привязывает данные к текущему пакету. Однако, если текущим пакетом является пакет [Custom], то перенести привязанные данные в другой пользовательский пакет практически невозможно. Пакет [Custom] не предназначен для фиксации в системе контроля версий и переноса изменений на другие среды. Поэтому пакет [Custom] не рекомендуется использовать в качестве текущего пользовательского пакета. Особенности пакета [Custom] подробно описаны в статье "Реализация простых изменений конфигурации. Пакет [Custom]".

Чтобы изменить текущий пакет, необходимо использовать системную настройку [Текущий пакет] (CurrentPackageId). Перед запуском мастера разделов рекомендуется проверить значение этой системной настройки.

Последовательность добавления раздела

  1. С помощью мастера разделов создать раздел и добавить его в нужное рабочее место.
  2. Добавить необходимые колонки в схему объекта раздела и настроить их отображение в реестре, на странице редактирования и на деталях.

Описание примера

В приложение добавить рабочее место [Автосалон] ([Car showroom]). В созданное рабочее место добавить пользовательский раздел [Грузовые автомобили] ([Trucks]). Схема объекта грузового автомобиля должна содержать обязательные для заполнения колонки:

  • Название (Name) — строка.
  • Владелец (Owner) — справочник [Контакт] ([Contact]).
  • Организация (Organization) — справочник [Контрагент] ([Account]).
  • Цена (Price) — строка.

Алгоритм реализации примера

1. С помощью мастера разделов создать раздел и добавить его в нужное рабочее место

Процесс создания рабочего места подробно описан в статье "Настройка рабочих мест". Для нового рабочего места укажите [Название] ([Name]) — "Автосалон" ("Car showroom") и добавьте группу пользователей, для которой будет доступно создаваемое рабочее место.

Работа с мастером разделов подробно описана в статье "Мастер разделов". Для создания нового раздела достаточно использовать первый шаг мастера. При этом в основной объект раздела будут добавлены колонка [Название] ([Name]) с типом "строка" и колонки, унаследованные от базового объекта. Для первоначальной настройки раздела на первом шаге мастера укажите:

  • [Код раздела] ([Code]) — "UsrTruck";
  • [Заголовок] ([Title]) — "Грузовые автомобили" ("Trucks").

Название объекта раздела, вводимое в поле [Код раздела] в мастере разделов, не должно содержать префиксов "Base", "Sys" или "Vw". Также оно не должно содержать суффиксов "InFolder", "Lcz", "Lookup" и "Settings". В противном случае для такого объекта будет невозможно настроить импорт данных из Excel.

Если работа в системе ведется с настройками по умолчанию, то при вводе значения в поле [Код раздела] возникнет сообщение о том, что значение должно начинаться с префикса "Usr". Значение префикса задается в системной настройке [Префикс названия объекта] (SchemaNamePrefix). При необходимости можно сменить значение префикса на пользовательское. Использовать пустую строку в качестве префикса не рекомендуется из-за возможных совпадений названий с другими элементами базовой конфигурации.

В результате в пользовательском пакете будут созданы все необходимые для работы раздела схемы (рис. 1).

Рис. 1. — Схемы раздела [Грузовые автомобили] в пользовательском пакете

2. Добавить необходимые колонки в схему объекта раздела и настроить их отображение

Существует два способа добавления новых колонок в схему объекта:

1. При помощи мастера создать новую колонку и сразу же добавить ее на страницу редактирования. При этом колонка будет автоматически добавлена в схему основного объекта раздела. Подробно о настройке полей страницы редактирования записи раздела читайте в статье "Как настроить поля страницы".

2. Добавить колонку в схему основного объекта раздела с помощью дизайнера объекта в разделе [Конфигурация]. Затем с помощью мастера разделов добавить колонки на страницу. Подробнее о возможностях раздела [Конфигурация] можно узнать из статьи "Разработка во встроенной IDE. Раздел [Конфигурация]".

Поскольку мастер раздела задействован в любом случае, удобнее использовать первый способ.

Колонка [Название] ([Name]) создается и добавляется на страницы раздела мастером раздела автоматически.

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

Колонка Тип Заголовок [Title] Название в базе данных [Name in DB]
Владелец Справочник [Контакт] ([Contact]) Владелец (Owner) UsrOwner
Организация Справочник [Контрагент] ([Account]) Организация (Organization) UsrOrganization
Цена Дробное число (Decimal) Цена, USD (Price, USD) UsrPrice

Для всех колонок установите признак [Является обязательным] ([Is required]).

После сохранения изменений в мастере разделов в схему объекта UsrTruck будут добавлены новые колонки (рис. 2), а в массив модификаций diff схемы страницы редактирования UsrTruckPage — соответствующие им конфигурационные объекты.

Рис. 2. — Схема главного объекта раздела [Грузовые автомобили]

Настройте отображение колонок в реестре раздела. Страница настройки колонок реестра открывается по команде [Настроить колонки] ([Select fields to display]) меню кнопки [Вид] ([View]). Подробнее о настройке колонок раздела можно узнать из статьи "Настройка колонок реестра".

После добавления новых записей раздел примет вид, аналогичный показанному на рисунке 3.

Рис. 3. — Раздел [Грузовые автомобили] ([Trucks]) в рабочем месте [Автосалон] ([Car showroom])

© Terrasoft 2002-2020.

Был ли данный материал полезен?

Как можно улучшить эту статью?