Поддержка24

Как передать в Microsoft Power BI сущности из CRM

С помощью расширенного редактора вы можете передать в Microsoft Power BI сущности из Битрикс24 и использовать полученные данные для построения отчета.


Как это работает

В десктоп приложении Microsoft Power BI нужно открыть вкладку Преобразование данных.

Затем нажмите правой кнопкой мыши на сущности и выберите опцию Дублировать.

Переименуйте новую сущность и откройте Расширенный редактор.

В редакторе впишите нужный параметр и нажмите готово:

  • crm_deal – сделки
  • crm_lead – лиды
  • crm_deal_uf – пользовательские поля сделок
  • crm_lead_uf – пользовательские поля лидов
  • crm_deal_stage_history – история сделок
  • crm_lead_status_history – история лидов
  • telephony_call – звонки
  • crm_company – компании
  • crm_contact – контакты
  • socialnetwork_group – проект

Описание полей сущностей


crm_deal – сделки

Поле Описание
ID Уникальный ключ, число
DATE_CREATE Время создания сделки
DATE_MODIFY Время изменения сделки
CREATED_BY_ID Идентификатор создателя, число
CREATED_BY Создатель, строка, ID и имя сотрудника, который создал сделку
MODIFY_BY_ID Идентификатор редактора, число
MODIFIED_BY Редактор, строка, ID и имя автора внесшего последние изменения
ASSIGNED_BY_ID Идентификатор ответственного, число
ASSIGNED_BY Ответственный, строка, ID и имя ответственного за сделку
ASSIGNED_BY_DEPARTMENT Отдел ответственного, строка по типу ("[1] Сладкая Жизнь / [7] ИТ-отдел"), место ответственного в иерархии структуры компании
OPENED Открыт, строка (Y - да, N - нет), открыт для всех сотрудников или нет (относится к правам доступа)
LEAD_ID Идентификатор лида, число – появляется только при конверсии Лида в Сделку
COMPANY_ID Идентификатор компании, число - важно, что это просто связанная компания, это не результат конвертации
COMPANY Компания, строка, ID и название компании
CONTACT_ID Идентификатор контакта, устаревший, число, важно, что это просто связанный контакт, это не результат конвертации
CONTACT Контакт, строка, ID и имя контакта
TITLE Название сделки, строка
CRM_PRODUCT Товар из CRM (может быть несколько), строка, ID и названия товаров
CATEGORY Направление сделки, строка, ID и название.
STAGE_ID Идентификатор стадии, строка
STAGE Стадия, строка, ID и название стадии
STAGE_SEMANTIC_ID Идентификатор типа статуса (STAGE_SEMANTIC_ID), строка: "F": "(failed) - обработана неуспешно", "S": "(success) - обработана успешно", "P": "(processing) - сделка в обработке"
STAGE_SEMANTIC Тип статуса, строка, описание семантического статуса, например "Успех", "Провал", "В работе"
IS_NEW Новая сделка, строка (Y - да, N - нет), сделка находится в "первой" стадии воронки
IS_RECURRING Регулярная сделка, строка Y - да, N - нет
IS_RETURN_CUSTOMER Вернувшийся клиент, строка (Y - да, N - нет)
CLOSED Закрыта, строка (Y - да, N - нет), если сделка переводится в какую-то финальную стадию
TYPE_ID Тип сделки, строка, тип сделки, например "SALE"
OPPORTUNITY Ожидаемая сумма, число
IS_MANUAL_OPPORTUNITY Ожидаемая сумма введена вручную, строка Y - да, N - нет
TAX_VALUE Налог, число
CURRENCY_ID Валюта, строка ("RUB")
OPPORTUNITY_ACCOUNT Сумма в валюте отчетов, число
TAX_VALUE_ACCOUNT Налог в валюте отчетов, число
ACCOUNT_CURRENCY_ID Валюта отчета, строка ("RUB")
PROBABILITY Вероятность, число (23, 57, 12), вероятность (скоринг) перехода в успешный статус
COMMENTS Комментарии, строка
BEGINDATE Поле по умолчанию содержит дату создания сделки и его можно редактировать в интерфейсе
CLOSEDATE Поле по умолчанию содержит дату создания сделки плюс 7 дней. Поле можно редактировать в интерфейсе. В зависимости от настроек поле может быть автоматически заполнено текущей датой при переводе сделки в финальную стадию
LOCATION_ID Местоположение клиента, число
SOURCE_ID Идентификатор источника, строка
SOURCE Источник, строка, ид и название источника ("[STORE] Интернет-магазин")
SOURCE_DESCRIPTION Описание источника, строка, полезно для легенды графика источников
ORIGINATOR_ID Внешняя система, строка ("email-tracker", "other")
ORIGIN_ID Внешний идентификатор, строка
ADDITIONAL_INFO Дополнительная информация, строка
UTM_SOURCE Рекламный источник, строка
UTM_MEDIUM Рекламный носитель, строка
UTM_CAMPAIGN Рекламная кампания, строка
UTM_CONTENT Рекламный контент, строка
UTM_TERM Рекламный термин, строка
BANK_DETAIL_ID Идентификатор банковских реквизитов, строка

