Набор данных — это информация по лидам, сделкам, компаниям и другим элементам Битрикс24. Для каждого элемента предусмотрены несколько наборов данных, в которые автоматически передаются сведения из системных и пользовательских полей.
С помощью наборов можно создавать графики и анализировать показатели эффективности бизнеса. Графики покажут, какая реклама привлекает клиентов и какие товары продаются чаще. Наборы данных можно объединять. Например, данные о сделках и пользовательских полях.
В статье расскажем про наборы данных для сделок и покажем, как их объединять и создавать графики.
Наборы:
- crm_deal — сделки,
- crm_deal_uf — пользовательские поля сделок,
- crm_deal_stage_history — история стадий сделок,
- crm_deal_product_row — товары и услуги в сделках.
Примеры:
Выбрать набор данных
crm_deal — сделки. Набор содержит данные из системных полей сделок: названия, стадии, ответственные, суммы, источники и другие. Используйте набор, чтобы анализировать воронку и результаты продаж.
crm_deal
| Поле | Описание | Тип данных |
|---|---|---|
| ID | ID сделки | Число |
| DATE_CREATE | Дата и время создания сделки | Дата и время |
| CREATED_BY_ID | ID сотрудника, создавшего сделку | Число |
| CREATED_BY | ID и имя сотрудника, создавшего сделку | Строка |
| CREATED_BY_NAME | Имя сотрудника, создавшего сделку | Строка |
| DATE_MODIFY | Дата и время последнего изменения сделки | Дата и время |
| MODIFY_BY_ID | ID сотрудника, изменившего сделку | Число |
| MODIFIED_BY | ID и имя сотрудника, изменившего сделку | Строка |
| MODIFIED_BY_NAME | Имя сотрудника, изменившего сделку | Строка |
| ASSIGNED_BY_ID | ID сотрудника, ответственного за сделку | Число |
| ASSIGNED_BY | ID и имя сотрудника, ответственного за сделку | Строка |
| ASSIGNED_BY_DEPARTMENT | Путь в иерархии отделов ответственного сотрудника | Строка |
| ASSIGNED_BY_NAME | Имя сотрудника, ответственного за сделку | Строка |
| MOVED_BY_ID | ID сотрудника, сменившего стадию сделки | Число |
| MOVED_BY | ID и имя сотрудника, сменившего стадию сделки | Строка |
| MOVED_BY_NAME | Имя сотрудника, сменившего стадию сделки | Строка |
| MOVED_TIME | Дата и время смены стадии сделки | Дата и время |
| LEAD_ID | ID лида, на основании которого создана сделка | Число |
| COMPANY_NAME | Название компании, связанной со сделкой | Строка |
| COMPANY_ID | ID компании, связанной со сделкой | Число |
| COMPANY | ID и название компании, связанной со сделкой | Строка |
| MYCOMPANY_ID | ID компании из раздела «Мои компании», к которой относится сделка | Число |
| MYCOMPANY_NAME | Название компании из раздела «Мои компании», к которой относится сделка | Строка |
| MYCOMPANY | ID и название компании из раздела «Мои компании», к которой относится сделка | Строка |
| CONTACT_ID | ID основного контакта, связанного со сделкой | Число |
| CONTACT_NAME | Имя основного контакта, связанного со сделкой | Строка |
| CONTACT | ID и имя основного контакта, связанного со сделкой | Строка |
| CONTACT_IDS | ID всех контактов, связанных со сделкой | Строка |
| CONTACTS | ID и имена всех контактов, связанных со сделкой | Строка |
| OPENED |
Сделка доступна для всех: Y — да, N — нет
|
Строка |
| TITLE | Название сделки | Строка |
| CRM_PRODUCT | ID и названия товаров или услуг в сделке | Строка |
| CATEGORY_ID | ID воронки сделки | Число |
| CATEGORY_NAME | Название воронки сделки | Строка |
| CATEGORY | ID и название воронки сделки | Строка |
| STAGE_ID | Код стадии сделки | Строка |
| STAGE_NAME | Название стадии сделки | Строка |
| STAGE | Код и название стадии сделки | Строка |
| PREVIOUS_STAGE_ID | Код предыдущей стадии сделки | Строка |
| PREVIOUS_STAGE_NAME | Название предыдущей стадии сделки | Строка |
| PREVIOUS_STAGE | Код и название предыдущей стадии сделки | Строка |
| STAGE_SEMANTIC_ID |
Код типа стадии: F — неуспешная, S — успешная, P — в работе
|
Строка |
| STAGE_SEMANTIC | Тип стадии: «Провал», «Успех», «В работе» | Строка |
| IS_NEW |
Сделка находится на первой стадии: Y — да, N — нет
|
Строка |
| IS_RECURRING |
По шаблону сделки создаются регулярные сделки: Y — да, N — нет
|
Строка |
| IS_RETURN_CUSTOMER |
Сделка с повторным клиентом: Y — да, N — нет
|
Строка |
| CLOSED |
Сделка находится на финальной стадии: Y — да, N — нет
|
Строка |
| TYPE_ID | Код типа сделки | Строка |
| TYPE_NAME | Название типа сделки | Строка |
| OPPORTUNITY_ACCOUNT | Ожидаемая сумма в валюте отчетов | Число |
| OPPORTUNITY | Ожидаемая сумма сделки | Число |
| IS_MANUAL_OPPORTUNITY |
Ожидаемая сумма введена вручную: Y — да, N — нет
|
Строка |
| TAX_VALUE | Сумма налога сделки | Число |
| TAX_VALUE_ACCOUNT | Сумма налога в валюте отчетов | Число |
| CURRENCY_ID | Код валюты сделки | Строка |
| ACCOUNT_CURRENCY_ID | Код валюты отчетов | Строка |
| PROBABILITY | Вероятность успешного закрытия сделки | Число |
| COMMENTS | Комментарии в сделке | Строка |
| BEGINDATE | Дата и время открытия сделки | Дата и время |
| CLOSEDATE | Планируемая дата и время закрытия сделки | Дата и время |
| LOCATION_ID | ID местоположения клиента | Число |
| SOURCE_ID | Код источника сделки | Строка |
| SOURCE_NAME | Название источника сделки | Строка |
| SOURCE | Код и название источника сделки | Строка |
| SOURCE_DESCRIPTION | Описание источника сделки | Строка |
| ORIGINATOR_ID | ID внешней системы, в которой создана сделка | Строка |
| ORIGIN_ID | ID сделки во внешней системе | Строка |
| ADDITIONAL_INFO | Дополнительная информация о сделке | Строка |
| UTM_SOURCE | Значение параметра utm_source — источник трафика | Строка |
| UTM_MEDIUM | Значение параметра utm_medium — тип трафика | Строка |
| UTM_CAMPAIGN | Значение параметра utm_campaign — рекламная кампания | Строка |
| UTM_CONTENT | Значение параметра utm_content — рекламный контент | Строка |
| UTM_TERM | Значение параметра utm_term — ключевое слово | Строка |
| BANK_DETAIL_ID | ID банковских реквизитов | Число |
| CRM_PRODUCT_ID | ID строк товаров или услуг в сделке | Строка |
| CRM_PRODUCT_COUNT | Количество каждого товара или услуги в сделке | Строка |
| WEBFORM_ID | ID CRM-формы, из которой создана сделка | Число |
| WEBFORM_NAME | Название CRM-формы, из которой создана сделка | Строка |
| WEBFORM | ID и название CRM-формы, из которой создана сделка | Строка |
crm_deal_uf — пользовательские поля сделок. Набор содержит данные из пользовательских полей, которые вы создали самостоятельно: срок доставки, номер заказа и другие. Используйте набор, чтобы добавлять в отчеты собственные параметры сделок.
crm_deal_uf
| Поле | Описание | Тип данных |
|---|---|---|
| DEAL_ID | ID сделки | Число |
| DATE_CREATE | Дата и время создания сделки | Дата и время |
| CLOSEDATE | Планируемая дата и время закрытия сделки | Дата и время |
| UF_CRM_"номер поля" |
Значение пользовательского поля с указанным номером, например UF_CRM_123456789. Номер автоматически присваивается полю при создании.
|
Строка |
crm_deal_stage_history — история стадий сделок. Набор содержит данные из системных полей истории стадий сделок: даты переходов, стадии, ответственные, воронки и другие. Используйте набор, чтобы анализировать движение сделок по стадиям и время работы на каждой стадии.
crm_deal_stage_history
| Поле | Описание | Тип данных |
|---|---|---|
| ID | ID записи в истории стадий | Число |
| TYPE_ID |
Тип записи: 1 — создание сделки, 2 — переход на промежуточную стадию, 3 — переход на финальную стадию
|
Число |
| DEAL_ID | ID сделки, у которой изменилась стадия | Число |
| DATE_CREATE | Дата и время создания записи в истории стадий | Дата и время |
| START_DATE | Дата начала стадии | Дата |
| END_DATE | Дата завершения стадии | Дата |
| ASSIGNED_BY_NAME | Имя сотрудника, ответственного за сделку | Строка |
| ASSIGNED_BY_ID | ID сотрудника, ответственного за сделку | Число |
| ASSIGNED_BY | ID и имя сотрудника, ответственного за сделку | Строка |
| ASSIGNED_BY_DEPARTMENT | Путь в иерархии отделов ответственного сотрудника | Строка |
| STAGE_SEMANTIC_ID |
Код типа стадии: F — неуспешная, S — успешная, P — в работе
|
Строка |
| STAGE_SEMANTIC | Тип стадии: «Провал», «Успех», «В работе» | Строка |
| STAGE_ID | Код стадии сделки | Строка |
| STAGE | Код и название стадии сделки | Строка |
| STAGE_NAME | Название стадии сделки | Строка |
| CATEGORY | ID и название воронки сделки | Строка |
| CATEGORY_NAME | Название воронки сделки | Строка |
| CATEGORY_ID | ID воронки сделки | Число |
crm_deal_product_row — товары и услуги в сделках. Набор содержит данные из системных полей товаров и услуг в сделках: названия, цены, количество, скидки, налоги и другие. Используйте набор, чтобы анализировать продажи товаров и услуг.
crm_deal_product_row
| Поле | Описание | Тип данных |
|---|---|---|
| ID | ID записи о товаре или услуге | Число |
| DEAL_ID | ID сделки | Число |
| DEAL_DATE_CREATE | Дата и время создания сделки | Дата и время |
| DEAL_CLOSEDATE | Планируемая дата и время закрытия сделки | Дата и время |
| PRODUCT | ID и название товара или услуги | Строка |
| PRODUCT_ID | ID товара или услуги | Число |
| PRODUCT_NAME | Название товара или услуги | Строка |
| PRICE | Цена товара или услуги | Число |
| PRICE_EXCLUSIVE | Цена товара или услуги без налога со скидкой | Число |
| PRICE_NETTO | Цена товара или услуги без скидок и налогов | Число |
| PRICE_BRUTTO | Цена товара или услуги без скидок, с налогом | Число |
| QUANTITY | Количество товара или услуги | Число |
| SUM_NETTO | Сумма товара или услуги без скидок и налогов | Число |
| SUM_EXCLUSIVE | Сумма товара или услуги без налога со скидкой | Число |
| SUM_TOTAL | Итоговая сумма товара или услуги со скидкой и налогом | Число |
| CURRENCY_ID | Код валюты сделки, в которой рассчитаны суммы товара или услуги | Строка |
| 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 | Порядок сортировки товара или услуги | Число |
| CATEGORY | ID и название воронки сделки | Строка |
| CATEGORY_NAME | Название воронки сделки | Строка |
| PARENT | Раздел товара | Строка |
| SUPERPARENT | Раздел товара на уровень выше | Строка |
| SUPERSUPERPARENT | Раздел товара на два уровня выше | Строка |
Создать график
1–2. Откройте BI Конструктор > Графики > + График.
3–4. Выберите набор данных и формат, в котором хотите видеть информацию: карточка, таблица, линейный график или другой вариант.
5. Нажмите Создать график.
Объединить наборы данных
Объедините наборы данных, чтобы включить в отчет информацию из системных и пользовательских полей сделки. Чтобы объединить наборы данных:
1. Откройте BI Конструктор и перейдите в раздел SQL > SQL Lab.
2. Проверьте, что в поле Схема выбран bitrix24.
3. Введите SQL-запрос и нажмите Выполнить.
4. Проверьте результаты запроса. Чтобы создать график для отчета, сохраните запрос как датасет. В датасет попадут сведения из полей, которые вы указали в SQL-запросе.
Как создать и добавить в отчет график на основе виртуального набора данных
Если объединяете наборы данных в первый раз, посмотрите пример запроса.
Пример SQL-запроса
Мы написали SQL-запрос, чтобы извлечь данные из двух наборов: сделки (crm_deal) и пользовательские поля сделок (crm_deal_uf). Вы можете скопировать его и посмотреть, как работает выборка. Замените UF_CRM_"номер поля" на ваше пользовательское поле перед выполнением запроса.
SELECT
crm_deal.ID AS "Идентификатор сделки",
crm_deal.TITLE AS "Название сделки",
crm_deal.DATE_CREATE AS "Дата создания сделки",
crm_deal.OPPORTUNITY AS "Сумма сделки",
crm_deal_uf.UF_CRM_1723105561632 AS "Пользовательское поле"
FROM
crm_deal
INNER JOIN
crm_deal_uf ON crm_deal.ID = crm_deal_uf.DEAL_ID
WHERE
crm_deal_uf.UF_CRM_1723105561632 IS NOT NULL AND crm_deal_uf.UF_CRM_1723105561632 <> ''
SELECT — определяет, какую информацию надо извлечь из набора данных. Например, запрос SELECT crm_deal.ID AS "Идентификатор сделки":
- выбирает идентификатор сделки
IDиз набораcrm_deal, - присваивает ему название
Идентификатор сделки, - выводит результат в отдельную колонку в таблице.
FROM — указывает основной набор, из которого извлекаются данные. Мы извлекаем из crm_deal.
INNER JOIN — связывает наборы и объединяет информацию в них. Запрос crm_deal_uf ON crm_deal.ID = crm_deal_uf.DEAL_ID соединяет информацию из системных и пользовательских полей по идентификатору сделки.
WHERE — фильтрует результаты и показывает строки, где пользовательское поле не пустое.
Коротко
- Набор данных — это информация по лидам, сделкам, компаниям и другим элементам Битрикс24.
- Для каждого элемента предусмотрены несколько наборов данных, в которые автоматически передаются сведения из системных и пользовательских полей.
- В сделках четыре набора данных: сделки (crm_deal), пользовательские поля (crm_deal_uf), история стадий сделок (crm_deal_stage_history), товары и услуги в сделках (crm_deal_product_row).
- С помощью наборов можно создавать графики и анализировать показатели эффективности бизнеса. Графики покажут, какие товары продаются чаще или какая реклама привлекает клиентов.
- Наборы данных можно объединять, чтобы включить в отчет информацию из системных и пользовательских полей сделок. Для этого напишите SQL-запрос, сохраните результат как датасет и создайте график.