> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hubtalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Шаблон отчёта
> Подписи колонок, замена значений, служебные колонки, структура и язык файла.
# Шаблон отчёта
## Шаблон отчёта
Состав, который нужен каждую неделю, сохраняется под именем: **«Сохранить как шаблон»** запоминает колонки, их порядок, формат выгрузки и четыре настройки ниже — подписи колонок, замены значений, служебные колонки и структуру файла. Шаблоны принадлежат организации — до 50 штук, — и участник ведёт свои целиком, включая удаление. Несохранённый выбор называется **«Свой шаблон»**.
Шаблон — это **копия, а не ссылка**. Задание на отчёт забирает **снимок** шаблона в момент создания, поэтому правка или удаление шаблона не меняют ни одного уже сформированного отчёта. По той же причине при применении старого шаблона мир может оказаться другим: поле пост-аналитики переименовали или убрали, а колонки себестоимости попали в шаблон от того, кому они были видны. Форма говорит об этом строкой над списком: сколько колонок в шаблоне и какие из них сейчас недоступны — галочки с них сняты. Ничего не отваливается за спиной.
Фильтр в шаблон намеренно не входит. Период каждый раз разный, и шаблон, заморозивший «1–14 августа», через месяц был бы бесполезен.
Шаблон без заполненных настроек даёт файл в стандартном виде — если вам ничего из перечисленного не нужно, эти поля можно не трогать.
#### Подписи колонок
У каждой выбранной колонки в правой панели раскрывается поле **«Имя колонки»** — как она будет называться в шапке файла. Пусто — остаётся техническое имя, тот самый ключ. Подпись до 200 символов, это данные шаблона, а не перевод интерфейса: платформа пишет ровно то, что вы задали.
Именно так собирается файл, привычный вашим получателям, без правки разборщиков на нашей стороне.
#### Замена значений
Там же у колонки задаётся таблица **«Заменить значение → на это значение»**: до 100 строк на колонку. Сравнение точное, по строковому виду ячейки; пустое значение тоже можно заменить; всё, чего нет в таблице, выгружается как есть.
Типичное применение — привести технические значения к словам, которые понимает получатель отчёта: `completed` → `Дозвонились`, `voicemail` → `Автоответчик`.
#### Служебные колонки
Кнопка **«Добавить служебную колонку»** создаёт колонку, которой нет в каталоге, — двух видов:
* **одно значение во всех строках** — константа: код выгрузки, название источника, признак партии;
* **несколько колонок в одной** — склейка от двух до пяти колонок каталога через ваш разделитель. Пустая часть пропускается, двойного разделителя не будет.
Служебная колонка занимает своё место в списке справа наравне с обычными; до 30 штук на шаблон.
#### Настройки файла
Блок **«Настройки файла»** отвечает за структуру выгрузки:
* **Лист «Сводка»** — отдельный первый лист с итогами.
* **Лист по колонке** — строки раскладываются по листам: лист на каждое значение колонки, шапка на каждом листе. Доступны агент, статус звонка и причина статуса; имя листа — само значение, обрезанное до 31 символа.
* **Имя файла** — шаблон с подстановками `{campaign_id}`, `{campaign_name}`, `{date}`, `{template}`. Кампания подставится, только если в фильтре ровно одна кампания; расширение добавит сервер. Если кампания в фильтре не названа, вместо `{campaign_id}` встанет **дата создания отчёта**. `{campaign_name}` в этом случае остаётся пустым: имя — украшение, различать файлы должен идентификатор.
* **Все ячейки текстом** — числа и даты записываются как текст, чтобы Excel не менял их вид: не превращал длинные номера в экспоненциальную запись и не терял ведущие нули. Отдельные колонки можно вывести из-под правила и оставить числами.
* **Формат даты** — один из трёх: ISO 8601, `ГГГГ-ММ-ДД ЧЧ:ММ:СС` или `ДД.ММ.ГГГГ ЧЧ:ММ:СС`.
**Для CSV применяются только имя файла и формат даты.** Лист «Сводка», лист по колонке и «все ячейки текстом» — свойства книги XLSX; в форме они остаются видимыми и сохраняются, но к CSV не применяются, и форма об этом пишет.
#### Язык файла
Служебные тексты внутри книги XLSX — имена листов и девять подписей сводки («Всего звонков», «Статус», длительность, доля успешных) — приходят на **языке вашего кабинета**.
Три детали:
* **Язык замораживается в момент создания отчёта.** Файл собирается фоном, иногда сильно позже запроса, и к этому моменту спрашивать уже некого — поэтому язык записывается в задание вместе с фильтром.
* **Имена готовых системных форм и их описания — английские** (у файла импорта — тоже).
* **Подписи колонок не переводятся.** В шапке файла по умолчанию стоят технические ключи (`session_id`, `started_at`) — на них завязаны разборщики на вашей стороне. Читаемую шапку задайте сами, см. [Подписи колонок](#подписи-колонок).
**Уже созданные задания не переписываются.** Снимок имени шаблона, сохранённый в старом задании, остаётся таким, каким был; язык меняется только у новых отчётов.
