Skip to main content

Customizing Paper Options

The Page Set-up Dialog of the Line Item Report Builder enables users to select the paper size for a printed report. Site administrators can customize the list of paper sizes that appears in this dialog in the same manner that they can set up a custom font list.

To add a custom page description, use Studio or another appropriate editor to edit the class %DeepSee.Report.Config.configDataOpens in a new tab. In this class, is an XData section named CustomPageSizes whose contents looks like this:

<pageSizes>
 <![CDATA[
  [
   {displayName:"Sticker",units:"mm",width:60.9,height:101}
  ]
 ]] >
</pageSizes>

This is a JSON encoded array. If the array contains more than one item, the items are separated by commas. Each element of the array is a JSON object with 4 attributes.

  • displayName is the human readable tag to be associated with this entry

  • units is the base measure used to specify the width and height scalars and should be either "in" or "mm"

  • width is the minor dimension of the page in the specified units

  • height is the major dimension of the page in the specified units

For example, to add a business card blank to the list, edit the file to look like this:

<pageSizes>
 <![CDATA[
  [
   {displayName:"Sticker",units:"mm",width:60.9,height:101},
   {displayName:"Card",units:"in",width:2,height:3.5}
  ]
 ]]>
</pageSizes> 

Note both the comma added as a separator at the end of the first line and that, although most business cards are printed in landscape orientation, the stock itself is defined with the height as the longer dimension.

Once this class is saved and compiled, the Page Set-up Dialog of the Line Item Report Builder finds it and adds whatever definitions it holds to the drop down of page size options. New options are appended after the "standard" options in the order they appear in the file.

You can export this class to XML to make it portable to other systems. Simply import and compile the file into the SYS namespace.

FeedbackOpens in a new tab