.. _bpmn_kpi: KPI ==== .. contents:: **KPI (Key Performance Indicators)** в Citeck BPMN — инструмент контроля соответствия хода бизнес-процессов установленным нормативам. Функционал позволяет задавать нормы времени и количественные показатели для элементов процесса, отслеживать отклонения и формировать отчёты. Поддерживается настройка норм времени на: * выполнение задач, * смену статусов, * выполнение условий (событие, обновление атрибутов). Данные нормы могут отличаться в зависимости от параметров (значений атрибутов) конкретного экземпляра типа данных. Нормы доступны для настройки пользователями. Настройка ---------- Для настройки KPI необходимо перейти в журнал **"Настройка KPI" (Рабочее пространство "Раздел администратора" - Управление процессами)**: .. image:: _static/KPI/01.png :width: 700 :align: center Форма создания: .. image:: _static/KPI/02.png :width: 600 :align: center В форме необходимо указать **Название**, выбрать **Тип (Продолжительность или Количество)**, **Процесс**, **Элемент BPMN**, **Норму**. Можно задать условие применения KPI на **DMN**. Модель описывается в DMN, базовым рекордом является документ, по которому идет бизнес-процесс. Если DMN указан и результат вычисления возвращает **boolean (true)**, то KPI применяется. Название возвращаемой переменной не имеет значения. KPI по продолжительности ~~~~~~~~~~~~~~~~~~~~~~~~~~ KPI по продолжительности позволяет отслеживать время между указанными BPMN элементами (**Исходный** и **Целевой**) в процессе. .. image:: _static/KPI/03.png :width: 600 :align: center .. important:: Исходный и целевой элемент должны быть в рамках одного процесса. В **Исходном** и **Целевом** элементах BPMN укажите **Идентификатор** (ID элемента бизнес-процесса) и выберите **Событие**. .. note:: Не рекомендуется использовать на start и end одного multi-instance элемента, продолжительность будет считаться некорректно. Время (**Норма**) может учитываться 2 **Типов** — календарное или рабочее (в текущей реализации только с использованием рабочего календаря и расписания по умолчанию - id=DEFAULT). Продолжительность времени указывается в формате **d h m**: * 1d 3h 10m — 1 день 3 часа 10 минут * 1d — 1 день * 1h 15m — 1 час 15 минут * 30m — 30 минут KPI по количеству ~~~~~~~~~~~~~~~~~ KPI по количеству позволяет считать количество прохождения через указанный элемент. В **Целевом BPMN элементе** укажите **Идентификатор** (ID элемента бизнес-процесса) и выберите **Событие**. Укажите количество прохождений в поле **Норма**. .. image:: _static/KPI/04.png :width: 600 :align: center В дальнейшем планируется добавить настройку периодов времени — месяц, квартал, год и т.д. Значения KPI ------------- В журналах администратора выведен общий журнал **Значения KPI**. .. image:: _static/KPI/05.png :width: 700 :align: center Для удобства рекомендуется настроить свой журнал по KPI с нужными фильтрами, группировками, агрегациями. Для создания своего журнала со значениями KPI можно копировать журнал **Значения KPI** и настроить колонки, как необходимо. Если KPI по продолжительности, то поля **Норма** и **Значение** можно настроить с использованием :ref:`форматтера Duration (Продолжительность) ` для лучшей читаемости. Пример сформированного отчета ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. image:: _static/KPI/06.png :width: 700 :align: center Отображение на схеме BPMN -------------------------- Значения отклонений KPI доступны на схеме BPMN в виджете :ref:`Статистика процесса `.