==== Отчеты из шаблона docx ====


Приложение позволяет формировать отчеты, используя файл формата docx в качестве шаблона. \\
Шаблон может содержать как статическую, так и динамическую части.

== Статическая часть ==
Статическая часть включает в себя:
  * Колонтитулы
  * Изображения
  * Текст
  * Таблицы

== Динамическая часть ==
Динамическая часть формируется на основе данных, введенных в параметры завершенного процесса.

== Заполнение отчета ==
Для того чтобы разместить значение параметра в определенном месте отчета, используйте теги. \\
Каждый параметр, входящий в шаблон процесса должен иметь уникальный тег. \\
Тег должен полностью совпадать с тегом в шаблоне отчета.

Например, если в шаблоне отчета у вас есть место, обозначенное как {part}, то значение, введенное в соответствующий параметр с тегом part, будет автоматически подставлено в это место. \\
Отчет привязан к препарату. Для каждого препарата можно настроить несколько отчетов.

=== Создание отчета из docx шаблона ===

- Для добавления отчета необходимо убедиться: \\
  * В базовой иерархии есть настроенный шаблон процесса, задачи которого содержат параметры с тегами. \\
  * В параметре в поле теги нет пробелов между тегами. \\
  * Теги параметров уникальны для выбранного процесса, т.е. нет задачи в шаблоне процесса параметры которой содержат одинаковые теги.

== 1. Проверка параметров процесса ==

На примере процесса отбор проб. \\
Проверим наличие тегов параметров задачи "Регистрация пробы". \\

{{:odg_assist_3.0:lims:pasted:20250904-151450.png?500}} \\
{{:odg_assist_3.0:lims:pasted:20250904-151656.png?500}} \\
{{:odg_assist_3.0:lims:pasted:20250904-151900.png?500}}

== 2. Создание шаблона отчета ==

Создайте пустой файл в приложении LibreOffice Writer. Откройте его и создайте каркас будущего отчета \\
Скопируйте теги из параметров задачи и вставьте в шаблон отчета в фигурных скобках. \\
Как в примере: \\
{{:odg_assist_3.0:lims:pasted:20250904-151316.png?800}}

Для вставки используйте комбинациб клавиш Ctrl + Shift + V \\

{{:odg_assist_3.0:lims:pasted:20250904-161655.png?500}} \\

Выберите "Только текст", для исключения вставки скрытых символов.

Сохраните его, в имени можно указать назначение отчета. 

== 3. Загрузка шаблона в приложение ==

Нажмите пункт меню "Шаблоны отчетов". И нажмите "Добавить". \\
Откроется редактор шаблона. Заполните поля редактора. \\
  * Название - введите название шаблона. Название может содержать название препарата и его дозировку или тип упаковки. 
  * Выберите файл и загрузите шаблон
  * Путь к отчету - поле заполнится автоматически
  * Версия - укажите версию
  * Препарат - выберите препарат, для которого загружен шаблон
  * Доступен - установите отметку
  * Отправлять по интеграции - оставьте без изменения

Нажмите "Сохранить".

{{:odg_assist_3.0:lims:pasted:20250904-153136.png?800}}

== Формирование отчета ==

Запустите процесс отбора проб. Укажите препарат, для которого добавлен отчет. \\
После выполнения задачи "Регистрация пробы", содержащей параметры с тегами сформируйте отчет. \\
Пример сформированного отчета: \\
{{:odg_assist_3.0:lims:pasted:20250904-153602.png?800}}

=== Возможные проблемы ===

Не подставляются значения параметров в отчет. \\  Причины: \\  1. Теги имеют разные регистры: \\  {{:odg_assist_3.0:lims:pasted:20250904-160938.png?500}}

Теги должны совпадать в отчете и в параметре

2. Между тегами в параметре есть пробелы \\  {{:odg_assist_3.0:lims:pasted:20250904-160618.png?500}}

3.В отчете есть пробел между скобками и тегами \\  {{:odg_assist_3.0:lims:pasted:20250904-161229.png?500}}


==== Настройка генерации отчета xml в базовой иерархии. ====

Выбрать шаблон отчета. В настройках шаблона  процесса найти поле "Шаблоны отчетов".

В левом поле все отчеты приложения. В правом поле,  все выбранные для генерации отчеты.

Добавить отчет для генерации.

Выбрать отчет в левом окне и нажать кнопку переноса "стрелка вправо":\\

| {{:odg_assist_3.0:lims:pasted:20260202-105720.png}} |

Далее нажать "Сохранить"

В Элементе процесса, где планируется генерировать отчет при включённом чекбоксе "Разрешен выбор шаблона отчета" недолжен быть выбран отчет. \\

| {{:odg_assist_3.0:lims:pasted:20260202-105905.png}} |

Если чекбокс "Разрешен выбор шаблона отчета" выключен, то шаблон отчета должен быть выбран обязательно.\\

 Выбранный отчет в элементе процесса, где генерируется отчет.

Должен совпадать с выбранным шаблоном в шаблоне элемента процесса.

\\

| {{:odg_assist_3.0:lims:pasted:20260202-113610.png}} |

\\

| {{:odg_assist_3.0:lims:pasted:20260202-113520.png}} |

 При такой настройке будут доступны варианты скачивания отчета в pdf, xls, docx.\\

| {{:odg_assist_3.0:lims:pasted:20260202-113716.png}} |


==== Добавление отчета в список отчетов, печать отчета  ====

== Печать отчета ==

Приложение позволяет формировать отчет через панель управления. \\
Вызвать окно "Выбор отчета" со списком отчетов можно через кнопку "Принтер". \\
{{:odg_assist_3.0:lims:pasted:20260312-125035.png?600}}

Далее выбрать отчет и нажать "Скачать"

== Добавление отчета с список ответов ==

  * Нажмите пункт меню "Базовая иерархия". 
  * Найдите группу содержащую процесс. 
  * Выберите шаблон процесса.
  * В области настроек найдите поле "Шаблоны отчетов".
  * Выберите отчет в левом списке и нажмите кнопку ">" для перемещения отчета в правый список
    * {{:odg_assist_3.0:lims:pasted:20260312-125546.png?600}}
  * Нажмите "Сохранить".