Troubleshooting

Navigation:  ScriptLine Properties > Generation Options >

Troubleshooting

Previous pageReturn to chapter overviewNext page

The options in the Troubleshooting tab of the Generation Options ScriptLine property dialog are:

 

Filter Holidays

When this option is set to true (the default, which should rarely, if ever, be changed), Q++ will filter the holidays and one-time-dates tables used to generate diaries so that only these necessary are copied from the server to your local disk during diary generation. Most of the time this works fine.

 

In some extremely rare cases you will find that some of the holidays sets you are using specifically in macros are not being used in the output file. In these cases your first reflex should be to add these sets to the Included Holidays property, as its use is much faster (much) than setting the present property to false.

Multi-pass token replacement

When this option is set to true, Q++ will start at the beginning of each textbox for each text replacement of tokens.

 

It is needed for case when complex recursion of tokens involving attributes (bold, italic, symbols, ...) lead to a Cannot Find Text ... run-time message, although the text was indeed present in the textbox. This occurs because Q++ searches through each textbox in a single-pass, assuming that text replacements are generated in the proper order. The single-pass saves time, but if the search/replace commands are in the wrong order (extremely rare) then some text to be replaced is missed.

 

Setting Multi-Pass to true is therefore only truly necessary if you generate a lot of text, with varying attributes, from a single token. However, the speed reduction from setting this option to true is minimal and therefore we recommend to always set this option to true to be safe.

Unlink and relink textboxes

This option is sometimes needed when complex typographical changes in a chain of linked textboxes can confuse QuarkXPress and cause it to crash during diary generation.

 

When this option is set to true, before processing each textbox, Q++ checks if the textbox is linked and then breaks the link with the other textboxes so that all text replacement is done in one box. Then after all the token and text replacements are performed, the textbox chain is relinked.

Remove OPF layers

Setting this option to true means that, after diary generation, Q++ will tell QuarkXPress to move all objects from any non-default layer to the default layer, and will delete all non-default layers, in the output file. Note that this property has no use if you are using the default value of true for the Remove GridTemplate layers option as is recommended.

Verify page objects' sizes

This property is currently not implemented.

Force ANSI generation

This property, which only applies when using version 7 or above of QuarkXPress, forces Q++ to send ANSI text replacement instructions rather than the default Unicode text format used by all versions of QuarkXPress beginning with version 7. There is almost never any reason to set this property to true. Recommended default: false.

Break on NULL char

This option is internally set to always true, for the moment, and is used to warn of spurious NULL characters which can caused unexpected crashes of QuarkXPress.

Temp files deletion

This option (only available for QuarkXPress versions 4 and above) is used to tell QuarkXPress what to do, at the end of diary generation, with the temporary QXD/QXP files it generated in the c:\temp\qpp\tmpqxd\ folder:

 

Do not try to delete

The XNT will not try to delete any of the temporary files it created. This is the value to use in the extremely rare cases when the default, below, is not appropriate.

Use Windows

(default)

The XNT will try to delete the temporary files it created, using the Windows API call used to delete files. This is the default and should rarely need changing.

Use QuarkXPress

The XNT will try to delete the temporary files it created, using the internal QuarkXPress command available through the Quark Xtension API.

 

Note that this property/option specifies what the XNT should do after diary generation, prior to closing down. However, the XNT will always try to empty out the the c:\temp\qpp\tmpqxd\ temporary folder, prior to diary generation.

Seed pages deletion

This option should always be set to After page copying.

Buffer end pages

This property should always be set to None.

Delay - Page Copying

A delay, inserted after the page copying stage, used to give time to QuarkXPress to re-synchronize its internal threads and structures. The default value of 1000 milliseconds is usually sufficient for most cases.

Delay - Seed pages

A delay, inserted after the page copying stage, used to give time to QuarkXPress to re-synchronize its internal threads and structures before deleting the seed pages. The default value of 1000 milliseconds is usually sufficient for most cases.

Delay - OPF transfer

A delay, inserted after diary generation is complete, but before QuarkXPress closes down, used to give time to QuarkXPress to re-synchronize its internal threads and structures. The default value of 1000 milliseconds is usually sufficient for most cases.


Topic 179070 updated on 20-Sep-2011.
Topic URL: http://www.qppstudio.net/webhelp/index.html?troubleshooting.htm