Бизнес-правила и их применение

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

Одним из инструментов настройки логики страниц в bpm'online являются бизнес-правила.

Бизнес-правила — это стандартный механизм системы, который позволяет настраивать поведение полей на странице путем конфигурирования колонок модели представления.

Бизнес-правила позволяют решать следующие типовые задачи:

• скрыть или отобразить поле;
• заблокировать или разблокировать поле;
• сделать поле обязательным или необязательным для заполнения;
• отфильтровать значения справочного поля в зависимости от значения в другом поле.

В bpm'online бизнес-правила могут добавляться двумя способами:

1. С помощью мастера разделов или мастера деталей.

• Бизнес-правила, которые сгенерированы мастером, добавляются в свойство businessRules клиентского модуля.
• Сгенерированные бизнес-правила имеют более высокий приоритет при выполнении.
• При описании сгенерированного бизнес-правила не используются перечисления модуля бизнес-правил BusinessRuleModule.

Более подробно о настройке бизнес-правил с помощью мастера читайте в статье "Настройка бизнес-правил". Особенности ручной настройки сгенерированных бизнес-правил описаны в статье "Бизнес-правила. Свойство businessRules".

2. Конфигурированием свойства rules схемы клиентского модуля.

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

Пример объявления пользовательского модуля с использованием бизнес-правил:

define("CustomPageModule", ["BusinessRuleModule"], function(BusinessRuleModule) {
    return {
        // Реализация схемы модели представления.
    };
});

Общие требования к объявлению бизнес-правил в клиентском модуле

• Все правила описываются в свойстве rules модели представления страницы.
• Правила применяются к колонкам модели представления, а не к элементам управления.
• Бизнес-правила не поддерживаются в страницах реестра.
• Правило имеет название.
• Параметры правила задаются в его конфигурационном объекте.

Пример объявления правил:

// Список всех правил модели представления.
rules : {
    // Имя колонки, для которой добавляется правило.
    "FirstColumnName" : {
        // Список правил для колонки FirstColumnName.
        // Имя правила.
        FirstRuleName : {
            // Конфигурационный объект правила FirstRuleName.
            ruleType: <значение из перечисления BusinessRuleModule.enums.RuleType>
            // Остальные конфигурационные свойства правила.
        },
        SecondRuleName: {
            // Конфигурационный объект правила SecondRuleName.
            ruleType: <значение из перечисления BusinessRuleModule.enums.RuleType>
            // Остальные конфигурационные свойства правила.
        }
    },
    "SecondColumnName" : {
        // Список правил для колонки SecondColumnName.
        ...
    }
}

Типы бизнес-правил

Типы правил bpm’online определены в перечислении RuleType модуля BusinessRuleModue.

На текущий момент используется два типа правил — BINDPARAMETER и FILTRATION.

BINDPARAMETER

Используется для настройки привязки свойств одной колонки к значениям различных параметров. Например, чтобы настроить видимость или доступность колонки в зависимости от значения другой колонки. Основные свойства конфигурационного объекта правила BINDPARAMETER приведены в таблице 1.

Табл. 1. — Конфигурирование правила BINDPARAMETER

Табл. 2. — Конфигурирование условия правила BINDPARAMETER

FILTRATION

Используется для настройки фильтрации значений колонки модели представления. Например, для фильтрации определенной колонки с типом справочник в зависимости от значения текущего состояния страницы.

Табл. 3. — Конфигурирование правила FILTRATION

Смотрите также:

• Пример применения правила FILTRATION
• Правило BINDPARAMETER. Как заблокировать поле на странице редактирования по определенному условию
• Правило BINDPARAMETER. Как скрыть поле на странице редактирования по определенному условию
• Правило BINDPARAMETER. Как сделать поле обязательным для заполнения по определенному условию
• Бизнес-правила, созданные с помощью мастеров