Перейти к основному содержанию

Шаблон отчёта

Шаблон отчёта

Состав, который нужен каждую неделю, сохраняется под именем: в окне «Отчёт по диалогам» на странице кампании — кнопкой «Сохранить как шаблон», в окне «Экспорт звонков» в Истории — кнопкой «Сохранить как набор». Шаблон запоминает колонки, их порядок, формат выгрузки и четыре настройки ниже — подписи колонок, замены значений, служебные колонки и настройки файла. Несохранённый выбор называется «Свой шаблон». Шаблоны общие для организации — до 50 штук. Каждый пользователь кабинета видит их в группе «Мои шаблоны» и может переименовать, перезаписать или удалить любой из них. Название шаблона — от 1 до 80 символов и уникально в организации: регистр и лишние пробелы не учитываются. В шаблоне должна быть хотя бы одна колонка. Если изменить что-либо в выбранном шаблоне, выбор переключится на «Свой шаблон». Дальше изменения можно записать в исходный шаблон кнопкой «Обновить шаблон «…»» — после подтверждения он перезаписывается — или сохранить как новый шаблон. Действия с шаблоном в двух окнах выглядят по-разному:
  • «Отчёт по диалогам» — кнопки над списком колонок: «Сохранить как шаблон», «Обновить шаблон «…»», «Переименовать» и «Удалить».
  • «Экспорт звонков» — кнопка «Сохранить как набор» и меню ⋮ «Действия с набором»: «Обновить шаблон «…»», «Сохранить как новый набор», «Переименовать» и «Удалить».
«Обновить шаблон «…»» появляется, когда выбранный шаблон изменён; «Переименовать» и «Удалить» — когда выбран сохранённый шаблон. Формы из группы «Формы отчётов v2» — системные и доступны только для чтения: обновить, переименовать или удалить их нельзя. Чтобы изменить форму, поправьте её и сохраните копию — см. Готовые формы. Шаблон — это копия, а не ссылка. Задание на отчёт забирает снимок шаблона в момент создания, поэтому правка или удаление шаблона не меняют ни одного уже сформированного отчёта. По той же причине часть колонок старого шаблона может оказаться недоступной — например, поле пост-аналитики переименовали или убрали. Форма показывает, сколько таких колонок: в окне «Отчёт по диалогам» — строкой «В шаблоне N колонок, сейчас недоступно M» с их названиями, в окне «Экспорт звонков» — отметкой «N недоступны» у заголовка «Колонки». В списке выбранных колонок они зачёркнуты с пометкой «сейчас недоступна» и в файл не попадают. Фильтр в шаблон намеренно не входит. Период каждый раз разный, и шаблон, заморозивший «1–14 августа», через месяц был бы бесполезен. Шаблон без заполненных настроек даёт файл в стандартном виде — если вам ничего из перечисленного не нужно, эти поля можно не трогать. Сохранённый набор выбран в окне экспорта, открыто его меню: «Сохранить как новый набор», «Переименовать» и «Удалить»

Подписи колонок

У каждой выбранной колонки в правой панели раскрывается поле «Имя колонки» — как она будет называться в шапке файла. Пусто — в шапке остаётся ключ колонки. Подпись до 200 символов, это данные шаблона, а не перевод интерфейса: платформа пишет ровно то, что вы задали. Именно так собирается файл, привычный вашим получателям, без правки разборщиков на нашей стороне.

Замена значений

Там же у колонки задаётся таблица «Заменить значение → на это значение»: до 100 строк на колонку. Сравнение точное, по строковому виду ячейки; пустое значение тоже можно заменить; всё, чего нет в таблице, выгружается как есть. Типичное применение — привести технические значения к словам, которые понимает получатель отчёта: completed → Дозвонились, voicemail → Автоответчик. Раскрытая строка колонки: имя колонки в файле и таблица замен значений

Служебные колонки

