Xerox Paris, a document system Support & Software User Guide

Page of 548
The PARIS Designer32 Reference Manual
227
P
A G E
/ P
A R A  
U
P D A T E  
F
I E L D  
E
V E N T
A Page/Para Update Field event works in the same way as a local text block Update
Field event, except that it is conducted on every text block on a page, whereas a
local text block Update Field event is conducted on its associated text block only.
Update Field events can be of two types, Fill or Increment, and are used to fill or
increment the Current Value of a field by loading data from the printstream into the
specified field.
• 
A 'Fill Field' event will replace the current contents of the field with the
extracted data. This becomes the Current Value of the field and replaces any
previous value.
• 
An 'Increment Field' event will add the extracted data to the Current Value of the
field. By specifying a line and position range it is possible to total a column. An
Increment Field event is normally only possible on Numeric fields.
If the field type is Numeric, the extracted data is converted to a number and added to
the Current Value. If the field type is Alphanumeric, the extracted data is appended
to the end of the Current Value.
For example:
On your page you have a number of  text blocks, each containing details of funds
transactions. In the same line and position in each text block there is a field
‘Amount’ which contains the amount of the funds.
A Page/Para Increment Field event is used to fill the Current Value of the ‘Amount’
field.
Each time the ‘Amount’ field occurs (in the same line and position in each text
block), the Current Value of the field will be incremented  with the contents of  the
previous ‘Amount’ field, with the last ‘Amount’ field on the page containing the
total amount.
 NOTE:
Page/Para Update Field Events can be added to an environment once the necessary
fields have been added to the Field List and the position in the text block of the data
to be used to fill the field is determined.
Refer to: ‘Creating and Filling a field’ in the Paris Designer User’s Manual
.