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