¶ Описание
Функция lead_time_ein проверяет, попадает ли экземпляр процесса в указанный промежуток событий и время.
Так как она работает на уровне экземпляров процесса, то при попадании в промежуток вернутся все события, а не только указанный промежуток.
По экземпляру процесса вернется null при применении функции, если в нем:
- отсутствует указанная последовательность шагов;
- есть один шаг, но нет второго;
- есть обратная последовательность выбранных шагов;
- есть указанная последовательность шагов, но не подходит время промежутка.
¶ Синтаксис
lead_time_ein(
таблица.колонка,
'событие1',
номер_появления1,
'событие2',
номер_появления2
[,'календарь',
'параметр_подсчета']
)
таблица.колонка — имя столбца из таблицы журнала событий, по которому будет работать функция.
событие1 — событие, откуда начинается расчет времени прохождения.
- если написать *, а в поле номер_появления1 написать null или 0, то время будет считаться от начала экземпляра процесса.
номер_появления1 — номер появления первого события. Например:
- 1 — первое появление события,
- 2 — второе появление события,
- -1 — последнее появление события,
- -2 — второе с конца появление и т.д.,
- null или 0 - номер появления для обозначения появления с начала, то есть с первого события экземпляра процесса.
событие2 — событие, когда завершается расчет времени прохождения.
- если написать *, а в номер_появления2 написать null или 0, то время будет считаться до конца экземпляра процесса.
номер_появления2 — номер появления второго события. Например:
- 1 — первое появление события,
- 2 — второе появление события,
- -1 — последнее появление события,
- -2 — второе с конца появление и т.д.,
- null или 0 — номер появления для обозначения появления с конца, то есть до последнего события экземпляра процесса.
календарь — календарь, по-которому будет исключено лишнее время между двумя временными метками. Если календарь не задан, то расчет идет без его учета.
Календарь может быть указан через имя, которое отображается в модели данных, через упоминание таблицы журнала событий, в которой он привязан, или через ручное указание полного рабочего расписания:
- 'TABLE' - календарь, примененный к текущему журналу событий,
- 'TABLE: table_name' - календарь, примененный к другому журналу событий или к текущему,
- 'NAME: schedule name' - обращение к календарю по имени, указанному в модели,
- 'WEEK: MON 09:00 - 18:00, TUE...' - ручное указание календаря,
- 'FACT' или null - без календаря.
Указание дней недели в календаре:
- Понедельник — MON,
- Вторник — TUE,
- Среда — WED,
- Четверг — THU,
- Пятница — FRI,
- Суббота — SAT,
- Воскресенье — SUN.
Указание времени дня недели в календаре:
- Время может быть указано только Часами и Минутами: 18:00.
- Время может быть указано Часами, Минутами, Секундами: 17:59:59.
параметр_подсчета — настройка позволяет сменить правило расчета длительности выбранного этапа процесса. На примере ниже показано, как каждое значение влияет на то, какая дата будет выбрана конечной при расчетах.
Зеленым цветом обозначено начальное выбранное событие (событие1), откуда начинается расчет. Его дата всегда одинаковая.
Красным цветом обозначено конечное выбранное событие (событие2) до которого идет расчет. Дата имеет три настройки на выбор:
- (1) START - дата начала события.
- (2) END - дата окончания события. Если не задан параметр_подсчета, то является значением по умолчанию.
- (3) NEXT - следующая дата старта за выбранным событием. Если выбрана настройка NEXT, и конечное событие (событие2) является последним, то для него расчет будет идти по правилу END, так как в данном случае отсутствует следующий шаг.
¶ Примеры
¶ Пример 1. Проверить, попадает ли экземпляр процесса в промежуток от начала до "Финальная проверка счета" со временем от 50 до 100000 секунд.
Запрос
select
case_id,
lead_time_ein(
event_log.activity,
*, 0,
'Финальная проверка счета', -1,
50, 100000
)
from case_table
| id |
|---|
| 1 |
| 2 |
| case_id | activity | start_timestamp | end_timestamp |
|---|---|---|---|
| 1 | Получение счета | 2017-09-09 09:00:38 | 2017-09-09 09:00:38 |
| 1 | Проверка счета | 2017-09-09 09:00:40 | 2017-09-09 09:00:40 |
| 1 | Финальная проверка счета | 2017-09-10 10:06:18 | 2017-09-10 10:06:18 |
| 1 | Финальная проверка счета | 2017-09-10 10:06:18 | 2017-09-21 10:07:41 |
| 1 | Согласование счета | 2017-09-22 09:41:57 | 2017-09-22 17:33:22 |
| 1 | Оплата счета | 2017-09-22 17:33:23 | 2017-09-23 09:16:39 |
| 2 | Получение счета | 2017-08-27 13:00:16 | 2017-08-27 13:00:16 |
| 2 | Проверка счета | 2017-08-27 13:00:16 | 2017-08-27 13:00:17 |
| 2 | Проверка и согласование счета | 2017-08-27 13:08:34 | 2017-08-27 13:25:09 |
| 2 | Оплата счета | 2017-08-27 13:25:10 | 2017-08-28 09:04:29 |
| case_id | %2 |
|---|---|
| 1 | false |
| 2 | false |
¶ Пример 2. Проверить, попадает ли экземпляр процесса в промежуток от начала до "Финальная проверка счета" со временем от 50 до 100000 секунд по календарю из модели.
Указан календарь в модели с именем "1x9-18"
Расписание на неделе:
MON "09:00:00"-"18:00:00"
Праздничные и выходные дни:
Нет
Дополнительные рабочие дни:
Нет
Запрос
select
case_id,
lead_time_ein(
event_log.activity,
*, 0,
'Финальная проверка счета', -1,
50, 100000,
'NAME: 1x9-18',
'END'
)
from case_table
| id |
|---|
| 1 |
| 2 |
| case_id | activity | start_timestamp | end_timestamp |
|---|---|---|---|
| 1 | Получение счета | 2017-09-09 09:00:38 | 2017-09-09 09:00:38 |
| 1 | Проверка счета | 2017-09-09 09:00:40 | 2017-09-09 09:00:40 |
| 1 | Финальная проверка счета | 2017-09-10 10:06:18 | 2017-09-10 10:06:18 |
| 1 | Финальная проверка счета | 2017-09-10 10:06:18 | 2017-09-21 10:07:41 |
| 1 | Согласование счета | 2017-09-22 09:41:57 | 2017-09-22 17:33:22 |
| 1 | Оплата счета | 2017-09-22 17:33:23 | 2017-09-23 09:16:39 |
| 2 | Получение счета | 2017-08-27 13:00:16 | 2017-08-27 13:00:16 |
| 2 | Проверка счета | 2017-08-27 13:00:16 | 2017-08-27 13:00:17 |
| 2 | Проверка и согласование счета | 2017-08-27 13:08:34 | 2017-08-27 13:25:09 |
| 2 | Оплата счета | 2017-08-27 13:25:10 | 2017-08-28 09:04:29 |
| case_id | %2 |
|---|---|
| 1 | true |
| 2 | false |
¶ Пример 3. Отфильтровать экземпляры процесса, где есть промежуток от начала до “Финальная проверка счета” со временем от 50 до 100000 секунд по календарю из модели.
Указан календарь в модели с именем "1x9-18"
Расписание на неделе:
MON "09:00:00"-"18:00:00"
Праздничные и выходные дни:
Нет
Дополнительные рабочие дни:
Нет
Запрос
select
case_id
from case_table
where lead_time_ein(
event_log.activity,
*, 0,
'Финальная проверка счета', -1,
50, 100000,
'NAME: 1x9-18',
'END'
)
| id |
|---|
| 1 |
| 2 |
| case_id | activity | start_timestamp | end_timestamp |
|---|---|---|---|
| 1 | Получение счета | 2017-09-09 09:00:38 | 2017-09-09 09:00:38 |
| 1 | Проверка счета | 2017-09-09 09:00:40 | 2017-09-09 09:00:40 |
| 1 | Финальная проверка счета | 2017-09-10 10:06:18 | 2017-09-10 10:06:18 |
| 1 | Финальная проверка счета | 2017-09-10 10:06:18 | 2017-09-21 10:07:41 |
| 1 | Согласование счета | 2017-09-22 09:41:57 | 2017-09-22 17:33:22 |
| 1 | Оплата счета | 2017-09-22 17:33:23 | 2017-09-23 09:16:39 |
| 2 | Получение счета | 2017-08-27 13:00:16 | 2017-08-27 13:00:16 |
| 2 | Проверка счета | 2017-08-27 13:00:16 | 2017-08-27 13:00:17 |
| 2 | Проверка и согласование счета | 2017-08-27 13:08:34 | 2017-08-27 13:25:09 |
| 2 | Оплата счета | 2017-08-27 13:25:10 | 2017-08-28 09:04:29 |
| case_id |
|---|
| 1 |