Auto-numbered lists

Auto-numbered lists are supported by ITP, there are however some limitations.

Please note that Microsoft Word implements bulleted and auto-numbered lists in the same way, so there is no technical distinction between both features and both list styles can be configured through the Format | Bullets and Numbering… menu option.

Lists settings

The following settings have been added to ITP's Microsoft Word support to control how ITP handles numbered lists:

• ITPCOMPRESSLISTS
• ITPLISTSUPPORT

Note

Both options are by default disabled.

To switch the auto-numbered lists support on add the following to the Miscellaneous tab of the ITP Configuration Editor:

Setting	Value
ITPCOMPRESSLISTS	Y
ITPLISTSUPPORT	Y

Effects of these settings

• During model creation
  • ITPCOMPRESSLISTS=Y
    This setting will remove the overhead that is left if multiple (include) documents contain the same named bulleted/numbered styles.
  • ITPLISTSUPPORT=Y
    This setting will include the bullet/numbering gallery from the model document into the model for later use in the result document. The bullet/numbering gallery must be included to guarantee that editing a result document does not accidentally change the bullet/numbering style.
• During model execution
  • ITPCOMPRESSLISTS=Y
    This setting will remove the overhead that is left if bulleted/numbered paragraphs from the model document are not produced in the result document.
    Use of this setting during model execution will perform a more aggressive optimization than is possible during model translation, so result documents will be smaller if the model (include) document contained many different bulleted/numbered paragraphs.
    Use of this setting during model execution also has the same effect as the ITPLISTSUPPORT setting.
  • ITPLISTSUPPORT=Y
    This setting will produce the result document in such a way that Microsoft Word will renumber all bullets/numbered lists when the document is opened.
    If the model document has been created with this option enabled, a bullet/numbering gallery will also be included in the result document. The presence of this gallery data is necessary to prevent Microsoft Word from changing the bullet/numbering style in some situations when a user edits the document.

Use

The recommended configuration is to set ITPLISTSUPPORT to Y at all times. This will ensure that new models are created with this setting and that old models can still be run without problems. Note that models created with this setting on cannot be executed with previous ITP releases.

There is no need to recreate models since model documents made before this setting existed are made with the previous limitation of ITP's support for numbered lists in mind.

ITPCOMPRESSLIST could be used when there are numbered lists in include documents that are not used in result documents. These lists are removed by this setting making the result documents smaller.

Known issues with these settings

Each bulleted/numbered paragraph in a Microsoft Word document is uniquely associated with a specific list. Numbering can only be set on the very first paragraph of that list in the result document. Which means:

• Lists produced from within a repeating ITP model will not reset their counting but count sequentially through the complete result document.
• Lists from different include documents cannot be combined into a single counting list unless the bullets/numbering is part of the paragraph style.