Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

View file
name3_1.tif
height250

Image Added

Figure 3.1. Writer login window

...

After login, you are presented with a list of all existing report version that have a report status of open (O) or locked (L) and a version status of active (A) or released (R) (see Fig. l.3.2; more on report and version status later).

Image Added

Figure 3.2. Writer window after login. View filename3_2.tifheight250

To print a batch:

  • Select the appropriate report definition.
  • Here, select TRAINING_REPORT with the latest version number.
  • Browse to the appropriate data source Excel workbook using the Find SpreadSheet button. This should be the workbook that was used for the report definition as far as worksheet names and column names are concerned. Data may have changed.
  • Here, select the ts_report_training workbook from wherever you placed it.
  • Using the Report Destination button, select a folder where the report files will be written to
  • Click the Validate button and the program will check if all names used in the report definition also exist in the data source workbook (and a few other things). You will get an error messages if the validation fails and have to resolve the issue.
  • If the validation succeeds, the Create Reports button becomes active – click it to print the reports.
  • A progress bar and counter will inform you of the progress.

...

Figure 4.4.4. Report definitions are structured hierarchical.

Block element

Blocks are containers for the other layout elements (field, text, grid and table). A new block can be placed below, or nested within an existing block, but you cannot place two blocks next to each other on a report page. A block is always placed below the top of an enclosing block, or below the last written item on the page (any layout element), by a top offset (points). Nested blocks can also be positioned by a left offset (points) from their enclosing blocks.
Blocks can have a border box drawn or not. If a border box is specified, the top border is drawn where the top offset was defined, and the first item within the block is written by a fixed amount below the top border (3 points). The bottom border is drawn by a fixed amount (3 points) from the last written item. Left and right borders are drawn with left and right offsets from the enclosing block, by the amount that is set for the left offset.
Drawing borders helps the reader understand the layout and data organization in a larger report. However, printing all borders in the case of nested blocks may result in too many lines. Find the right balance.
Known issue: if you DON'T draw all the borders (boxes) around all blocks, the PDF printing routine currently gets confused and draws borders incorrectly (doesn't know where to start/stop). The program needs to be amended to cover such cases.
At the start of creating a report you must create the first top-level block, all other layout elements must be within a block. Once you have your first block defined, you can add within the block nested blocks, fields, text, grids and tables, which will all be described below. You can also add more top-level blocks below the first block.
A block can display information from one source worksheet only. However, an enclosing block can display information from multiple worksheets if that information is placed within nested blocks. This is very important to understand and will be elaborated later. In this section we only need one block element.

...

To ensure that one could reprint the reports in the future if so desired, the current proposal is that once the data source workbook and the report definition are complete (no later than 1 year postcruise), both are zipped up and loaded as DESC assets. This in addition to the regular DESC workbook uploads and the attempt to preserve the final report definitions in the Builder.

Appendix 1: Loading and referencing images

...