crm_lead –лиды

Поле Описание
ID Число, уникальный идентификатор записи
DATE_MODIFY Время изменения, дата-время
DATE_CREATE Время создания, дата-время
CREATED_BY_ID Идентификатор создателя, число, ID сотрудника, который создал лид
CREATED_BY Создатель, строка, идентификатор и имя пользователя, создавшего лид
MODIFY_BY_ID Идентификатор редактора, число, ид автора последнего изменения
MODIFIED_BY Редактор, строка, идентификатор и имя пользователя, последним изменившего документ
ASSIGNED_BY_ID Идентификатор ответственного, число
ASSIGNED_BY Ответственный, строка, ID и имя ответственного
ASSIGNED_BY_DEPARTMENT Отдел ответственного, строка по типу ("[1] Сладкая Жизнь / [7] ИТ-отдел"), место ответственного в иерархии структуры компании
OPENED Открыт, строка (Y - да, N - нет), открыт для всех сотрудников или нет (относится к правам доступа)
COMPANY_ID Идентификатор компании, число
COMPANY Компания, строка, идентификатор и название Компании
CONTACT_ID Идентификатор контакта, число
CONTACT Контакт, строка, идентификатор и название контакта
STATUS_ID Идентификатор статуса в воронке, строка
STATUS Статус, строка, ID и название статуса вида "[NEW] Новый"
STATUS_DESCRIPTION Описание статуса (причин перехода в статус), строка
STATUS_SEMANTIC_ID Идентификатор типа статуса, строка: "F": "(failed) - обработан неуспешно", "S": "(success) - обработан успешно", "P": "(processing) - лид в обработке"
STATUS_SEMANTIC Тип статуса, строка ("Успех", "Провал")
CRM_PRODUCT Товар из CRM, строка
OPPORTUNITY Ожидаемая сумма, число
CURRENCY_ID Валюта, строка
SOURCE_ID Идентификатор источника, строка.
SOURCE Источник, строка, ID и название источника ("[STORE] Интернет-магазин")
SOURCE_DESCRIPTION Описание источника, строка
TITLE Заголовок, строка
FULL_NAME Полное имя, строка
NAME Имя, строка
LAST_NAME Фамилия, строка
SECOND_NAME Отчество, строка
COMPANY_TITLE Название компании, строка
POST Должность, строка
ADDRESS_1 Адрес 1, строка
ADDRESS_2 Адрес 2, строка
ADDRESS_CITY Город, строка
ADDRESS_POSTAL_CODE Почтовый индекс, число
ADDRESS_REGION Регион, строка
ADDRESS_PROVINCE Область, строка
ADDRESS_COUNTRY Страна, строка
ADDRESS_COUNTRY_CODE Код страны, важен ISO код, строка
COMMENTS Комментарии, строка
ORIGINATOR_ID Внешняя система, строка ("email-tracker", "other")
ORIGIN_ID Внешний идентификатор, строка
DATE_CLOSED Время закрытия, дата-время
BIRTHDATE День рождения, дата
HONORIFIC Обращение, строка
UTM_SOURCE Рекламный источник, строка
UTM_MEDIUM Рекламный носитель, строка
UTM_CAMPAIGN Рекламная кампания, строка
UTM_CONTENT Рекламный контент, строка
UTM_TERM Рекламный термин, строка
PHONE Телефон, строка, множественное
WEB URL, строка, множественное
EMAIL E-mail, строка, множественное
IM Мессенджеры, строка, множественное.

crm_deal_uf – пользовательские поля сделок

Поле Описание
DEAL_ID Идентификатор сделки, число
DATE_CREATE Время создания, дата-время
UF_CRM_123456789 Название пользовательского поля, разные типы

crm_lead_uf – пользовательские поля лидов

Поле Описание
LEAD_ID Идентификатор лида, число
DATE_MODIFY Время изменения, дата-время
UF_CRM_123456789 Название пользовательского поля, разные типы

crm_deal_stage_history – история сделок

