Общее ¶
Общая информация
В Окдеск встроены базовые отчеты по работе сервисной службы. Отчеты постоянно развиваются, но иногда потребности клиентов в аналитике превосходят наши “продуктовые” границы — быть системой анализа данных или конструктором отчетов Окдеск не может. Иначе на ключевую функциональность не останется времени.
Системы анализа данных — это специальный класс систем/программ. Они не привязаны к модели данных, которые предлагается анализировать. Такие системы могут собирать данные из разных источников (helpdesk-система, система управления складом, бухгалтерская система) и давать полную картину и аналитику по всей компании. У пользователей есть возможность настраивать произвольные отчеты с любой детализацией и визуализацией. Такие системы называются BI-системами (Business Intelligence).
Для компаний, чей бизнес требует глубокой аналитики, мы разработали интерфейс для интеграции с BI-системами. По сути, мы даем доступ к данным аккаунта в SQL-представлении — к этим данным можно как подключить BI-систему, так и просто делать SQL-запросы напрямую.
Для предоставления доступа к SQL API необходимо:
-
купить опцию “Расширенный набор отчетов / интеграция с BI” (для тарифов “Эксперт” или “Профи”) или купить тариф “Все включено”;
-
написать запрос на подключение SQL API к вашему аккаунту на help@okdesk.ru;
-
после получения реквизитов доступа вы можете изменить пароль пользователя, выполнив sql-запрос:
ALTER USER user_name WITH PASSWORD 'new_password'
где user_name — имя пользователя, под которым вы планируете подключаться к SQL API, а new_password — новый пароль, который вы хотите установить пользователю.
Данные в SQL API обновляются один раз в 3 часа. SQL API будет развиваться по требованию клиентов в соответствии с реальными кейсами.
Заявки ¶
Таблица заявок (issues)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID заявки |
| sequential_id | integer | Номер заявки |
| parent_id | integer | ID родительской заявки (уникальный ID заявки из таблицы issues) |
| company_id | integer | ID компании, привязанной к заявке (уникальный ID компании из таблицы companies) |
| contact_id | integer | ID контактного лица, привязанного к заявке (уникальный ID контакта из таблицы users) |
| maintenance_entity_id | integer | ID объекта обслуживания, привязанного к заявке (уникальный ID объекта обслуживания из таблицы company_maintenance_entities) |
| assignee_id | integer | ID ответственного за заявку (уникальный ID сотрудника из таблицы users) |
| author_id | integer | ID автора заявки (уникальный ID сотрудника или контакта из таблицы users) |
| agreement_id | integer | ID договора, привязанного к заявке |
| status_id | integer | ID текущего статуса заявки (уникальный ID статуса заявки из таблицы issue_statuses) |
| work_type_id | integer | ID типа заявки (уникальный ID типа заявки из таблицы issue_work_types) |
| priority_id | integer | ID приоритета заявки (уникальный ID приоритета заявки из таблицы issue_priorities) |
| title | character varying | Название заявки |
| created_at | timestamp | Дата регистрации заявки |
| completed_at | timestamp | Дата решения заявки |
| deadline_at | timestamp | Плановая дата решения заявки |
| employees_updated_at | timestamp | Дата последнего изменения заявки для сотрудника |
| contacts_updated_at | timestamp | Дата последнего изменения заявки для контакта |
| delay_to | timestamp | Отложена до |
| spent_time_total | double | Затраченное время на заявку |
| start_execution_until | timestamp | Начать выполнение до |
| planned_execution_in_hours | double | Плановая продолжительность |
| planned_reaction_at | timestamp | Плановое время реакции на заявку |
| reacted_at | timestamp | Время реакции на заявку |
| deleted_at | timestamp | Дата удаления заявки |
| spent_seconds_for_reaction_in_sla | integer | Время реакции в секундах (по графику обслуживания) |
| spent_seconds_for_completion_in_sla | integer | Время решения в секундах (по графику обслуживания) |
| group_id | integer | ID ответственной группы заявки (уникальный ID группы сотрудников из таблицы groups) |
| parameters | jsonb | Дополнительные атрибуты заявки |
| source | integer | Способ регистрации заявки. Возможные значения: {0=>“Электронная почта”, 1=>“Web-форма”, 2=>“Клиентский портал”, 3=>“Диспетчер”, 4=>“API”, 5=>“Мобильный сотрудник”, 6=>“Партнерская заявка”, 7=>“Телеграм”, 8=>“Оборудование клиента”, 9=>“Повторяющаяся заявка”, 10=>“Оборудование клиента”, 11=>“Мобильный контакт”} |
Примечание: ¶
-
В таблице issues хранятся все заявки, включая удаленные. У удаленных заявок присутствует дата удаления deleted_at. У остальных заявок значение отсутствует.
-
Дополнительные атрибуты заявки хранятся в виде jsonb. Данное поле представляет собой хеш, в котором ключом является код дополнительного атрибута, а значением является хранимое значение дополнительного атрибута.
Например:
Есть дополнительный атрибут заявки с кодом service. В заявке с номером 56 в данном дополнительном атрибуте указано значение free. В таблице issues для заявки с номером sequential_id = 56 в атрибуте parameters будет храниться хеш вида {service: ‘free’}.
Таблица с комментариями (comments)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID комментария |
| issue_id | integer | Уникальный ID заявки из таблицы issues |
| author_id | integer | Уникальный ID автора комментария. ID из таблицы users, если комментарий от Контакта или Сотрудника. ID из таблицы companies, если комментарий от Компании. |
| author_type | character varying | Company если комментарий от Компании или User если комментарий от Контакта или Сотрудника |
| is_public | boolean | Признак “Публичный” |
| published_at | timestamp | Дата публикации комментария |
Таблица типов заявок (issue_work_types)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID типа заявки |
| code | character varying | Код типа заявки |
| name | character varying | Название типа заявки |
| inner | boolean | Признак типа заявки “Внутренняя” |
Таблица приоритетов заявок (issue_priorities)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID приоритета заявки |
| code | character varying | Код приоритета заявки |
| name | character varying | Название приоритета заявки |
Таблица с доп атрибутами заявок (issue_parameters)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID доп. атрибута |
| code | character varying | Код доп. атрибута |
| name | character varying | Название доп. атрибута |
| sequential_id | integer | ID доп. атрибута в рамках аккаунта |
| field_type | integer | Тип доп. атрибута. Возможные значения: {0=>“Строка”, 1=>“Дата”, 2=>“Дата/время”, 3=>“Чекбокс”, 4=>“Значение из списка”, 5=>“Набор значений из списка”} |
| required | boolean | Признак обязательности |
| field_type_values | array | Набор допустимых значений доп. атрибута |
Таблица статусов заявок (issue_statuses)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID статуса заявки |
| code | character varying | Код статуса заявки |
| name | character varying | Название статуса заявки |
Таблица истории смены статусов заявок (issue_status_times)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID смены статуса заявки |
| start_at | timestamp | Дата перехода заявки в статус |
| end_at | timestamp | Дата выхода заявки из статуса |
| value | integer | Количество секунд, которое заявка провела в статусе (астрономическое время) |
| on_schedule_value | integer | Количество секунд, которое заявка провела в статусе с учетом графика обслуживания |
| status_id | integer | ID статуса заявки (уникальный ID статуса заявки из таблицы issue_statuses) |
| issue_id | integer | ID заявки (уникальный ID заявки из таблицы issues) |
Таблица трудозатрат по заявкам (time_entries)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID трудозатраты |
| employee_id | integer | ID сотрудника (уникальный ID сотрудника из таблицы users) |
| spent_time | double | Затраченное время |
| comment | text | Комментарий |
| issue_id | integer | ID заявки (уникальный ID заявки из таблицы issues) |
| created_at | timestamp | Дата/время добавления трудозатраты |
Таблица спецификаций по заявкам (issue_services)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID строки спецификации заявки |
| service_id | integer | ID услуги (уникальный ID услуги из таблицы services) |
| issue_id | integer | ID заявки (уникальный ID заявки из таблицы issues) |
| quantity | double | Количество |
| discount | double | Скидка |
| total | double | Стоимость с учетом НДС |
| total_nds | double | Величина НДС |
| performer_id | integer | ID сотрудника (уникальный ID сотрудника из таблицы users) |
Таблица с названием способов регистрации заявок (issue_sources)
| Название столбца | Тип | Описание |
|---|---|---|
| code | integer | Код способа регистрации заявок (таблица issues, столбец issue_source) |
| locale | character varying | Локаль для которой определено указанное в столбце value название способа регистрации аккаунта |
| value | character varying | Название способа регистрации в локали из столбца locale |
Таблица с оценками заявок (issue_rates)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID оценки заявки |
| issue_id | character varying | ID заявки (уникальный ID заявки из таблицы issues) |
| value | character varying | Код оценки заявки. Возможные значения: {0=>“Плохо”, 1=>“Нормально”, 2=>“Хорошо”, null=>“Без оценки”} |
Таблица с переводами оценок заявок (issue_rates_localized)
| Название столбца | Тип | Описание |
|---|---|---|
| code | integer | Код оценки заявки (таблица issue_rates, столбец value) |
| locale | character varying | Локаль для которой определено указанное в столбце value название оценки заявки |
| value | character varying | Название оценки заявки в локали из столбца locale |
Компании ¶
Таблица компаний (companies)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID компании |
| sequential_id | integer | ID компании в рамках аккаунта |
| name | character varying (2000) | Название компании |
| additional_name | character varying | Дополнительное название компании |
| category_id | integer | ID категории компании (уникальный ID категории компании из таблицы company_categories) |
| crm_1c_id | character varying | Идентификатор компании в 1С |
| parameters | jsonb | Дополнительные атрибуты компании |
Примечание: ¶
Дополнительные атрибуты компании хранятся в виде jsonb. Данное поле представляет собой хеш, в котором ключом является код дополнительного атрибута, а значением является хранимое значение дополнительного атрибута.
Например:
Есть дополнительный атрибут компании с кодом service. Для компании в данном дополнительном атрибуте указано значение free. В таблице companies для этой компании в атрибуте parameters будет храниться хеш вида {service: ‘free’}.
Таблица категорий компаний (company_categories)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID категории компании |
| code | character varying | Код категории компании |
| name | character varying | Название категории компании |
Объекты обслуживания ¶
Таблица объектов обслуживания (company_maintenance_entities)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID объекта обслуживания |
| sequential_id | integer | ID объекта обслуживания в рамках аккаунта |
| name | character varying | Название объекта обслуживания |
| company_id | integer | ID компании, к которой привязан объект обслуживания (уникальный ID компании из таблицы companies) |
| parameters | jsonb | Дополнительные атрибуты объекта обслуживания |
Примечание: ¶
Дополнительные атрибуты объекта обслуживания хранятся в виде jsonb. Данное поле представляет собой хеш, в котором ключом является код дополнительного атрибута, а значением является хранимое значение дополнительного атрибута.
Например:
Есть дополнительный атрибут объекта обслуживания с кодом service. Для объекта обслуживания в данном дополнительном атрибуте указано значение free. В таблице company_maintenance_entities для этого объекта обслуживания в атрибуте parameters будет храниться хеш вида {service: ‘free’}.
Таблица адресов объектов обслуживания и компаний (addresses)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID адреса |
| string_value | character varying | Текстовое значение адреса |
| coordinates | point | Координаты адреса |
| owner_id | integer | ID объекта обслуживания или компании (уникальный ID объекта обслуживания из таблицы company_maintenance_entities или компании из таблицы companies) |
| owner_type | character varying | Company::MaintenanceEntity для объектов обслуживания, Company для компаний |
Примечание: ¶
Таблица addresses хранит адреса разных объектов. На данный момент предоставлен доступ к адресам объектов обслуживания и адресам компаний. Связь между адресом и связанным объектом является полиморфической. Для объектов обслуживания в атрибуте owner_type хранится значение Company::MaintenanceEntity, в атрибуте owner_id хранится id объекта обслуживания. Для компаний в атрибуте owner_type хранится значение Company, в атрибуте owner_id хранится id компании.
Оборудование ¶
Таблица оборудования (equipments)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID оборудования |
| sequential_id | integer | ID оборудования в рамках аккаунта |
| inventory_number | character varying | Инвентарный номер оборудования |
| serial_number | character varying | Серийный номер оборудования |
| equipment_model_id | integer | ID модели оборудования (уникальный ID модели оборудования из таблицы equipment_models) |
| equipment_kind_id | integer | ID типа оборудования (уникальный ID типа оборудования из таблицы equipment_kinds) |
| equipment_manufacturer_id | integer | ID производителя оборудования (уникальный ID производителя оборудования из таблицы equipment_manufacturers) |
| company_id | integer | ID компании, к которой привязано оборудование (уникальный ID компании из таблицы companies) |
| maintenance_entity_id | integer | ID объекта обслуживания, к которому привязано оборудование (уникальный ID объекта обслуживания из таблицы company_maintenance_entities) |
| parameters | jsonb | Дополнительные атрибуты оборудования |
Примечание: ¶
Дополнительные атрибуты оборудования хранятся в виде jsonb. Данное поле представляет собой хеш, в котором ключом является код дополнительного атрибута, а значением является хранимое значение дополнительного атрибута.
Например:
Есть дополнительный атрибут оборудования с кодом service. Для оборудования в данном дополнительном атрибуте указано значение free. В таблице equipments для этого оборудования в атрибуте parameters будет храниться хеш вида {service: ‘free’}.
Таблица связи оборудования с заявками (issue_equipments)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID связи оборудования с заявкой |
| issue_id | integer | ID заявки (уникальный ID заявки из таблицы issues) |
| equipment_id | integer | ID оборудования (уникальный ID оборудования из таблицы equipments) |
Таблица типов оборудования (equipment_kinds)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID типа оборудования |
| code | character varying | Код типа оборудования |
| name | character varying | Название типа оборудования |
Таблица производителей оборудования (equipment_manufacturers)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID производителя оборудования |
| code | character varying | Код производителя оборудования |
| name | character varying | Название производителя оборудования |
Таблица моделей оборудования (equipment_models)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID модели оборудования |
| code | character varying | Код модели оборудования |
| name | character varying | Название модели оборудования |
| equipment_manufacturer_id | integer | ID производителя оборудования (уникальный ID производителя оборудования из таблицы equipment_manufacturers) |
| equipment_kind_id | integer | ID типа оборудования (уникальный ID типа оборудования из таблицы equipment_kinds) |
Договоры ¶
Таблица с договорами (agreements)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID договора |
| sequential_id | integer | ID договора в рамках аккаунта |
| title | character varying | Название договора |
| parameters | jsonb | Дополнительные атрибуты договора |
Таблица связей договоров с компаниями (company_agreements)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID записи |
| company_id | integer | Уникальный идентификатор связанной компании из таблицы companies |
| agreement_id | integer | Уникальный идентификатор связанного договора из таблицы agreements |
Таблица с сервисными периодами (agreement_service_periods)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID сервисного периода |
| sequential_id | integer | Номер сервисного периода в рамках аккаунта |
| agreement_id | integer | Уникальный идентификатор связанного договора |
| start_date | date | Дата начала сервисного периода |
| end_date | date | Дата завершения сервисного периода |
| cost | double precision | Стоимость сервисного периода |
| paid | boolean | Статус оплаченности |
| postpay | boolean | Признак постоплаты |
Прайс-листы ¶
Таблица строк прайс-листов (services)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID услуги |
| code | character varying | Код услуги |
| name | character varying | Название услуги |
| service_type | integer | Раздел услуги |
| unit | character varying | Единица измерения |
| price | double | Цена |
| nds | integer | Ставка НДС, % |
| price_list_id | integer | ID прайс-листа (уникальный ID прайс-листа из таблицы price_lists) |
Таблица со списком прайс-листов (price_lists)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID прайс-листа |
| name | character varying | Название прайс-листа |
Пользователи ¶
Таблица пользователей (users)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID пользователя |
| sequential_id | integer | ID пользователя в рамках аккаунта |
| first_name | character varying | Имя пользователя |
| last_name | character varying | Фамилия пользователя |
| position | character varying (300) | Должность пользователя |
| patronymic | character varying (100) | Отчество пользователя |
| company_id | integer | ID компании пользователя (уникальный ID компании из таблицы companies, только для пользователей-контактов) |
| type | character varying | Тип пользователя (см. примечания) |
| crm_1c_id | character varying | Идентификатор пользователя в 1C |
| parameters | jsonb | Дополнительные атрибуты пользователя (только для пользователей-контактов) |
| deleted_at | timestamp | Дата удаления пользователя |
Примечание: ¶
-
В таблице users хранится информация и о сотрудниках, и о контактных лицах. Их различает атрибут type. Для сотрудников хранится значение Employee, для контактов — Contact.
-
Дополнительные атрибуты контакта хранятся в виде jsonb. Данное поле представляет собой хеш, в котором ключом является код дополнительного атрибута, а значением является хранимое значение дополнительного атрибута.
Например:
Есть дополнительный атрибут контакта с кодом service. Для контакта в данном дополнительном атрибуте указано значение free. В таблице users для этого контакта в атрибуте parameters будет храниться хеш вида {service: ‘free’}.
Таблица групп сотрудников (groups)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID группы сотрудников |
| sequential_id | integer | ID группы в рамках аккаунта |
| name | character varying | Название группы сотрудников |
Информация об аккаунте ¶
Таблица информации об аккаунте (accounts)
| Название столбца | Тип | Описание |
|---|---|---|
| id | integer | Уникальный ID аккаунта |
| name | character varying | Название аккаунта |
| parked_domain | character varying | Припаркованный домен, если есть |
| timezone | character varying | Часовой пояс аккаунта |
| locale | character varying | Язык аккаунта |
