Download The SRS Pagination Suite User Guide - Insight Statistical Consulting

The SRS Pagination Suite
User Guide
_____________________________________________________________________
</text>.
When the PaginatorCLI class encounters an element that does not
conform to the definition provided by the DTD, it reports the error and stops
executing.
This level of rigour may at first sight appear onerous, but it is required to ensure that
the results returned by the SRSPaginator class are accurate and have not been
corrupted by the inadvertently invalid user input. Moreover, using the utility macros
provided as part of the SRS Pagination Suite will maximise the chance that the row
file conforms to the required format definition.
3.5 The row file
3.5.1 The purpose of the row file
The row file provides the SAS system with the results of the calculations returned by
the Paginator Java class. The definition of its contents is given by the rowfile.map
file in the SRS Pagination Suite install folder. This file can be used by the SAS 9
XML engine to read the file directly into a dataset. The code to do this is extremely
simple:
LIBNAME BaseXML XML "<rowfile>" XMLMAP="&srs_installdir.RowFile.map";
Where <rowfile> is the name of the row file to be imported. This statement creates a
dataset named BaseXML._PageData, which can be used in exactly the same way as
any other SAS dataset.
Note: There is a bug in SAS 9.1 (**** and other versions? ****) that causes
problems when a dataset accessed by the XML engine is used as the input to a
procedure. The work around is simple: just SET the XML dataset into a
conventional SAS dataset in a data step.
The variables in the BaseXML._PageData dataset are:
Variable
_Row
Type
NUM
_Cell
NUM
_RowHeight
NUM
_RowLines
NUM
_RowHeightUnits
CHAR
_CellLines
NUM
_CellHeight
_CellHeightUnits
NUM
NUM
_Page
NUM
Description
The row of the table to which this observation relates.
This should equate to _N_ in the input dataset if the
PaginatorCLI class has performed correctly. Takes
integer values from 1 to n where n is the number of
observations in the dataset.
The cell (variable) within the row to which this
observation relates.
The height of this row. Equal to max(_CellHeight)
over all observations with this value of _Row.
The height of the row in lines. Equal to
max(_CellLines) for all observations with this value of
_Row.
The units in which _RowHeight is measured. One of
pt, in, cm, twips.
The number of lines required to render the contents of
this cell
The height of this cell
The units in which _CellHeight is measured. One of
pt, in, cm, twips.
The physical page on which this observation will appear
_____________________________________________________________________
Saved: 12 May 2006 01:38:00
All material copyright © 2006 Insight Statistical Consulting Ltd
Page 2-14