Engine

From QSOS wiki

Jump to: navigation, search

In the tools directory, you will find perl scripts, these constitute the "QSOS Engine".

Contents

Prerequesite

This QSOS::Document library is needed by the "engine" to parse XML files.

The XML::Twig and Tie::Ixhash libraries must be installed first:

On Debian:

aptitude install libxml-twig-perl libtie-ixhash-perl

On RedHat:

yum install perl-XML-Twig perl-Tie-IxHash

Others: have a look on the CPAN.

Installation:

cd qsos/libs/perl/QSOS-Document
perl Makefile.PL
make
make install

checktree and checksheet scripts

In qsos/tools/checktree/, to verify one or all evaluation sheets:

./checktree
./checksheet foobar.qsos

createemptysheet script

In qsos/tools/createemptysheet/, to create an empty evaluation sheet based on an existing template:

./createemptysheet.pl --include=/includepath --qtpl qsos-template.qtpl

--include is optional if you launch the script from its CVS directory.

Note

The QSOS Template editor has a bug: it generates templates files without the <qsosappname/> so for the time being you have to manually add an empty <qsosappname/> tag in the header part of the template.

syncglobaldesc script

In qsos/tools/syncglobaldesc/, to update an existing evaluation sheet (.qsos file) after having modified its template and generated a blank sheet from it (with the createemptysheet script discussed above).

./syncglobaldesc -l -m -r -s -t blank_sheet.qsos -f evaluated_sheet.qsos

The -s parameter indicates to actually update the evaluated sheet. You can test synchronization by removing this parameter first so detected updates would be displayed but not saved.

Note

The QSOS Template editor has a bug: it generates templates files (.qtpl) without the <qsosappname/> tag and this can make syncglobaldesc fail. In that case, just manually add an empty <qsosappname/> tag in the header part of the template and/or evaluations.

Personal tools