Набор данных — это информация по задачам, проектам, лидам, сделкам и другим элементам Битрикс24. Для каждого элемента предусмотрены несколько наборов данных, в которые автоматически передаются сведения из системных и пользовательских полей. С помощью наборов можно создавать графики и анализировать показатели бизнеса.
В статье расскажем про наборы данных для задач и проектов и покажем, как их объединять и создавать графики.
Наборы:
- task — задачи,
- task_stages — стадии задач,
- task_uf — пользовательские поля задач,
- task_elapsed_time — время работы над задачей,
- flow — потоки,
- task_efficiency — эффективность работы над задачами,
- socialnetwork_group — проекты.
Примеры:
Выбрать набор данных
Чтобы проанализировать информацию в отчете, выберите подходящий набор данных и создайте график.
task — задачи. Набор содержит данные из системных полей задач: названия, статусы, сроки, постановщики, исполнители, соисполнители, наблюдатели, стадии и связанные элементы. Используйте набор, чтобы оценивать сроки выполнения задач и распределение работы между сотрудниками.
task
| Поле | Описание | Тип данных |
|---|---|---|
| ID | ID задачи | Число |
| TITLE | Название задачи | Строка |
| DESCRIPTION | Описание задачи, до 128 символов | Строка |
| MARK | Оценка от постановщика: «Положительная», «Отрицательная», «Нет оценки» | Строка |
| PRIORITY | Приоритет задачи: важная или обычная | Строка |
| STATUS | Статус задачи: «Ждет выполнения», «Выполняется», «Ожидает контроля», «Завершена», «Отложена» | Строка |
| GROUP_ID | ID группы, к которой привязана задача | Число |
| GROUP_NAME | Название группы, к которой привязана задача | Строка |
| GROUP_INFO | ID и название группы, к которой привязана задача | Строка |
| MULTITASK |
Признак задачи с несколькими исполнителями: Y — да, N — нет
|
Строка |
| STAGE_ID | ID стадии, на которой находится задача | Число |
| STAGE_NAME | Название стадии, на которой находится задача | Строка |
| STAGE | ID и название стадии, на которой находится задача | Строка |
| CREATED_BY_ID | ID постановщика задачи | Число |
| CREATED_BY_NAME | Имя постановщика задачи | Строка |
| CREATED_BY | ID и имя постановщика задачи | Строка |
| CREATED_DATE | Дата и время создания задачи | Дата и время |
| RESPONSIBLE_ID | ID исполнителя задачи | Число |
| RESPONSIBLE_NAME | Имя исполнителя задачи | Строка |
| RESPONSIBLE | ID и имя исполнителя задачи | Строка |
| ACCOMPLICES_IDS | ID соисполнителей задачи | Строка |
| ACCOMPLICES_NAMES | Имена соисполнителей задачи | Строка |
| ACCOMPLICES | ID и имена соисполнителей задачи | Строка |
| AUDITORS_IDS | ID наблюдателей задачи | Строка |
| AUDITORS_NAMES | Имена наблюдателей задачи | Строка |
| AUDITORS | ID и имена наблюдателей задачи | Строка |
| PARENT_ID | ID родительской задачи | Число |
| CHANGED_BY_ID | ID сотрудника, который последним изменил задачу | Число |
| CHANGED_BY_NAME | Имя сотрудника, который последним изменил задачу | Строка |
| CHANGED_BY | ID и имя сотрудника, который последним изменил задачу | Строка |
| CHANGED_DATE | Дата и время последнего изменения задачи | Дата и время |
| STATUS_CHANGED_BY_ID | ID сотрудника, который последним изменил статус задачи | Число |
| STATUS_CHANGED_BY_NAME | Имя сотрудника, который последним изменил статус задачи | Строка |
| STATUS_CHANGED_BY | ID и имя сотрудника, который последним изменил статус задачи | Строка |
| STATUS_CHANGED_DATE | Дата и время последнего изменения статуса задачи | Дата и время |
| CLOSED_BY_ID | ID сотрудника, завершившего задачу | Число |
| CLOSED_BY_NAME | Имя сотрудника, завершившего задачу | Строка |
| CLOSED_BY | ID и имя сотрудника, завершившего задачу | Строка |
| CLOSED_DATE | Дата и время завершения задачи | Дата и время |
| ACTIVITY_DATE | Дата и время последнего события в задаче | Дата и время |
| DATE_START | Дата и время начала работы над задачей | Дата и время |
| DEADLINE | Крайний срок задачи | Дата и время |
| START_DATE_PLAN | Дата и время запланированного начала работы над задачей | Дата и время |
| END_DATE_PLAN | Дата и время запланированного завершения работы над задачей | Дата и время |
| ALLOW_CHANGE_DEADLINE |
Признак возможности для исполнителя изменить крайний срок задачи: Y — да, N — нет
|
Строка |
| ALLOW_TIME_TRACKING |
Признак включенного учета времени по задаче: Y — да, N — нет
|
Строка |
| TASK_CONTROL |
Признак необходимости проконтролировать задачу после завершения: Y — да, N — нет
|
Строка |
| ADD_IN_REPORT |
Признак добавления задачи в план рабочего дня: Y — да, N — нет
|
Строка |
| TIME_ESTIMATE | Планируемое время выполнения задачи, с | Число |
| MATCH_WORK_TIME |
Признак автоматического увеличения длительности задачи, если ее сроки попадают на выходные или праздничные дни: Y — да, N — нет
|
Строка |
| DURATION_PLAN | Планируемая длительность работы над задачей, с | Число |
| DURATION_TYPE | Единица измерения планируемой длительности: «Секунда», «Минута», «Час», «День», «Неделя», «Месяц», «Год» | Строка |
| CRM_TASK |
ID и тип элементов CRM, указанных в задаче. Поддерживаемые типы: L — лид, D — сделка, C — контакт, CO — компания
|
Строка |
| TAGS | Теги задачи | Строка |
| DEPENDS_ON | ID связанных задач | Число |
| FLOW_ID | ID потока, в который добавлена задача | Число |
task_stages — стадии задач. Набор содержит данные из системных полей стадий задач: названия, порядок сортировки, цвета и связанные проекты. Используйте набор, чтобы анализировать, на каких стадиях находятся задачи в проектах.
task_stages
| Поле | Описание | Тип данных |
|---|---|---|
| ID | ID стадии задачи | Число |
| TITLE | Название стадии задачи | Строка |
| SORT | Порядок сортировки стадии | Число |
| COLOR | Цвет стадии | Строка |
| GROUP_ID | ID проекта, с которым связана стадия | Число |
| GROUP_NAME | Название проекта, с которым связана стадия | Строка |
| GROUP_INFO | ID и название проекта, с которым связана стадия | Строка |
task_uf — пользовательские поля задач. Набор содержит данные из пользовательских полей, которые вы создали самостоятельно: срок доставки, номер заказа и другие.
task_uf
| Поле | Описание | Тип данных |
|---|---|---|
| TASK_ID | ID задачи | Число |
| TASK_CREATED_DATE | Дата и время создания задачи | Дата и время |
| UF_CRM_TASK | Названия элементов CRM, указанных в задаче | Строка |
| UF_MAIL_MESSAGE | ID письма, из которого создана задача | Число |
| UF_AUTO_"номер поля" | Значение пользовательского поля задачи с указанным номером. Номер автоматически присваивается полю при создании | Строка |
task_elapsed_time — время работы над задачей. Набор содержит данные об учете времени по задачам: даты начала работы, продолжительность в секундах и информацию об авторах записей. Используйте набор, чтобы узнать, кто и сколько времени работал над задачами.
task_elapsed_time
| Поле | Описание | Тип данных |
|---|---|---|
| ID | ID записи об учете времени | Число |
| TASK_ID | ID задачи | Число |
| USER_ID | ID автора записи об учете времени | Число |
| USER_NAME | Имя автора записи об учете времени | Строка |
| USER | ID и имя автора записи об учете времени | Строка |
| DATE_START | Дата и время начала работы над задачей | Дата и время |
| ELAPSED_TIME | Затраченное время на работу над задачей, с | Число |
| COMMENT_TEXT | Комментарий к записи об учете времени, до 100 символов | Строка |
flow — потоки. Набор содержит данные из системных полей потоков задач: названия, создатели, администраторы, настройки распределения задач, связанные проекты и задачи. Используйте набор, чтобы анализировать распределение задач и просрочки в потоках.
flow
| Поле | Описание | Тип данных |
|---|---|---|
| ID | ID потока | Число |
| NAME | Название потока | Строка |
| FLOW | ID и название потока | Строка |
| CREATOR_ID | ID сотрудника, создавшего поток | Число |
| CREATOR_NAME | Имя сотрудника, создавшего поток | Строка |
| CREATOR | ID и имя сотрудника, создавшего поток | Строка |
| OWNER_ID | ID сотрудника, администрирующего поток | Число |
| OWNER_NAME | Имя сотрудника, администрирующего поток | Строка |
| OWNER | ID и имя сотрудника, администрирующего поток | Строка |
| PLANNED_COMPLETION_TIME | Планируемое время выполнения задачи в потоке, с | Число |
| DISTRIBUTION_TYPE | Тип распределения задач в потоке: «По очереди», «Вручную», «Самостоятельно» | Строка |
| HAS_TEMPLATE |
Признак наличия шаблона задач в потоке: Y — да, N — нет
|
Строка |
| ACTIVE |
Признак активности потока: Y — да, N — нет
|
Строка |
| GROUP_ID | ID проекта, в котором находится поток | Число |
| GROUP_NAME | Название проекта, в котором находится поток | Строка |
| GROUP_INFO | ID и название проекта, в котором находится поток | Строка |
| TASKS_IDS | ID задач, добавленных в поток | Строка |
| EXPIRED_TASKS_IDS | ID просроченных задач, добавленных в поток | Строка |
task_efficiency — эффективность работы над задачами. Набор содержит данные о событиях, связанных с выполнением задач: просрочки, замечания и изменения крайних сроков задач. Используйте набор, чтобы отслеживать просроченные задачи и изменения их крайних сроков.
task_efficiency
| Поле | Описание | Тип данных |
|---|---|---|
| ID | ID записи о событии | Число |
| TASK_ID | ID задачи, к которой привязана запись о событии | Число |
| DATETIME | Дата и время создания записи о событии | Дата и время |
| DATETIME_REPAIR | Дата и время изменения крайнего срока у просроченной задачи | Дата и время |
| IS_VIOLATION |
Признак того, что событие является замечанием: Y — да, N — нет
|
Строка |
Набор содержит данные из системных полей групп, проектов и скрам-команд: названия, владельцы, участники, типы, активность, сроки проектов и настройки скрама. Используйте набор, чтобы анализировать активность и состав участников проектов.
socialnetwork_group
| Поле | Описание | Тип данных |
|---|---|---|
| ID | ID группы | Число |
| SITE_ID | Код сайта, к которому относится группа | Строка |
| NAME | Название группы | Строка |
| DESCRIPTION | Описание группы | Строка |
| DATE_CREATE | Дата и время создания группы | Дата и время |
| DATE_MODIFY | Дата и время последнего изменения группы | Дата и время |
| OPENED |
Признак открытой группы: Y — да, N — нет
|
Строка |
| SUBJECT | Тематика группы | Строка |
| OWNER_ID | ID владельца группы | Число |
| OWNER_NAME | Имя владельца группы | Строка |
| OWNER | ID и имя владельца группы | Строка |
| KEYWORDS | Теги группы | Строка |
| MODERATORS_IDS | ID модераторов группы | Строка |
| MEMBERS_IDS | ID участников группы | Строка |
| TYPE |
Тип группы: group — группа, project — проект, scrum — скрам
|
Строка |
| NUMBER_OF_MEMBERS | Количество участников группы | Число |
| DATE_ACTIVITY | Дата и время последней активности в группе | Дата и время |
| CLOSED |
Признак нахождения группы в архиве: Y — да, N — нет
|
Строка |
| PROJECT |
Признак того, что группа является проектом: Y — да, N — нет
|
Строка |
| PROJECT_DATE_START | Дата и время начала проекта | Дата и время |
| PROJECT_DATE_FINISH | Дата и время завершения проекта | Дата и время |
| SCRUM_MASTER_ID | ID скрам-мастера | Число |
| SCRUM_MASTER_NAME | Имя скрам-мастера | Строка |
| SCRUM_MASTER | ID и имя скрам-мастера | Строка |
| SCRUM_SPRINT_DURATION | Длительность спринта в скрам-команде, с | Число |
| SCRUM_TASK_RESPONSIBLE |
Исполнитель задач по умолчанию в скрам-команде: A — постановщик, M — скрам-мастер
|
Строка |
Создать график
Информацию из набора данных можно добавить в графики и отслеживать выполнение задач. Графики покажут активность сотрудников, этапы работы над проектами и соблюдение сроков.
1–2. Откройте BI Конструктор > Графики > + График.
3–4. Выберите датасет и тип графика: карточка, таблица, линейный график или другой вариант. Если в списке нет нужного набора, нажмите Создать датасет и создайте набор данных.
Как создать набор данных
5. Нажмите Создать график.
Объединить наборы данных
Объедините наборы данных, чтобы добавить в отчет информацию о просроченных задачах сотрудника и посмотреть, когда переносился крайний срок в его задачах.
1. Откройте BI Конструктор и перейдите в раздел SQL > SQL Lab.
2. Проверьте, что в поле Схема выбран bitrix24.
3. Введите SQL-запрос и нажмите Выполнить.
4. Проверьте результаты запроса. Чтобы создать график для отчета, сохраните запрос как датасет. В датасет попадут сведения из полей, которые вы указали в SQL-запросе.
Как создать и добавить в отчет график на основе виртуального набора данных
Если объединяете наборы данных в первый раз, посмотрите пример запроса.
Пример SQL-запроса
Мы написали SQL-запрос, чтобы извлечь данные из двух наборов: задачи (task) и эффективность работы над задачами (task_efficiency). Вы можете скопировать его и посмотреть, как работает выборка. Запрос выбирает все просроченные задачи определенного исполнителя, показывает их название, крайний срок и время последнего изменения крайнего срока. Замените идентификатор исполнителя перед выполнением запроса.
SELECT
task.ID AS "Идентификатор задачи",
task.TITLE AS "Название задачи",
task.RESPONSIBLE_NAME AS "Имя исполнителя",
task.DEADLINE AS "Крайний срок задачи",
task_efficiency.DATETIME_REPAIR AS "Время изменения крайнего срока"
FROM
task
LEFT JOIN
task_efficiency ON task_efficiency.TASK_ID = task.ID
WHERE
task.RESPONSIBLE_ID = 12345 -- Замените на идентификатор нужного исполнителя
AND task.DEADLINE < NOW();
SELECT — определяет, какую информацию надо извлечь из набора данных. Например, запрос SELECT task.ID AS "Идентификатор задачи":
- выбирает идентификатор задачи
IDиз набораtask, - присваивает ему название
идентификатор задачи, - выводит результат в отдельную колонку в таблице.
FROM — указывает основной набор, из которого извлекаются данные. Мы извлекаем из task — это таблица с основной информацией о задачах.
LEFT JOIN — соединяет таблицу task с task_efficiency. Запрос связывает задачи со временем изменения их крайнего срока. Мы используем LEFT JOIN, чтобы показать все задачи, даже если нет записей о времени изменения крайнего срока.
WHERE — фильтрует результаты и показывает только просроченные задачи конкретного исполнителя. Чтобы получить данные для другого исполнителя, замените значение 12345 на нужный идентификатор. Если хотите увидеть все просроченные задачи без привязки к исполнителю, уберите условие RESPONSIBLE_ID.
Коротко
- Набор данных — это информация по задачам, проектам, лидам, сделкам и другим элементам Битрикс24.
- Для каждого элемента предусмотрены несколько наборов данных, в которые автоматически передаются сведения из системных и пользовательских полей.
- Для задач и проектов есть семь наборов данных: задачи (task), пользовательские поля (task_uf), время работы (task_elapsed_time), стадии задач (task_stages), эффективность работы над задачами (task_efficiency), потоки задач (flow) и проекты (socialnetwork_group).
- С помощью наборов можно создавать графики и анализировать показатели: время работы над задачей, статус проектов и количество закрытых задач.
- Наборы данных можно объединять, чтобы включить в отчет информацию о просроченных задачах, изменениях крайних сроков и других параметрах. Для этого напишите SQL-запрос, сохраните результат как датасет и создайте график.