Набор данных — это информация по бизнес-процессам, смарт-процессам, сотрудникам и другим элементам Битрикс24. Для каждого элемента предусмотрены несколько наборов данных, в которые автоматически передаются сведения из системных и пользовательских полей. С помощью наборов можно создавать графики и анализировать показатели бизнеса.
В статье расскажем про наборы данных для бизнес-процессов и покажем, как их объединять и создавать графики.
Наборы:
- bizproc_task — задания бизнес-процессов,
- bizproc_workflow_state — запущенные бизнес-процессы,
- bizproc_workflow_template — шаблоны бизнес-процессов.
Примеры:
Выбрать набор данных
Чтобы проанализировать информацию в отчете, выберите подходящий набор данных и создайте график.
bizproc_task — задания бизнес-процессов. Набор содержит данные о заданиях в бизнес-процессах: их названия, типы, статусы и время выполнения. Информацию из набора можно добавить в графики и следить за выполнением заданий.
bizproc_task
| Поле | Описание | Тип данных |
|---|---|---|
| ID | ID задания | Число |
| CODE_ID | Код типа задания | Строка |
| CODE_NAME | Название типа задания | Строка |
| CODE | Код и название типа задания | Строка |
| WORKFLOW_ID | ID бизнес-процесса, в котором создано задание | Строка |
| NAME | Название задания | Строка |
| CREATED_DATE | Дата и время создания задания | Дата и время |
| MODIFIED | Дата и время изменения задания | Дата и время |
| DURATION | Время выполнения задания, с | Число |
| APPROVE_TYPE | Код типа утверждения задания | Строка |
| APPROVE_TYPE_NAME | Название типа утверждения задания | Строка |
| STATUS_ID | Код статуса задания | Число |
| STATUS_NAME | Название статуса выполнения задания | Строка |
| STATUS | Код и название статуса выполнения задания | Строка |
| USER_ID | ID участника задания | Число |
| USER_NAME | Имя участника задания | Строка |
| USER | ID и имя участника задания | Строка |
| USER_STATUS_ID | Код статуса участника задания | Число |
| USER_STATUS_NAME | Название статуса участника задания | Строка |
| USER_STATUS | Код и название статуса участника задания | Строка |
bizproc_workflow_state — запущенные бизнес-процессы. Набор содержит данные о запущенных бизнес-процессах: их статусы, время выполнения и информацию о пользователях, которые их запустили или отредактировали. Информацию из набора можно добавить в графики и отслеживать время запуска и ход выполнения процессов.
bizproc_workflow_state
| Поле | Описание | Тип данных |
|---|---|---|
| ID | ID запущенного бизнес-процесса | Строка |
| STARTED_BY_ID | ID пользователя, который запустил бизнес-процесс | Число |
| STARTED_BY_NAME | Имя пользователя, который запустил бизнес-процесс | Строка |
| STARTED_BY | ID и имя пользователя, который запустил бизнес-процесс | Строка |
| STARTED | Дата и время запуска бизнес-процесса | Дата и время |
| COMPLETED |
Бизнес-процесс завершен: Y — да, N — нет
|
Строка |
| DOCUMENT_ID | ID документа, для которого запущен бизнес-процесс | Строка |
| DURATION | Время выполнения бизнес-процесса, с | Число |
| START_DURATION | Время, затраченное на запуск бизнес-процесса | Число |
| WORKFLOW_TEMPLATE_ID | ID шаблона бизнес-процесса | Число |
| WORKFLOW_TEMPLATE_NAME | Название шаблона бизнес-процесса | Строка |
| MODULE_ID | Код модуля, в котором запущен бизнес-процесс | Строка |
| MODULE_ID_NAME | Название модуля, в котором запущен бизнес-процесс | Строка |
| ENTITY_ID | Код типа элемента, для которого запущен бизнес-процесс | Строка |
| ENTITY_ID_NAME | Название типа элемента, для которого запущен бизнес-процесс | Строка |
| MODIFIED_BY_ID | ID пользователя, который последним обновил шаблон бизнес-процесса | Число |
| MODIFIED_BY_NAME | Имя пользователя, который последним обновил шаблон бизнес-процесса | Строка |
| MODIFIED_BY | ID и имя пользователя, который последним обновил шаблон бизнес-процесса | Строка |
bizproc_workflow_template — шаблоны бизнес-процессов. Набор содержит данные о шаблонах бизнес-процессов: их названия, статусы, типы, дату изменения и информацию о пользователях, которые их создали. Информацию из набора можно использовать в графиках, чтобы определить, какие шаблоны используются в компании чаще всего.
bizproc_workflow_template
| Поле | Описание | Тип данных |
|---|---|---|
| ID | ID шаблона бизнес-процесса | Число |
| WORKFLOW_TEMPLATE | ID и название шаблона бизнес-процесса | Строка |
| MODULE_ID | Код модуля, к которому относится шаблон бизнес-процесса | Строка |
| ENTITY | Название элемента, для которого настроен шаблон бизнес-процесса | Строка |
| DOCUMENT_TYPE | Тип документа, для которого настроен шаблон бизнес-процесса | Строка |
| DOCUMENT_STATUS | Статус шаблона бизнес-процесса | Строка |
| NAME | Название шаблона бизнес-процесса | Строка |
| MODIFIED | Дата и время последнего изменения шаблона бизнес-процесса | Дата и время |
| IS_MODIFIED |
Шаблон бизнес-процесса изменен: Y — да, N — нет
|
Строка |
| USER_ID | ID пользователя, который добавил шаблон бизнес-процесса | Число |
| USER_NAME | Имя пользователя, который добавил шаблон бизнес-процесса | Строка |
| USER | ID и имя пользователя, который добавил шаблон бизнес-процесса | Строка |
| SYSTEM_CODE | Системный код шаблона, который помогает отличить типовые шаблоны от шаблонов, созданных приложениями | Строка |
| IS_SYSTEM |
Шаблон является системным: Y — да, N — нет. В набор попадают только шаблоны со значением N
|
Строка |
| ACTIVE |
Шаблон активен: Y — да, N — нет
|
Строка |
| TYPE |
Код типа шаблона. В набор попадают только шаблоны со значением default
|
Строка |
Создать график
Информацию из набора данных можно добавить в графики и отслеживать выполнение бизнес-процессов. Графики покажут, какие процессы запущены и на каком этапе они находятся.
1–2. Откройте BI Конструктор > Графики > + График.
3–4. Выберите набор данных и формат, в котором хотите видеть информацию: карточка, таблица, линейный график или другой вариант. Если в списке нет нужного набора, нажмите Создать датасет и создайте набор данных.
Как создать набор данных
5. Нажмите Создать график.
Объединить наборы данных
Объедините наборы данных, чтобы добавить в отчет информацию о том, какие задания бизнес-процессов активны и на каком этапе находятся.
1. Откройте BI Конструктор и перейдите в раздел SQL > SQL Lab.
2. Проверьте, что в поле Схема выбран bitrix24.
3. Введите SQL-запрос и нажмите Выполнить.
4. Проверьте результаты запроса. Чтобы создать график для отчета, сохраните запрос как датасет. В датасет попадут сведения из полей, которые вы указали в SQL-запросе.
Как создать и добавить в отчет график на основе виртуального набора данных
Если объединяете наборы данных в первый раз, посмотрите пример запроса.
Пример SQL-запроса
Мы написали SQL-запрос, чтобы извлечь данные из двух наборов: задания бизнес-процессов (bizproc_task) и запущенные бизнес-процессы (bizproc_workflow_state). Вы можете скопировать его и посмотреть, как работает выборка. Запрос выбирает задания в активных бизнес-процессах и показывает их ID, названия, статусы и имена участников.
SELECT
bizproc_task.ID AS "ID задания",
bizproc_task.NAME AS "Название задания",
bizproc_task.USER_NAME AS "Имя участника",
bizproc_task.STATUS_NAME AS "Статус задания",
bizproc_workflow_state.STARTED AS "Дата и время запуска процесса",
bizproc_workflow_state.STARTED_BY_NAME AS "Запущено пользователем"
FROM
bizproc_task
INNER JOIN
bizproc_workflow_state
ON bizproc_task.WORKFLOW_ID = bizproc_workflow_state.ID
WHERE
bizproc_workflow_state.COMPLETED = 'N';
SELECT — определяет, какую информацию надо извлечь из набора данных. Например, запрос SELECT bizproc_task.ID AS "ID задания":
- выбирает идентификатор задания
IDиз набораbizproc_task, - присваивает ему название
ID задания, - выводит результат в отдельную колонку в таблице.
FROM — указывает основной набор, из которого извлекаются данные. Мы извлекаем из bizproc_task — это таблица с информацией о заданиях бизнес-процессов.
INNER JOIN — соединяет таблицы bizproc_task и bizproc_workflow_state. Запрос связывает задания с бизнес-процессами, в рамках которых они были созданы. Используем INNER JOIN, поэтому в результат попадут только задания, для которых есть данные о запущенном бизнес-процессе.
WHERE — фильтрует результаты и показывает задания только в незавершенных бизнес-процессах. Условие bizproc_workflow_state.COMPLETED = 'N' оставляет в выборке активные бизнес-процессы. Чтобы добавить завершенные процессы, удалите это условие.
Коротко
- Набор данных — это информация по бизнес-процессам, смарт-процессам, сотрудникам и другим элементам Битрикс24.
- Для каждого элемента предусмотрены несколько наборов данных, в которые автоматически передаются сведения из системных и пользовательских полей.
- Для анализа бизнес-процессов доступны три набора данных: задания бизнес-процессов (bizproc_task), запущенные бизнес-процессы (bizproc_workflow_state), шаблоны бизнес-процессов (bizproc_workflow_template).
- С помощью наборов можно создавать графики и анализировать показатели: отслеживать выполнение заданий, контролировать активные процессы и анализировать, какие шаблоны используются в компании.
- Наборы данных можно объединять, чтобы включить в отчет информацию об активных заданиях и ходе выполнения бизнес-процессов. Для этого напишите SQL-запрос, сохраните результат как датасет и создайте график.