Створення звітів

A database without exporting facilities is of little use. Ghini lets you export your data in table format (open them in your spreadsheet editor of choice), as labels (to be printed or engraved), as html pages or pdf or postscript documents.

The Report Tool

You activate the Report Tool from the main menu: Tools‣Report. The Report Tools acts on a selection, so first select something, then start the Report Tool.

Report on the whole collection.

To produce a report on your whole plant collection, a shortcut would be from the home screen, to click on the Families: in use cell.

If your focus is more on the garden location than on taxonomy and accessions, you would click on the Locations: total cell.

Reports are produced by a report engine, making use of a report template. Ghini relies upon two different report engines (Mako & XSL), and offers several report templates, meant as usable examples.

Choose the report you need, specify parameters if required, and produce the report. Ghini will open the report in the associated application.

Configuring report templates, that’s a task for who installs and configures ghini at your institution. Basically, you create a template name, indicating the report engine and specifying the template. Configured templates are static, once configured you are not expected to alter them. Only the special **scratch** template can be modified on the fly.

The remainder of this page provides technical information and links regarding the formatter engines, and gives hints on writing report templates. Writing templates comes very close to writing a computer program, and that’s beyond the scope of this manual, but we have hints that will definitely be useful to the interested reader.

Використання форматера звіту Mako

Форматер звіту Mako використовує мову шаблонів Mako для генерації звітів. Детальнішу інформацію про Мако і його мову можна знайти на сайті makotemplates.org.

Система шаблонів Mako вже повинна бути встановлена на вашому комп’ютері, якщо встановлено Ghini.

Створення звітів за допомогою Мако аналогічна тому, як ви можете створити веб-сторінку за допомогою шаблону. Це набагато простіше, ніж XSL Formatter (див нижче) і відносно легко буде створити шаблон для тих, хто хоча б з невеликим досвідом програмування.

Генератор шаблону буде використовувати те саме розширення файлу, як шаблон, який повинен вказати тип виводу шаблону при створенні. Наприклад, щоб створити HTML-сторінку з вашого шаблону, ви маєте називати шаблон так: report.html. Якщо шаблон буде генерувати файл зі значеннями, розділеними комами, слід назвати шаблон report.csv.

Шаблон буде отримувати змінну values, яка буде містити список значень в поточному пошуку.

Тип кожного значення в values буде таким же, як область пошуку, що використовується в пошуковому запиті. Для отримання додаткової інформації про пошукові домени дивитися: search-domains.

Якщо запит не має пошукового домену, то всі значення можуть бути різного типу і шаблон Мако повинен бути готовий впоратися з ними.

Використання XSL Report Formatter

XSL форматер звітів вимагає представляти XSL в PDF для перетворення даних в PDF файл. Apache FOP є безкоштовним і з відкритим вихідним кодом XSL->PDF визуализатор що рекомендується.

При використанні Linux, Apache FOP повинен бути встановлений за допомогою менеджера пакетів. В Debian/Ubuntu це встановлювана як fop в Synaptic або за допомогою наступної команди

apt-get install fop

Установка Apache FOP на Windows

У вас є два варіанти установки FOP на Windows. Найпростіший спосіб це завантажити скомпільований ApacheFOP-0.95-1-setup.exe installer.

В якості альтернативи ви можете скачати archive. Після вилучення архіву ви повинні додати каталог, розпакував архів в змінну PATH середовища.