40
7-24
Dynamic Converter Administration Guide
Script Templates
TRUNCATE
When set, this attribute forces a maximum length in characters for the
inserted element. This allows elements to be truncated rather than
broken across pages when the page size option is in use. Truncated
elements will end with the truncation identifier which is “…” (three
periods). All elements that have a truncate value will be no more than
the specified number of characters in length including the length of the
truncation identifier. In Dynamic Converter, elements are inserted in
their entirety if no truncation size is specified. The value of this
attribute must be greater than or equal to 5 characters.
An example of a situation where element truncation is useful is to
limit the size of entries when building a table of contents.
The TRUNCATE attribute implies suppression of tags for the insert. It
also auto applies the no source formatting option for the insert.
Note that the TRUNCATE attribute cannot be used with custom
elements, because the custom element definition precludes the
existence of any other attributes to {## INSERT}.
The TRUNCATE attribute has three special aspects to its behavior
when grids are being inserted:
1. When truncation is in effect, the truncation size refers to the
number of characters of content in each cell—not the number of
characters in the grid as a whole.
2. While truncation normally causes all markup tags to be
suppressed, when grids are in use, the table tags are retained
(assuming that the output flavor supports tables).
3. Users are reminded that only one grid size may be selected for
each spreadsheet sheet or database inserted. The size of the grid
will be based in part on the
TRUNCATE
value if one or both the grid
dimensions are not specified and the SCCOPT_EX_PAGESIZE
option is in use. In this situation, if a grid from a single sheet is
inserted in more than one place in the template, and there are
differing TRUNCATE values, then the grid dimensions will be
based on the largest TRUNCATE value specified.
Attribute
Description