С помощью расширенного редактора вы можете передать в 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
|
Дата начала, дата-время, дата начала
|
END_DATE
|
Дата конца, дата-время, дата завершения
|
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
Продублируйте сущность и добавьте код в окно Расширенного редактора.
После этого полученные данные можно будет использовать для построения отчета.