Поле Описание
ID Уникальный ключ, число, уникальный идентификатор записи
TYPE_ID Тип записи, число, может принимать значения: 1 - создание сущности, 2 - перевод на промежуточную стадию, 3 - перевод на финальную стадию
DEAL_ID Идентификатор сделки, число - идентификатор сущности, в которой изменилась стадия, в данном случае ID сделки
DATE_CREATE Время создания, дата-время, дата и время попадания на стадию
START_DATE

Дата начала, дата-время, дата начала

  • Значение полей crm_deal_stage_history.START_DATE и crm_deal.BEGINDATE равны.
  • END_DATE

    Дата конца, дата-время, дата завершения

  • Значение полей crm_deal_stage_history.END_DATE и crm_deal.CLOSEDATE равны.
  • ASSIGNED_BY_ID Идентификатор ответственного, число, ID ответственного за сделку
    ASSIGNED_BY Ответственный, строка, ID и имя ответственного за сделку
    ASSIGNED_BY_DEPARTMENT Отдел ответственного, строка по типу ("[1] Сладкая Жизнь / [7] ИТ-отдел"), место ответственного в иерархии структуры компании
    STAGE_SEMANTIC_ID Идентификатор типа стадии, строка: "F": "(failed) - обработана неуспешно", "S": "(success) - обработана успешно", "P": "(processing) - сделка в обработке"
    STAGE_SEMANTIC Тип стадии, строка, "Провал", "Успех", "В работе"
    STAGE_ID Идентификатор стадии, строка
    STAGE Стадия, строка, ид и название стадии вида "[NEW] Новый"

    crm_lead_status_history – история лидов

    Поле Описание
    ID Уникальный ключ, число, уникальный идентификатор записи
    TYPE_ID Тип записи, число, может принимать значения: 1 - создание сущности, 2 - перевод на промежуточную стадию, 3 - перевод на финальную стадию
    LEAD_ID Идентификатор лида, число - идентификатор сущности, в которой изменилась стадия, в данном случае ID лида
    DATE_CREATE Время создания, дата-время, дата и время попадания на стадию
    ASSIGNED_BY_ID Идентификатор ответственного, число, ид ответственного за лид, для фильтрации стадий и причин проблем по ответственным
    ASSIGNED_BY Ответственный, строка, ID и имя ответственного за лид
    ASSIGNED_BY_DEPARTMENT Отдел ответственного, строка по типу ("[1] Сладкая Жизнь / [7] ИТ-отдел"), место ответственного в иерархии структуры компании
    STATUS_SEMANTIC_ID Идентификатор типа статуса, строка: "F": "(failed) - обработан неуспешно", "S": "(success) - обработан успешно", "P": "(processing) - лид в обработке"
    STATUS_SEMANTIC Тип статуса, строка, "Провал", "Успех"
    STATUS_ID Идентификатор статуса, строка
    STATUS Статус, строка, ид и название статуса вида "[NEW] Новый"

    telephony_call – звонки

    Поле Описание
    CALL_ID Уникальный идентификатор звонка, строка.
    CALL_TYPE Тип вызова, число, подробнее: 1 - исходящий, 2 - входящий, 3 - входящий с перенаправлением, 4 - обратный звонок.
    CALL_VOTE Оценка звонка, число, оценка звонка.
    COMMENT Комментарий к звонку, строка
    PORTAL_USER_ID Идентификатор оператора, число
    PORTAL_USER Оператор, строка, ID и имя оператора, например "[12] Иван Петров"
    PORTAL_USER_DEPARTMENT Отдел оператора, строка по типу ("[1] Сладкая Жизнь / [7] ИТ-отдел"), место отдела оператора в иерархии структуры компании
    PORTAL_NUMBER Номер оператора, строка, номер телефона портала, связанный со звонком.
    PHONE_NUMBER Номер абонента, строка, номер телефона клиента, куда звонили с портала или откуда звонил клиент.
    CALL_DURATION Продолжительность звонка, число, продолжительность звонка в секундах.
    CALL_START_TIME Время начала звонка, дата-время
    COST Стоимость звонка, число с плавающей точкой
    COST_CURRENCY Валюта звонка, строка, валюта звонка типа: "RUR", "USD", "EUR"
    CALL_STATUS_CODE Код вызова, строка
    CALL_STATUS_REASON Описание кода вызова, строка, расширенное описание кода статуса вызова на латинице: "Skipped call", "Success call" и т.п.
    CRM_ACTIVITY_ID Идентификатор дела CRM, число, идентификатор Дела CRM, созданного на основании звонка.
    CRM_ENTITY_ID Идентификатор объекта CRM, число, идентификатор объекта CRM, найденного по номеру телефона, который может быть Лидом, Контактом или Компанией.
    CRM_ENTITY_TYPE Тип объекта CRM, строка, тип объекта CRM, имеющего идентификатор "CRM_ENTITY_ID", например "CONTACT".
    REST_APP_ID Идентификатор приложения, число, идентификатор приложения интеграции внешней телефонии.
    REST_APP_NAME Название приложения, строка, название приложения интеграции внешней телефонии.
    REDIAL_ATTEMPT Номер попытки дозвониться, число, номер попытки дозвониться (для обратных звонков)
    TRANSCRIPT_ID Идентификатор расшифровки звонка, число, идентификатор расшифровки звонка
    TRANSCRIPT_PENDING Готовность расшифровки, строка "Y/N", признак того, что расшифровка будет получена позднее
    RECORD_FILE_ID Идентификатор файла с записью, число,

    crm_company – компании

    Поле Описание
    ADDRESS_1 Адрес 1, строка
    ADDRESS_2 Адрес 2, строка
    ADDRESS_CITY Город, строка
    ADDRESS_COUNTRY Страна, строка
    ADDRESS_COUNTRY_CODE Код страны, строка
    ADDRESS_POSTAL_CODE Почтовый индекс, строка
    ADDRESS_PROVINCE Область, строка
    ADDRESS_REGION Регион, строка
    ASSIGNED_BY_ID Идентификатор ответственного, число
    ASSIGNED_BY Ответственный, строка, ID имя ответственного
    ASSIGNED_BY_NAME Имя ответственного, строка
    BANKING_DETAILS Банковские реквизиты, строка
    COMMENTS Комментарии, строка
    COMPANY_TYPE Тип компании, строка, "ID и название типа компании"
    COMPANY_TYPE_ID Идентификатор типа компании, строка, ID типа компании
    COMPANY_TYPE_NAME Название типа компании, строка, названии типа компании
    CREATED_BY_ID Идентификатор создателя, число
    CREATED_BY Создатель, строка, ID и имя создателя
    CREATED_BY_NAME Имя создателя, строка
    CURRENCY_ID Валюта, строка
    DATE_CREATE Время создания, дата-время
    DATE_MODIFY Время изменения, дата-время
    EMAIL Email, строка, множественное
    EMPLOYESS Количество сотрудников, строка, например "250-500" (берется из справочника)
    ID Уникальный ключ, число
    IM Мессенджеры, строка, множественное
    INDUSTRY Сфера деятельности, строка, "ID и название сферы деятельности компании"
    INDUSTRY_ID Идентификатор сферы деятельности, строка, ID сферы деятельности компании
    INDUSTRY_NAME Название сферы деятельности, строка, название сферы деятельности компании
    IS_MY_COMPANY Моя компания, строка
    LEAD_ID Идентификатор лида, число, идентификатор лида, связанного с компанией
    MODIFIED_BY Редактор, строка, ID и имя автора последнего изменения
    MODIFY_BY_ID Идентификатор редактора, число, идентификатор автора последнего изменения
    MODIFIED_BY_NAME Имя редактора, строка
    OPENED Доступна для всех, строка
    ORIGINATOR_ID Внешняя система, строка
    ORIGIN_ID Внешний идентификатор, строка, используется только для привязки к внешнему источнику.
    ORIGIN_VERSION Оригинальная версия, строка, используется для защиты данных от случайного перетирания внешней системой
    PHONE Телефон, строка, множественное
    REVENUE Годовой оборот, число с плав. точкой
    TITLE Название компании, строка
    UTM_CAMPAIGN Рекламная компания, строка
    UTM_CONTENT Рекламный контент, строка
    UTM_MEDIUM Рекламный носитель, строка, "CPC (объявления)", "CPM (баннеры)"
    UTM_SOURCE Рекламный источник, строка, Yandex-Direct, Google-Adwords и другие.
    UTM_TERM Рекламный термин, строка, например, ключевые слова контекстной рекламы.
    WEB URL, строка, множественное

    crm_contact – контакты

    Поле Описание
    ADDRESS_1 Адрес 1, строка
    ADDRESS_2 Адрес 2, строка
    ADDRESS_CITY Город, строка
    ADDRESS_COUNTRY Страна, строка
    ADDRESS_COUNTRY_CODE Код страны, строка
    ADDRESS_POSTAL_CODE Почтовый индекс, строка
    ADDRESS_PROVINCE Область, строка
    ADDRESS_REGION Регион, строка
    ASSIGNED_BY_ID Идентификатор ответственного, число
    ASSIGNED_BY Ответственный, строка, ID имя ответственного
    ASSIGNED_BY_NAME Имя ответственного, строка
    BIRTHDATE Дата рождения, дата-время
    COMMENTS Комментарии, строка
    COMPANY_ID Идентификатор компании, число, привязка контакта к компании (первой в списке)
    CREATED_BY_ID Идентификатор создателя, число
    CREATED_BY Создатель, строка, ID и имя создателя
    CREATED_BY_NAME Имя создателя, строка
    DATE_CREATE Время создания, дата-время
    DATE_MODIFY Время изменения, дата-время
    EMAIL Email, строка, множественное
    EXPORT Участвует в экспорте, строка, участвует ли контакт в экспорте. Eсли "N", то выгрузить контакт невозможно
    FACE_ID Идентификатор faceid, число
    HONORIFIC Код обращения, строка, код обращения, например ""HNR_RU_1""
    ID Уникальный ключ, число
    IM Мессенджеры, строка, множественное
    LEAD_ID Идентификатор лида, число, идентификатор лида, связанного с контактом
    MODIFIED_BY Редактор, строка, ID и имя автора последнего изменения
    MODIFIED_BY_NAME Имя редактора, строка
    MODIFY_BY_ID Идентификатор редактора, число
    NAME Имя, строка
    SECOND_NAME Отчество, строка
    LAST_NAME Фамилия, строка
    OPENED Доступен для всех, строка, Y - да или N - нет
    OPENED Доступна для всех, строка
    ORIGINATOR_ID Внешняя система, строка
    ORIGIN_ID Внешний идентификатор, строка, используется только для привязки к внешнему источнику.
    ORIGIN_VERSION Оригинальная версия, строка, используется для защиты данных от случайного перетирания внешней системой
    PHONE Телефон, строка, множественное
    POST Должность, строка
    SOURCE_DESCRIPTION Описание источника, строка
    SOURCE_ID Идентификатор источника, строка, "CALL", "EMAIL" и другие значения из справочника.
    TYPE_ID Идентификатор типа, строка, "CLIENT" и другие значения из справочника
    UTM_CAMPAIGN Рекламная компания, строка
    UTM_CONTENT Рекламный контент, строка
    UTM_MEDIUM Рекламный носитель, строка, "CPC (объявления)", "CPM (баннеры)"
    UTM_SOURCE Рекламный источник, строка, Yandex-Direct, Google-Adwords и другие.
    UTM_TERM Рекламный термин, строка, например, ключевые слова контекстной рекламы.
    WEB URL, строка, множественное

    socialnetwork_group – проект

    Выгружается информация только о видимых проектах. Скрытые проекты не выгружаются.
    Поле Описание
    ID Уникальный ключ, идентификатор проекта или группы
    SITE_ID Код сайта, строка
    NAME Название проекта или группы
    DESCRIPTION Описание проекта или группы
    PROJECT Является проектом, строка, "Y" или "N"
    DATE_CREATE Время создания
    DATE_MODIFY Время изменения, время последнего изменения параметров проекта или группы
    OPENED Открыта ли группа или проект для свободного вступления, строка, "Y" или "N"
    CLOSED Архивная группа, строка, "Y" или "N"
    SUBJECT Тема проекта или группы
    OWNER Владелец проекта или группы
    OWNER_ID ID владельца
    OWNER_NAME Имя владельца
    KEYWORDS Ключевые слова или тэги проекта
    NUMBER_OF_MEMBERS Число участников
    DATE_ACTIVITY Время последней активности

    Пример: как передать пользовательские поля сделок

    Чтобы передать пользовательские поля вы можете использовать код:

    let
        raw_t = bx24_load_entity("crm_deal_uf"),
    
    //["DEAL_ID","DATE_CREATE","UF_CRM_5B8D5D8583F53"]
    
        fixed_t = Table.TransformColumnTypes(raw_t,
            {
                {"DEAL_ID", Int64.Type},//Уникальный ключ
                {"DATE_CREATE", type datetime}//Время изменения
                //{"UF_CRM_5B8D5D8583F53", type text},//Время создания
        }),
    
        renamed_t = Table.RenameColumns(
            fixed_t,
            {
                {"DEAL_ID", "Идентификатор Сделки"}
            }
        )
    
    
    in
        renamed_t

    Продублируйте сущность и добавьте код в окно Расширенного редактора.

    После этого полученные данные можно будет использовать для построения отчета.


    Спасибо, помогло!
    Спасибо :)
    Необязательно:
    Оставить отзыв о статье
    Не помогло
    Очень жаль :(
    Уточните, пожалуйста, почему:
    Это не то, что я ищу
    Очень сложно и непонятно
    Оставить отзыв о статье
    У меня остались вопросы