Набор данных — это информация по задачам, проектам, лидам, сделкам и другим элементам Битрикс24. Для каждого элемента предусмотрены несколько наборов данных, в которые автоматически передаются сведения из системных и пользовательских полей. С помощью наборов можно создавать графики и анализировать показатели бизнеса.
В статье расскажем про наборы данных для задач и проектов и покажем, как их объединять и создавать графики.
Наборы:
- task — задачи,
- task_stages — стадии задач,
- task_uf — пользовательские поля задачи,
- task_elapsed_time — время работы над задачей,
- flow — потоки,
- task_efficiency — эффективность задач,
- socialnetwork_group — проекты.
Примеры:
Выбрать набор данных
Чтобы проанализировать информацию в отчете, выберите подходящий набор данных и создайте график.
task — задачи. Набор содержит информацию о задачах и их параметрах: названия, статусы, сроки, исполнители, соисполнители и наблюдатели. Вы можете узнать, кто поставил задачу, в каком она статусе, даты начала и завершения.
task
Поле | Описание | Тип данных |
---|---|---|
ID | Идентификатор задачи | Число |
TITLE | Название задачи | Строка |
DESCRIPTION | Описание задачи | Строка |
MARK | Оценка от постановщика. Значения: «Положительная», «Отрицательная», «Нет оценки» | Строка |
PRIORITY | Приоритеты: важная задача и обычная | Строка |
STATUS | Статусы: «Ждет выполнения», «Выполняется», «Ожидает контроля», «Завершена», «Отложена» | Строка |
GROUP_ID | Идентификатор группы, к которой привязана задача | Число |
GROUP_NAME | Название группы, к которой привязана задача | Строка |
GROUP_INFO | Идентификатор и название группы, к которой привязана задача | Строка |
MULTITASK | Задача поставлена нескольким исполнителям: Y — да, N — нет | Строка |
STAGE_ID | Идентификатор стадии, на которой находится задача | Число |
STAGE_NAME | Название стадии, на которой находится задача | Строка |
STAGE | Идентификатор и название стадии, на которой находится задача | Строка |
CREATED_BY_ID | Идентификатор постановщика задачи | Число |
CREATED_BY_NAME | Имя постановщика задачи | Строка |
CREATED_BY | Идентификатор и имя постановщика задачи | Строка |
CREATED_DATE | Дата создания задачи | Дата |
RESPONSIBLE_ID | Идентификатор исполнителя задачи | Число |
RESPONSIBLE_NAME | Имя исполнителя задачи | Строка |
RESPONSIBLE | Идентификатор и имя исполнителя задачи | Строка |
ACCOMPLICES_IDS | Идентификаторы соисполнителей задачи | Строка |
ACCOMPLICES_NAMES | Имена соисполнителей задачи | Строка |
ACCOMPLICES | Идентификаторы и имена соисполнителей задачи | Строка |
AUDITORS_IDS | Идентификаторы наблюдателей в задаче | Строка |
AUDITORS_NAMES | Имена наблюдателей в задаче | Строка |
AUDITORS | Идентификаторы и имена наблюдателей в задаче | Строка |
PARENT_ID | Идентификатор базовой задачи | Число |
CHANGED_BY_ID | Идентификатор сотрудника, который последним изменил задачу | Число |
CHANGED_BY_NAME | Имя сотрудника, который последним изменил задачу | Строка |
CHANGED_BY | Идентификатор и имя сотрудника, который последним изменил задачу | Строка |
CHANGED_DATE | Дата и время последнего изменения задачи | Дата |
STATUS_CHANGED_BY_ID | Идентификатор сотрудника, который последним изменил статус задачи | Число |
STATUS_CHANGED_BY_NAME | Имя сотрудника, который последним изменил статус задачи | Строка |
STATUS_CHANGED_BY | Идентификатор и имя сотрудника, который последним изменил статус задачи | Строка |
STATUS_CHANGED_DATE | Дата и время последнего изменения статуса | Дата |
CLOSED_BY_ID | Идентификатор сотрудника, завершившего задачу | Число |
CLOSED_BY_NAME | Имя сотрудника, завершившего задачу | Строка |
CLOSED_BY | Идентификатор и имя сотрудника, завершившего задачу | Строка |
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, указанных в задаче. Поддерживаемые типы CRM: «L» - лид, «D» - сделка, «C» - контакт, «CO» - компания | Строка |
TAGS | Теги в задаче | Строка |
DEPENDS_ON | Идентификаторы связанных задач | Число |
FLOW_ID | Идентификатор потока | Число |
task_stages — стадии задач. Набор содержит информацию о стадиях задач: их названия, порядковые номера, цвета и привязка к проектам. Вы можете отслеживать, на каких этапах находятся задачи и как они распределены по проектам.
task_stages
Поле | Описание | Тип данных |
---|---|---|
ID | Идентификатор стадии задачи | Число |
TITLE | Название стадии задачи | Строка |
SORT | Порядковый номер стадии для сортировки | Число |
COLOR | Цвет стадии задачи | Строка |
GROUP_ID | Идентификатор проекта, к которому относится задача | Число |
GROUP_NAME | Название проекта, к которому относится задача | Строка |
GROUP_INFO | Идентификатор и название проекта | Строка |
task_uf — пользовательские поля задачи. Набор содержит дополнительные данные задач: привязку к элементам CRM, письмам и информацию из пользовательских полей. Можно узнать, с какими сделками связана задача, и добавить информацию из полей, которые вы создали самостоятельно.
task_uf
Поле | Описание | Тип данных |
---|---|---|
TASK_ID | Идентификатор задачи | Число |
UF_CRM_TASK | Названия элементов CRM, указанные в задаче | Строка |
UF_MAIL_MESSAGE | Идентификатор письма, из которого была создана задача | Строка |
UF_AUTO_"номер поля"
|
Информация из пользовательского поля с указанным номером, например из UF_AUTO_123456789 . Номер автоматически присваивается полю при создании
|
Строка |
task_elapsed_time — время работы над задачей. Набор содержит данные о затраченном времени на задачи: даты начала работы, продолжительность в секундах и информацию об авторах записей. Вы можете узнать, кто и сколько времени работал над задачей.
task_elapsed_time
Поле | Описание | Тип данных |
---|---|---|
ID | Идентификатор записи | Число |
TASK_ID | Идентификатор задачи | Число |
USER_ID | Идентификатор автора записи | Число |
USER_NAME | Имя автора записи | Строка |
USER | Идентификатор и имя автора записи в истории задачи | Строка |
DATE_START | Дата начала работы над задачей | Дата |
ELAPSED_TIME | Время работы над задачей в секундах | Число |
flow — потоки. Набор содержит данные о потоках задач: их названия, администраторов, типы распределения задач и привязку к проектам. Вы можете отслеживать, как задачи распределяются в потоках, кто их создал и какие задачи включены в каждый поток.
flow
Поле | Описание | Тип данных |
---|---|---|
ID | Идентификатор потока | Число |
NAME | Название потока | Строка |
ID_NAME | Идентификатор и название потока | Строка |
CREATOR_ID | Идентификатор создателя потока | Число |
CREATOR_NAME | Имя создателя потока | Строка |
CREATOR_ID_NAME | Идентификатор и имя создателя потока | Строка |
OWNER_ID | Идентификатор администратора потока | Число |
OWNER_NAME | Имя администратора потока | Строка |
OWNER_ID_NAME | Идентификатор и имя администратора потока | Строка |
PLANNED_COMPLETION_TIME | Время на выполнение задачи в секундах | Число |
DISTRIBUTION_TYPE | Тип распределения задач в потоке: «По очереди», «Вручную», «Самостоятельно» | Строка |
HAS_TEMPLATE | В потоке есть шаблон задач: Y — да, N — нет | Строка |
ACTIVE | Поток включен: Y — да, N — нет | Строка |
GROUP_ID | Идентификатор проекта, в котором находится поток | Число |
GROUP_NAME | Название проекта, в котором находится поток | Строка |
GROUP_ID_NAME | Идентификатор и название проекта, в котором находится поток | Строка |
TASKS_IDS | Идентификаторы всех задач, добавленных в поток | Строка |
task_efficiency — эффективность задач. Набор содержит данные о событиях, влияющих на выполнение задач: изменение крайних сроков и наличие просрочек. Вы можете отслеживать замечания и контролировать просроченные задачи.
task_efficiency
Поле | Описание | Тип данных |
---|---|---|
ID | Идентификатор записи о событии | Число |
TASK_ID | Идентификатор задачи, к которой привязана запись о событии | Число |
DATETIME | Время создания записи о событии | Дата |
DATETIME_REPAIR | Время изменения крайнего срока у просроченной задачи | Дата |
IS_VIOLATION | Является ли событие замечанием: Y — да, N — нет | Строка |
Набор содержит информацию о проектах: названия, имена владельцев, участников, типы, сроки и активность. Вы можете отслеживать статусы проектов, их участников, а также даты начала и завершения работ.
socialnetwork_group
Поле | Описание | Тип данных |
---|---|---|
ID | Идентификатор группы | Число |
SITE_ID | Код сайта для многодепартаментности | Строка |
NAME | Название группы | Строка |
DESCRIPTION | Описание группы | Строка |
DATE_CREATE | Дата создания группы | Дата и время |
DATE_MODIFY | Дата последнего изменения группы | Дата и время |
OPENED | Открытая группа: Y — да, N — нет | Строка |
SUBJECT | Тематика группы | Строка |
OWNER_ID | Идентификатор владельца группы | Число |
OWNER_NAME | Имя владельца группы | Строка |
OWNER | Идентификатор и имя владельца группы | Строка |
KEYWORDS | Теги группы | Строка |
MODERATORS_IDS | Идентификаторы модераторов группы | Строка |
MEMBERS_IDS | Идентификаторы участников группы | Строка |
TYPE | Тип группы: group — группа, project — проект, scrum — скрам | Строка |
NUMBER_OF_MEMBERS | Количество участников группы | Число |
DATE_ACTIVITY | Дата последней активности в группе | Дата и время |
CLOSED | Группа в архиве: Y — да, N — нет | Строка |
PROJECT | Группа является проектом: Y — да, N — нет | Строка |
PROJECT_DATE_START | Дата начала проекта | Дата и время |
PROJECT_DATE_FINISH | Дата завершения проекта | Дата и время |
SCRUM_MASTER_ID | Идентификатор скрам-мастера | Число |
SCRUM_MASTER_NAME | Имя скрам-мастера | Строка |
SCRUM_MASTER | Идентификатор и имя скрам-мастера | Строка |
SCRUM_SPRINT_DURATION | Длительность спринта в скрам-команде. Время в секундах | Число |
SCRUM_TASK_RESPONSIBLE | Исполнитель по умолчанию в скрам-команде: A – постановщик, M – скрам-мастер | Строка |
Создать график
Информацию из набора данных можно добавить в графики и отслеживать выполнение задач. Графики покажут активность сотрудников, этапы работы над проектами и соблюдение сроков.
- 1–2. Откройте BI Конструктор > Charts > + График.
- 3–4. Выберите набор данных и формат, в котором хотите видеть информацию: карточка, таблица, линейный график или другой вариант. Если в списке нет нужного набора, нажмите Добавить датасет и создайте набор данных.
Как создать набор данных - 5. Нажмите Создать новый график.
Объединить наборы данных
Объедините наборы данных, чтобы добавить в отчет информацию о просроченных задачах сотрудника и посмотреть, когда переносился крайний срок в его задачах.
- Откройте BI конструктор и перейдите в раздел SQL > SQL Lab.
- Выберите схему bitrix24
- Впишите SQL-запрос и нажмите Выполнить. Новый набор включает сведения из полей, которые вы задали в 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 = 89 -- Замените на идентификатор нужного исполнителя 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-запрос, сохраните результат как датасет и создайте график.
Рекомендуем прочитать: