some more docs
This commit is contained in:
parent
2b1d550f11
commit
3ff455ba45
34
README.md
34
README.md
@ -1,7 +1,10 @@
|
||||
# DOCS report
|
||||
Функционал
|
||||
|
||||
Позволяет добавлять в модель отчётов в качестве шаблона-источника файлы формата docx.
|
||||
Получить отчёты на основе такого шаблона можно в формате docx или pdf.
|
||||
На данный момент одновременное создание нескольких отчетов не поддерживается.
|
||||
|
||||
Для преобразования docx -> pdf требуется доступный сервис gotenberg на localhost:8808.
|
||||
Пример запуска сервиса в docker-compose рядом с Odoo:
|
||||
|
||||
@ -16,3 +19,34 @@ gotenberg:
|
||||
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" записи кастомного поля.
|
||||
|
Loading…
x
Reference in New Issue
Block a user