Please enable JavaScript to view this site.

 

Navigation: Tokens

Zap Tokens

Scroll Prev Up Next More

Zap tokens are a special case of conditional tokens, and delete the textbox containing the zap token, if a certain condition is true, or a series of conditions are all true.

 

The structure of a zap token is:

 

[ZapPrefix Condition1|Condition2|...]

 

The details of the above are:

 

ZapPrefix

This is always the letter 'z', sometimes followed by the letter 'L' or 'P'.

 

Delete Box: If the ZapPrefix is 'z' then only the current textbox will be deleted if the Condition is true.

Delete Group: If the ZapPrefix is 'Z' then any object grouped to the current textbox will also be deleted if the Condition is true.

Delete Layer: If the ZapPrefix is 'Z' followed by 'L' (that is to say 'ZL'), then all the objects that are located in the same layer and the same page as the textbox containing the Zap Token are deleted (whether or not they are grouped), if the Condition is true.

Delete Page: If the ZapPrefix is 'Z' followed by 'P' (that is to say 'ZP'), then the page (the entire page, not just the objects on it) containing the textbox containing the Zap Token is deleted, if the Condition is true.

For testing testing/debugging purposes, you can use the keep pages diary generation option to delete all objects on the page, and leave a marker that the page is to be deleted, instead of deleting the actual page..

Condition(s)

This is any valid condition, as defined in conditional tokens (remember that conditions can include tokens).

 

Multiple conditions

 

Multiple conditions, separated by a pipe sign, may be used to zap if all the conditions are true.

 

[ ZapPrefix | Condition1 | Condition2 | ... ]

 

In multiple condition zap tokens, the first pipe sign "|" must occur immediately after the z, Z, ZL or ZP prefix, and there should be no pipe sign at the end.

 

Examples

 

[a1zd=22] means delete the current textbox if the value of the token [a1d] is equal to 22. In that example, the ZapPrefix is 'z' and the Condition is 'd=22'.

 

[a1z|d=22|d#=3] means zap the current textbox if the value of the token [a1d] is equal to 22 and the value of [a1d#=3] (ie. when the date is Wednesday the 22nd).