Фабрика документов

Отчёт по задачам: таблица и трудозатраты

Отдельные циклы Word и Excel, готовые учебные файлы, JSON и ожидаемый результат. Как проверить связь задач со сделкой и зарегистрированное время.

Содержание руководства

Эта инструкция поможет вывести задачи контрольной сделки в Word или Excel: дату создания, название и зарегистрированные трудозатраты. Начните с одной сделки и двух учебных задач, связанных с ней.

1. Подготовьте задачи и выберите формат

  1. Откройте контрольную сделку CRM.
  2. Проверьте, что нужные задачи связаны именно с этой карточкой. Совпадения названия задачи и сделки недостаточно.
  3. Проверьте зарегистрированные трудозатраты. Поле time_spent_in_logs содержит секунды из записей трудозатрат, а не плановую оценку и не возраст задачи.
  4. Выберите DOCX для текстового отчёта или XLSX для таблицы. Можно начать с учебного DOCX или учебного XLSX.

Для предложений (КП) список связанных задач в текущей реализации не загружается. Наличие задач у клиента не означает, что они связаны с выбранной карточкой. Права пользователя на задачи также влияют на доступность данных.

2. Таблица задач в Word

В Word создайте настоящую таблицу из трёх столбцов. Шапку «Создана / Задача / Трудозатраты» поставьте в первой строке. Ниже подготовьте ещё три строки:

Назначение строки Ячейка 1 Ячейка 2 Ячейка 3
Начало {%tr for item in tasks %}
Данные {{ item.created_date | date("dd.MM.yyyy") }} {{ item.title }} {{ item.time_spent_in_logs | duration | default("00:00:00") }}
Конец {%tr endfor %}

В служебных строках начала и конца можно объединить ячейки. Эти строки удалятся при формировании; строка данных повторится для каждой задачи. Не переносите весь пример одним абзацем. Полная загрузка DOCX.

3. Таблица задач в Excel

В Excel поставьте заголовки в A1:C1. В A2, A3:C3 и A4 расположите:

Строка листа A B C
2 {{#tasks}}
3 {{ item.created_date | date("dd.MM.yyyy") }} {{ item.title }} {{ item.time_spent_in_logs | duration | default("00:00:00") }}
4 {{/tasks}}

Слова «Начало» и «Данные» в книгу не нужны. Не объединяйте ячейки через границы блока. Если нужны секунды числом, замените выражение в C3 на {{ item.time_spent_in_logs | duration("seconds") }}. Отсутствие времени и реальный ноль проверяйте отдельно. Полная загрузка XLSX.

4. Загрузите и проверьте шаблон

  1. В приложении откройте «Шаблоны» → «Новый шаблон».
  2. Укажите название, например «Учебный отчёт по задачам», и уникальный код training_tasks_01.
  3. Выберите соответствующий «Тип», укажите свой файл в поле «Файл», отметьте сделку в «Сущности шаблона».
  4. Нажмите «Загрузить шаблон» и прочитайте сообщения анализа.
  5. В карточке откройте «Тестовая генерация» и вставьте:
{
  "tasks": [
    {"created_date": "2026-10-15T10:00:00+03:00", "title": "Подготовить предложение", "time_spent_in_logs": 9300},
    {"created_date": "2026-10-15T11:00:00+03:00", "title": "Согласовать условия", "time_spent_in_logs": 0}
  ]
}
  1. Нажмите «Проверить JSON», затем «Сформировать документ».
  2. Скачайте результат и откройте его в Word или Excel.

Должны появиться две строки с датой 15.10.2026. У первой задачи ожидается 02:35:00, у второй 00:00:00. Для проверки пустоты удалите у второй задачи поле time_spent_in_logs: с приведённой цепочкой duration | default останется 00:00:00.

5. Получите реальные задачи сделки

Откройте контрольную сделку, запустите «Сформировать документ», выберите этот шаблон и скачайте новый файл. Сравните состав задач и зарегистрированное время с CRM.

Если строк нет, проверьте связь задач, доступ пользователя и выбранную сущность. Если список tasks пуст, строк данных в результате не будет. Тестовый JSON не создаёт задачи в CRM и не проверяет их загрузку.

Форматы времени · Источники данных · Решение проблем