Вернуться к статьям Рассмотрим учебный сценарий сервисной компании: в одной сделке собраны задачи по обслуживанию клиента, а менеджеру нужен читаемый перечень работ.
Подготовьте связи и данные
Проверьте, что задачи связаны именно с нужной сделкой. Похожее название задачи или принадлежность к общему проекту не заменяют связь с CRM-карточкой. Если требуется показать время, сотрудники должны зарегистрировать трудозатраты.
Перед созданием отчёта определите его смысл. Перечень связанных задач — это снимок данных. Для отчёта о завершённых работах нужно отдельно проверить статусы и состав списка. Не подписывайте весь автоматически полученный перечень как «выполнено», если в нём есть незавершённые задачи.
Выберите три колонки
| Колонка | Значение |
|---|---|
| Дата | Дата создания задачи |
| Работа | Название задачи |
| Зарегистрированное время | Трудозатраты, внесённые в учёт времени |
Дата создания не равна дате завершения. Если клиенту нужен другой показатель, сначала проверьте его наличие в каталоге и подготовленном сценарии, а не переименовывайте колонку с прежними данными.
Таблица в Word
В настоящей Word-таблице подготовьте отдельные строки начала и конца цикла. Между ними разместите строку с тремя ячейками:
{%tr for item in tasks %}
{{ item.created_date | date }} {{ item.title }} {{ item.time_spent_in_logs | duration("HH:mm:ss") }}
{%tr endfor %}
В строке данных каждое выражение занимает отдельную ячейку. Заголовок таблицы находится перед циклом. При формировании строка повторяется для каждой связанной задачи.
Таблица в Excel
Для XLSX используются отдельные строки листа:
{{#tasks}}
{{ item.created_date | date }} {{ item.title }} {{ item.time_spent_in_logs | duration("HH:mm:ss") }}
{{/tasks}}
Не объединяйте ячейки через границы блока. После генерации проверьте перенос длинных названий и область печати. Учебные файлы отчётов доступны на странице приложения.
Как трактовать время
time_spent_in_logs содержит зарегистрированные секунды. Это не плановая оценка, не длительность существования задачи и не автоматически рассчитанная стоимость работы. Например, 9300 секунд отображаются как 02:35:00.
Если время отсутствует, пустая ячейка может означать отсутствие записей, а не доказанный ноль выполненных работ. Решите, нужно ли оставлять её пустой или выводить явное пояснение. Для расчёта стоимости потребуется отдельное правило с тарифами и проверенным составом работ.
Проверьте отчёт до передачи клиенту
Сверьте количество строк и названия с задачами сделки. Возьмите пример с внесённым временем и без него. Убедитесь, что документ не содержит внутренних комментариев или сведений, которые не предназначены клиенту.
Проверьте также пустой список. Если связанных задач нет, отчёт не должен заполняться посторонними задачами из проекта. Найдите причину отсутствия связи, прежде чем менять шаблон.
Частые вопросы
Можно ли получить такой же отчёт из предложения CRM?
В описанной реализации список связанных задач для сущности «Предложение» не загружается. Проверяйте поддерживаемый источник; пример этой статьи относится к сделке.
Получится ли готовый акт выполненных работ?
Можно использовать перечень как часть подготовленного документа, но статус выполнения, состав услуг, стоимость и условия приёмки проверяются отдельно. Таблица задач не подтверждает их автоматически.
Порядок загрузки шаблона и запуска из CRM приведён в инструкции «Фабрики документов».