extrapages(
extrapages(
PAGELIST
)

The extrapages( function controls the printing of extra data tile pages.

Parameters

This function has one parameter:

pagelist – is a text array listing the extra pages that should be printed. For example, if you want to print data tiles 3 and 5 the page list should be `"35,"`. The array may be delimited by commas, spaces, tabs, carriage returns or line feeds.

Description

This function must be used in a Text Display object on a form to be printed. The form must have extra data tiles (Data Tile 2, Data Tile 3, etc.) Panorama will always print the main data tile, but the extrapages( function can control what other data tiles are printed on a record by record basis.

For example, suppose that your form contains a statement (main data tile) and a reminder letter (data tile 2). The reminder letter should only be printed if the account is more than 45 days overdue. To do this put the formula below in a Text Display object somewhere on the main data tile.

    extrapages(?(today()-45>ShipDate,"2",""))

Panorama allows up to 25 pages to be printed per record using data tiles 1 through 25. However, you do not have to print all tiles for each record, you can print them selectively using a formula on the form. For example, you can easily ask Panorama to print pages 1, 2, and 5 for one record and 1 and 4 for another record (page one, the primary data tile, always prints). You could use this feature to selectively print an envelope, to print only selected portions of a tax return, to print one or two page invoices, etc.

To control which extra data tiles get printed, use the extrapages( function in a formula in a Text Display Object somewhere on the main data tile. This function has one parameter, a Text Array with a list of the extra pages to be printed. This list may be delimited by commas, spaces, tabs, carriage returns or line feeds. For example if you want to print pages 1, 2, and 5 you would need to use a formula like this:

    extrapages("2,5")

Usually you would use a field or variable to selectively control which pages print instead of a fixed string. See Printing Multiple Page Records for more details about this process.

#### Using an Extra Page List without Delimiters (Legacy Compatibility)

Before Panorama X 10.2, only 9 pages could be printed per record. In those earlier versions, the list of page numbers could be specified without a delimiter. For example, instead of:

    extrapages("2,5")

You could use the formula:

    extrapages("25")

Both of these formulas specify that pages 1, 2, and 5 should be printed.

For compatibility, this “no delimiters” format still works, but if delimiters are not used then only single digit page numbers can be specified (2 thru 9). If you want to use page 10 or higher you must include delimiters in the text array.

See Also

- Automatic Report Construction -- creates a tabular report with columns of data.

History

Version | Status | Notes
10.2 | Updated | Now allows separator characters delimiting the page numbers in the list, allowing the use of double digit page numbers.
10.1 | No Change | Carried over from Panorama 6.0