Модификация распечатки

Материал из Rujel
Версия от 09:49, 1 декабря 2011; Gena (обсуждение | вклад) (Структура plist-описания отчета)

Перейти к: навигация, поиск

Начиная с версии 0.9.2 в РУЖЭЛЬ появилась возможность подготовки информации для распечатки посредством XSLT- преобразования из XML. Примером такого подхода является идущая в составе дистрибутива распечатка "Кратко". На основании этого отчета можно формировать свои.

Принцип формирования отчета

Список отчетов, доступных в режиме "Контроль успеваемости" (при просмотре по ученикам), формируется частично программно модулями РУЖЭЛЬ, а частично — на основании содержимого директории

CONFIGDIR/RujelReports/StudentReport/

где CONFIGDIR означает: на AltLinux: /etc/webobjects/rujel/ , в общем случае: $NEXT_ROOT/Local/Library/WebObjects/Configuration/rujel/

Описания отчетов хранятся в файлах .plist . Часть этих файлов являются описаниями отчетов, а часть — сохраненными настройками. Отличить их можно по структуре содержимого (см. ниже).

При изначальной установке описания отчетов доступно два: DefaultReporter.plist и shortXSLT.plist . Примером сохраненных настроек является файл defaultSettings.plist — в нем сохраняются настройки по умолчанию. Другие файлы настроек обычно имеют названия вида 20110914.plist , отображая дату создания этой настройки, но для них названия не принципиальны.

Кроме файлов .plist в этой директории можно увидеть и файлы .xsl — это как раз и есть XSLT-преобразование, применяемое для формирования отчета.

Отсылка к файлу преобразования находится внутри plist-файла описания отчета. Так отчет "Кратко" — файл shortXSLT.plist формируется при помощи преобразования short.xsl

Для создания своего отчета, надо подготовить свой файл plist с описанием отчета и файл xsl с преобразованием. Для упрощения этой задачи, можно воспользоваться файлами shortXSLT.plist и short.xsl в качестве шаблонов. Вносить свои изменения непосредственно в эти файлы не рекомендуется, так как они будут заменены на оригинальные при обновлении.

Структура plist-описания отчета

Редактировать описание отчета можно также, как и любые другие файлы plist. Здесь приводится структура описания отчета, которую считывает РУЖЭЛЬ.


Ключ Значение Комментарий
id Идентификатор отчета Это обязательный параметр. По его наличию система определяет файл, как описание отчета. Значение id должно быть уникальным для каждого отчета.
title Название Будет отображаться в списке доступных отчетов
hover Подсказка Будет отображаться при наведении курсора на название отчета.
sort Ключ сортировки Определяет положение отчета в списке. Должен быть типа string
transform Преобразование Имя файла XSLT-преобразования
sources Источники данных Список <array> дополнительных данных, которые потребуются для преобразования. Известные значения: Persdata — полная информация о именах учащихся и учителей и Options — данные о настройках отчета.
studentInOptions Этот флаг показывает, что преобразование позволяет заготовить XML на весь класс, а для каждого учащегося потом формировать отдельные отчеты, изменяя только указание учащегося в настройках отчета.
settings Настройки отчета В этом разделе указывается, какую информацию нужно включать в отчет. Нужно указывать для уменьшения нагрузки на БД
options Изменяемые параметры Этот раздел описывает параметры, которые пользователь сможет самостоятельно настроить перед формированием отчета.

Как писать XSLT-преобразование

[[1]] [[2]] [[3]]