Кнопка «Добавить служебную колонку» создаёт колонку, которой нет в каталоге, — двух видов:
  • одно значение во всех строках — константа: код выгрузки, название источника, признак партии;
  • несколько колонок в одной — склейка от двух до пяти колонок каталога через ваш разделитель. Пустая часть пропускается, двойного разделителя не будет.
Служебная колонка занимает своё место в списке справа наравне с обычными; до 30 штук на шаблон. Карточка новой служебной колонки: склейка двух колонок каталога через разделитель

Настройки файла

В окне «Отчёт по диалогам» настройки собраны в блоке «Настройки файла»: группы «Любой формат» и «Только XLSX». В окне «Экспорт звонков» — в разделе «Файл»: при Excel сразу под форматом стоят лист сводки и разбивка по листам, остальное — под «Ещё настройки».
  • Лист «Сводка» — отдельный лист с итогами, последний в книге, после листов со звонками.
  • Лист по колонке — строки раскладываются по листам: лист на каждое значение колонки, шапка на каждом листе. Доступны агент, статус звонка и причина статуса. Имя листа — значение, обрезанное до 31 символа, без запрещённых в Excel символов \ / ? * [ ] :; пустое значение попадает на лист «—». Замены значений колонки действуют и на имена листов.
  • Имя файла — шаблон имени до 120 символов. {date} подставляет дату создания отчёта, {template} — название шаблона. {campaign_id} и {campaign_name} подставляются, когда в отчёте одна кампания — со страницы кампании или в «Истории» с одной кампанией в фильтре; если кампания не выбрана, вместо {campaign_id} встанет дата создания отчёта, а {campaign_name} останется пустым. Расширение добавит сервер. Все символы, кроме латинских букв, цифр, ., _, - и пробела, заменяются на _ — название кампании кириллицей превратится в подчёркивания.
  • Заголовки колонок — «Подписи колонок»: ваши имена колонок там, где они заданы, у остальных колонок — ключ; «Технические ключи»: всегда ключи колонок, ваши имена не используются. Служебная колонка в обоих случаях называется своим именем.
  • Все ячейки текстом — числа и даты записываются как текст, чтобы Excel не менял их вид: не превращал длинные номера в экспоненциальную запись и не терял ведущие нули. В окне «Отчёт по диалогам» отдельные колонки можно вывести из-под правила («Кроме колонок:») и оставить числами.
  • Формат даты — один из трёх: ISO 8601, ГГГГ-ММ-ДД ЧЧ:ММ:СС или ДД.ММ.ГГГГ ЧЧ:ММ:СС. Применяется к колонке «Начало».
Раздел «Файл» с выбранным Excel и раскрытыми «Ещё настройки»: лист сводки, разбивка по листам, имя файла, формат даты, заголовки колонок и все ячейки как текст
Для CSV применяются имя файла, формат даты и заголовки колонок. Лист «Сводка», лист по колонке и «все ячейки текстом» — свойства книги XLSX. В окне «Отчёт по диалогам» при CSV они остаются видимыми и сохраняются в шаблоне, но к файлу не применяются, и форма об этом пишет. В окне «Экспорт звонков» при CSV они скрыты.

Язык файла

Служебные тексты внутри книги XLSX — имена листов и девять подписей сводки («Всего звонков», «Статус», длительность, доля успешных) — приходят на языке вашего кабинета. Три детали:
  • Язык замораживается в момент создания отчёта. Файл собирается фоном, иногда сильно позже запроса, и к этому моменту спрашивать уже некого — поэтому язык записывается в задание вместе с фильтром. Уже созданные задания не переписываются.
  • Имена готовых системных форм и их описания — английские.
  • Подписи колонок не переводятся. Без вашего имени колонки в шапке стоит её ключ (session_id, started_at) — на ключи завязаны разборщики на вашей стороне. Читаемую шапку задайте сами, см. Подписи колонок.
Окно «Экспорт звонков»: звонки текущей выборки, набор колонок и формат CSV/Excel Окно «Экспорт звонков» с набором «Полный»: подсказка, что полные транскрипты делают файл больше