Набор данных — это информация по лидам, сделкам, компаниям и другим элементам Битрикс24. Для каждого элемента предусмотрены несколько наборов данных, в которые автоматически передаются сведения из системных и пользовательских полей. С помощью наборов можно создавать графики и анализировать показатели бизнеса.
В статье расскажем про наборы данных для смарт-процессов и покажем, как их объединять и создавать графики.
Наборы:
- crm_dynamic_items — смарт-процесс,
- crm_entity_stage_history — история стадий элементов смарт-процессов,
- crm_dynamic_items_prod — товары в смарт-процессах,
- crm_automated_solution — смарт-процессы цифрового рабочего места,
- crm_smart_proc — список смарт-процессов,
- crm_entity_relation — связи между смарт-процессами и элементами CRM.
Примеры:
Выбрать набор данных
Чтобы проанализировать информацию в отчете, выберите подходящий набор данных и создайте график.
crm_dynamic_items_"идентификатор типа" — смарт-процесс. Набор включает основные сведения из системных и пользовательских полей смарт-процесса. Вы можете узнать, сколько элементов было создано за месяц и какие сотрудники с ними работали.
Каждый смарт-процесс — это отдельный набор данных со своими полями и колонками. Чтобы использовать данные в отчете, нужно узнать его идентификатор типа. Идентификатор автоматически присваивается смарт-процессу при создании, например crm_dynamic_items_1032.
Где посмотреть идентификатор типа смарт-процесса
crm_dynamic_items_"идентификатор типа"
| Поле | Описание | Тип данных |
|---|---|---|
| ID | ID элемента смарт-процесса | Число |
| XML_ID | Внешний ID для связи с внешними системами | Строка |
| TITLE | Название элемента смарт-процесса | Строка |
| CREATED_BY | ID и имя сотрудника, который создал элемент | Строка |
| CREATED_BY_ID | ID сотрудника, который создал элемент | Число |
| CREATED_BY_NAME | Имя сотрудника, который создал элемент | Строка |
| UPDATED_BY | ID и имя сотрудника, который последним обновил элемент | Строка |
| UPDATED_BY_ID | ID сотрудника, который последним обновил элемент | Число |
| UPDATED_BY_NAME | Имя сотрудника, который последним обновил элемент | Строка |
| MOVED_BY | ID и имя сотрудника, который изменил стадию элемента | Строка |
| MOVED_BY_ID | ID сотрудника, который изменил стадию элемента | Число |
| MOVED_BY_NAME | Имя сотрудника, который изменил стадию элемента | Строка |
| CREATED_TIME | Дата и время создания элемента | Дата и время |
| UPDATED_TIME | Дата и время последнего обновления элемента | Дата и время |
| MOVED_TIME | Дата и время изменения стадии элемента | Дата и время |
| CATEGORY | ID и название направления элемента | Строка |
| CATEGORY_ID | ID направления элемента | Число |
| CATEGORY_NAME | Название направления элемента | Строка |
| OPENED |
Элемент доступен всем пользователям: Y — да, N — нет
|
Строка |
| STAGE | Код и название текущей стадии элемента | Строка |
| STAGE_ID | Код текущей стадии элемента | Строка |
| STAGE_NAME | Название текущей стадии элемента | Строка |
| PREVIOUS_STAGE_ID | Код предыдущей стадии элемента | Строка |
| BEGINDATE | Дата и время начала события или процесса | Дата и время |
| CLOSEDATE | Дата и время окончания события или процесса | Дата и время |
| COMPANY | ID и название компании, связанной с элементом | Строка |
| COMPANY_ID | ID компании, связанной с элементом | Число |
| COMPANY_NAME | Название компании, связанной с элементом | Строка |
| CONTACT | ID и имя контакта, связанного с элементом | Строка |
| CONTACT_ID | ID контакта, связанного с элементом | Число |
| CONTACT_NAME | Имя контакта, связанного с элементом | Строка |
| CONTACTS | ID и имена всех контактов, связанных с элементом | Строка |
| OPPORTUNITY | Ожидаемая сумма | Число |
| IS_MANUAL_OPPORTUNITY |
Ожидаемая сумма введена вручную: Y — да, N — нет
|
Строка |
| TAX_VALUE | Сумма налога | Число |
| CURRENCY_ID | Код валюты ожидаемой суммы | Строка |
| OPPORTUNITY_ACCOUNT | Ожидаемая сумма в валюте отчетов | Число |
| TAX_VALUE_ACCOUNT | Сумма налога в валюте отчетов | Число |
| ACCOUNT_CURRENCY_ID | Код валюты отчетов | Строка |
| MYCOMPANY | ID и название собственной компании | Строка |
| MYCOMPANY_ID | ID собственной компании | Число |
| MYCOMPANY_NAME | Название собственной компании | Строка |
| SOURCE | Код и название источника | Строка |
| SOURCE_ID | Код источника | Строка |
| SOURCE_NAME | Название источника | Строка |
| SOURCE_DESCRIPTION | Описание источника | Строка |
| ASSIGNED_BY | ID и имя ответственного за элемент | Строка |
| ASSIGNED_BY_ID | ID ответственного за элемент | Число |
| ASSIGNED_BY_NAME | Имя ответственного за элемент | Строка |
| WEBFORM_ID | ID CRM-формы, из которой создан элемент | Число |
UF_CRM_"номер поля"
|
Данные из пользовательского поля с указанным номером, например UF_CRM_123456789
|
Зависит от типа поля |
crm_entity_stage_history — история стадий элементов смарт-процессов. Набор содержит данные о движении элементов по стадиям: даты начала и завершения стадии, ответственного, отдел, воронку, стадию и тип стадии.
Используйте набор, чтобы анализировать путь элемента смарт-процесса и находить этапы, на которых работа занимает больше времени. Например, руководитель может увидеть, что заявки дольше всего остаются на стадии согласования, и проверить, почему сотрудники не успевают обработать их вовремя.
crm_entity_stage_history
| Поле | Описание | Тип данных |
|---|---|---|
| ID | ID записи в истории стадий | Число |
| TYPE_ID | Тип записи в истории стадий | Число |
| OWNER_TYPE_ID | ID типа смарт-процесса | Число |
| OWNER_ID | ID элемента смарт-процесса, у которого изменилась стадия | Число |
| DATE_CREATE | Дата и время создания записи в истории стадий | Дата и время |
| START_DATE | Дата начала периода, когда элемент находился на стадии | Дата |
| END_DATE | Дата завершения периода, когда элемент находился на стадии | Дата |
| RESPONSIBLE_BY_ID | ID ответственного за элемент смарт-процесса | Число |
| RESPONSIBLE_BY_NAME | Имя ответственного за элемент смарт-процесса | Строка |
| RESPONSIBLE_BY | ID и имя ответственного за элемент смарт-процесса | Строка |
| RESPONSIBLE_BY_DEPARTMENT | Путь в иерархии отделов ответственного сотрудника | Строка |
| CATEGORY_ID | ID воронки смарт-процесса | Число |
| CATEGORY_NAME | Название воронки смарт-процесса | Строка |
| CATEGORY | ID и название воронки смарт-процесса | Строка |
| STAGE_SEMANTIC_ID | Код типа стадии | Строка |
| STAGE_SEMANTIC | Тип стадии, например «В работе» | Строка |
| STAGE_ID | Код стадии | Строка |
| STAGE_NAME | Название стадии | Строка |
| STAGE | Код и название стадии | Строка |
crm_dynamic_items_prod_"идентификатор типа" — товары в смарт-процессах. Набор содержит данные о товарах. Вы можете узнать названия товаров, их количество и цены в выбранном смарт-процессе.
Чтобы использовать данные о товарах в отчете, нужно знать идентификатор типа смарт-процесса, к которому относятся товары. Например, у вас есть смарт-процесс «Заказы» с идентификатором типа 105. Этот идентификатор будет указан в названии набора данных о товарах: crm_dynamic_items_prod_105.
Где посмотреть идентификатор типа смарт-процесса
crm_dynamic_items_prod_"идентификатор типа"
| Поле | Описание | Тип данных |
|---|---|---|
| ID | ID записи о товаре или услуге | Число |
| ITEM_ID | ID элемента смарт-процесса | Число |
| PRODUCT | ID и название товара или услуги | Строка |
| PRODUCT_ID | ID товара или услуги | Число |
| PRODUCT_NAME | Название товара или услуги | Строка |
| PRICE | Цена товара или услуги | Число |
| PRICE_EXCLUSIVE | Цена товара или услуги без налога со скидкой | Число |
| PRICE_NETTO | Цена товара или услуги без скидок и налогов | Число |
| PRICE_BRUTTO | Цена товара или услуги без скидок с налогом | Число |
| QUANTITY | Количество товара или услуги | Число |
| DISCOUNT_TYPE | Код и название типа скидки | Строка |
| DISCOUNT_TYPE_ID | Код типа скидки | Число |
| DISCOUNT_TYPE_NAME | Название типа скидки | Строка |
| DISCOUNT_RATE | Размер скидки | Число |
| DISCOUNT_SUM | Сумма скидки | Число |
| TAX_RATE | Ставка налога | Число |
| TAX_INCLUDED |
Налог включен в цену: Y — да, N — нет
|
Строка |
| CUSTOMIZED |
Товар или услуга изменены вручную после добавления в элемент: Y — да, N — нет
|
Строка |
| MEASURE | Код и название единицы измерения | Строка |
| MEASURE_CODE | Код единицы измерения | Число |
| MEASURE_NAME | Название единицы измерения | Строка |
| SORT | Порядок сортировки | Число |
| PARENT | Раздел товара или услуги | Строка |
| SUPERPARENT | Раздел товара или услуги на уровень выше | Строка |
| SUPERSUPERPARENT | Раздел товара или услуги на два уровня выше | Строка |
crm_automated_solution_"идентификатор цифрового рабочего места" — смарт-процессы цифрового рабочего места. Набор содержит информацию о цифровом рабочем месте и связанных с ним смарт-процессах, в том числе их названия и идентификаторы.
Посмотреть идентификатор цифрового рабочего места можно в разделе Автоматизация > Цифровые рабочие места > Список цифровых рабочих мест в колонке ID.
Что такое цифровое рабочее место
crm_automated_solution_"идентификатор цифрового рабочего места"
| Поле | Описание | Тип данных |
|---|---|---|
| ENTITY_TYPE_ID | ID типа смарт-процесса | Число |
| TITLE | Название смарт-процесса | Строка |
| DATASET_NAME | Название набора данных смарт-процесса | Строка |
| AUTOMATED_SOLUTION_DATASET_NAME | Название набора данных цифрового рабочего места | Строка |
| CUSTOM_SECTION_ID | ID цифрового рабочего места | Число |
| CUSTOM_SECTION_TITLE | Название цифрового рабочего места | Строка |
crm_smart_proc — список смарт-процессов. Набор содержит список всех смарт-процессов и цифровых рабочих мест. Вы можете узнать идентификаторы и названия каждого процесса и рабочего места.
crm_smart_proc
| Поле | Описание | Тип данных |
|---|---|---|
| ENTITY_TYPE_ID | ID типа смарт-процесса | Число |
| TITLE | Название смарт-процесса | Строка |
| DATASET_NAME | Название набора данных смарт-процесса | Строка |
| AUTOMATED_SOLUTION_DATASET_NAME |
Название набора данных цифрового рабочего места. Если смарт-процесс не добавлен в рабочее место, указано CRM
|
Строка |
| CUSTOM_SECTION_ID | ID цифрового рабочего места | Число |
| CUSTOM_SECTION_TITLE | Название цифрового рабочего места | Строка |
| PRODUCT_DATASET_NAME | Название набора данных товаров смарт-процесса | Строка |
| USER_FIELDS | Коды пользовательских полей смарт-процесса | Строка |
crm_entity_relation — связи между смарт-процессами и элементами CRM. Набор содержит информацию о связях между смарт-процессами, новыми счетами и другими элементами CRM. Например, в нем можно узнать, какие сделки связаны с элементами смарт-процессов.
Стандартные связи между элементами CRM, например между сделкой и компанией или лидом и сделкой, в этом наборе не хранятся. Они указаны в наборах соответствующих элементов CRM.
crm_entity_relation
| Поле | Описание | Тип данных |
|---|---|---|
| SRC_ENTITY_TYPE_ID |
ID типа связанного элемента: лид — 1, сделка — 2, контакт — 3, компания — 4, счет — 31, предложение — 7, реквизит — 8
|
Число |
| SRC_ENTITY_ID | ID связанного элемента | Число |
| SRC_ENTITY_DATASET_NAME | Название набора данных связанного элемента | Строка |
| DST_ENTITY_TYPE_ID | ID типа смарт-процесса | Число |
| DST_ENTITY_ID | ID элемента смарт-процесса, с которым установлена связь | Число |
| DST_ENTITY_DATASET_NAME | Название набора данных смарт-процесса, с которым установлена связь | Строка |
Создать график
Информацию из набора данных можно добавить в графики и следить за показателями бизнеса. Графики покажут, какие товары продаются чаще и общий объем продаж.
1–2. Откройте BI Конструктор > Графики > + График.
3–4. Выберите набор данных и формат, в котором хотите видеть информацию: карточка, таблица, линейный график или другой вариант. Если в списке нет нужного набора, нажмите Создать датасет и создайте набор данных.
Как создать набор данных
5. Нажмите Создать график.
Объединить наборы данных
Объедините наборы данных, чтобы добавить в отчет информацию о том, какие товары использовались в элементах смарт-процесса.
1. Откройте BI Конструктор и перейдите в раздел SQL > SQL Lab.
2. Проверьте, что в поле Схема выбран bitrix24.
3. Введите SQL-запрос и нажмите Выполнить.
4. Проверьте результаты запроса. Чтобы создать график для отчета, сохраните запрос как датасет. В датасет попадут сведения из полей, которые вы указали в SQL-запросе.
Как создать и добавить в отчет график на основе виртуального набора данных
Если объединяете наборы данных в первый раз, посмотрите пример запроса.
Пример SQL-запроса
Мы написали SQL-запрос, чтобы извлечь данные из четырех наборов: смарт-процесс (crm_dynamic_items_1036), товары смарт-процесса (crm_dynamic_items_prod_1036), свойства товаров (crm_product_property) и значения свойств товаров (crm_product_property_value). Вы можете скопировать его и посмотреть, как работает выборка.
Запрос выбирает элементы смарт-процесса с товарами, название которых содержит слово «плащ», и показывает их свойства с разбивкой по цветам. Замените crm_dynamic_items_"идентификатор типа" и crm_dynamic_items_prod_"идентификатор типа" на ваш смарт-процесс перед выполнением запроса.
SELECT crm_dynamic_items_1036.ID AS "идентификатор элемента смарт-процесса", crm_dynamic_items_1036.TITLE AS "название элемента смарт-процесса", crm_dynamic_items_prod_1036.PRODUCT_ID AS "идентификатор товара", crm_dynamic_items_prod_1036.PRODUCT_NAME AS "название товара", crm_dynamic_items_prod_1036.PRICE AS "цена товара", crm_product_property.NAME AS "название свойства", crm_product_property_value.VALUE_NAME AS "значение свойства" FROM crm_dynamic_items_1036 LEFT JOIN crm_dynamic_items_prod_1036 ON crm_dynamic_items_prod_1036.ITEM_ID = crm_dynamic_items_1036.ID LEFT JOIN crm_product_property_value ON crm_product_property_value.PRODUCT_ID = crm_dynamic_items_prod_1036.PRODUCT_ID LEFT JOIN crm_product_property ON crm_product_property.ID = crm_product_property_value.PROPERTY_ID WHERE crm_dynamic_items_prod_1036.PRODUCT_NAME LIKE '%плащ%' AND crm_product_property.NAME = 'Цвет';
SELECT — определяет, какую информацию надо извлечь из набора данных. Например, запрос crm_dynamic_items_1036.ID AS "идентификатор элемента смарт-процесса":
- выбирает идентификатор элемента смарт-процесса
IDиз набораcrm_dynamic_items_1036, - присваивает ему название
идентификатор элемента смарт-процесса, - выводит результат в отдельную колонку в таблице.
FROM — указывает основной набор, из которого извлекаются данные. Мы получаем данные из crm_dynamic_items_1036 — это таблица, которая содержит информацию об элементах смарт-процесса.
LEFT JOIN — связывает таблицу crm_dynamic_items_1036 с crm_dynamic_items_prod_1036 по идентификатору элемента смарт-процесса. Запрос соединяет каждый элемент смарт-процесса с его товарами. Используем LEFT JOIN, чтобы не пропустить элементы смарт-процесса, у которых нет связанных товаров или свойств.
LEFT JOIN — связывает таблицу crm_dynamic_items_prod_1036 с crm_product_property_value по идентификатору товара. Запрос соединяет каждый товар со значениями свойств.
LEFT JOIN — связывает таблицу crm_product_property_value с crm_product_property по идентификатору свойства товара. Запрос соединяет значения свойств с их названиями.
WHERE — фильтрует результаты и показывает элементы смарт-процесса, которые содержат товары со словом «плащ» в названии, и отображает значение их свойств с разбивкой по цветам. Фильтры в запросе можно удалить или заменить. Например, в условии crm_dynamic_items_prod_1036.PRODUCT_NAME LIKE '%плащ%' вы можете заменить слово «плащ», чтобы искать другие товары.
Коротко
- Набор данных — это информация по лидам, сделкам, компаниям и другим элементам Битрикс24.
- Для каждого элемента предусмотрены несколько наборов данных, в которые автоматически передаются сведения из системных и пользовательских полей.
- Для смарт-процессов есть шесть наборов данных: смарт-процесс (crm_dynamic_items), история стадий элементов смарт-процессов (crm_entity_stage_history), товары в смарт-процессах (crm_dynamic_items_prod), смарт-процессы цифрового рабочего места (crm_automated_solution), список смарт-процессов (crm_smart_proc) и связи между смарт-процессами и элементами CRM (crm_entity_relation).
- С помощью наборов можно создавать графики и анализировать показатели. Графики покажут объем продаж и товары, которые покупали чаще всего.
- Наборы данных можно объединять, чтобы добавить в отчет информацию о том, какие товары использовались в элементах смарт-процесса. Для этого напишите SQL-запрос, сохраните результат как датасет и создайте график.