DOCS report

Функционал

Позволяет добавлять в модель отчётов в качестве шаблона-источника файлы формата docx. Получить отчёты на основе такого шаблона можно в формате docx или pdf. На данный момент одновременное создание нескольких отчетов не поддерживается.

Для преобразования docx -> pdf требуется доступный сервис gotenberg на localhost:8808. Пример запуска сервиса в docker-compose рядом с Odoo:

gotenberg:
    image: thecodingmachine/gotenberg:6
    restart: unless-stopped
    environment:
        LOG_LEVEL: INFO
        DEFAULT_LISTEN_PORT: 8808
        DISABLE_GOOGLE_CHROME: 1
        DEFAULT_WAIT_TIMEOUT: 30
        MAXIMUM_WAIT_TIMEOUT: 60

Создание отчета

Создание отчета выполняется аналогично стандартной процедуре Odoo:

1. В Settings -> Technical -> Reports нужно создать новую запись. В записи отчета выбрать один из новых типов: "DOCX" или "DOCX(PDF)". Поле "Template name" заполнять не нужно, а вместо этого загрузить docx файл отчета. Все остальные поля заполняются так же, как и в стандартных отчетах Odoo.
2. Если в шаблоне отчета применены кастомные поля, то нужно их создать на вкладке "Сustom fields".
3. В записи указанной модели, в меню печати, появится дополнительный пункт с названием созданного отчета. По нажатию на него отобразится визард, в котором можно проверить значения кастомных полей перед генерацией файла отчета.
4. При генерации отчета с портала файл генерируется без отображения визарда.

Создание шаблонов

1. Шаблоны можно создавать в любом текстовом редакторе, поддерживающем формат docx.
2. Всё форматирование шаблона сохраняется в генерируемом отчете.
3. Для вставки переменных используются двойные фигурные скобки.
4. Доступ к записи Odoo, для которой вызвана генерация отчета, выполняется через переменную "docs", обращение к атрибутам и методам как в Оду: {{ docs.attribute_name }}
5. Возможен вызов методов, имеющихся у записи в "docs", или переданных в контекст отчета.
6. По умолчанию в контексте отчета присутствуют методы модуля "report_monetary_helper", которые могут быть вызваны непосредственно по имени.
7. Так же в контексте отчета могут присутствовать кастомные поля. Такие поля должны быть созданы в записи отчета. В шаблоне кастомные поля доступны по имени, указанному в поле "tech_name" записи кастомного поля.