STATEMENT - two page formats

 

Top  Previous  Next

In this sample, a two-page, plain paper statement is printed.  The two pages contain two slightly different formats, with the second page containing detail lines and a customer aging, and the first page containing some more detail lines and the phrase "CONTINUED" at the bottom.  In the same statement print run, some statements may contain a single page, others two or more pages.

 

The trick here is to get UnForm to produce two formats based on the content of each page.  In order to accomplish this, we define the job to produce multiple copies, and assign certain copies to certain formats.  Using a precopy{} code block, we can then control the printing of the different formats.

 

uf100c –i sample2.txt –f advanced.rul –p pdf –o client:statement.pdf

 

 

This statement header identifies this rule set.

 

[Statement]

 

The word STATEMENT appears at column 34, row 2, and a date appears at column 65, row 7.  To further clarify, a date format is matched at position 65, 7.

 

detect 34,2,"STATEMENT"

detect 65,7,"~../../.."                                # statement date

 

 

 

The page dimensions are 66 rows and 75 columns.  The text input to UnForm doesn't contain any form-feeds to indicate the end of a page, so the command "page 66" tells UnForm to consider each 66 lines to be a page.

 

Pcopies 4 is used to tell UnForm to print 4 copies of each page, with copies following each other in sequence for each page (collated).  You will find later that UnForm doesn't actually print all copies of each page, but instead simply prints selected copies, depending on the format required.  As each page is processed, if the page contains aging totals, UnForm prints 2 copies of that format, and if it does not contain aging totals, then UnForm prints 2 copies of the second format.

 

# set up document constants

const MAXCOLS=75                                        # max cols to output

const MAXRCOLS=74                                        # MAXCOLS-1

const LEFTCOL=1                                        # use 1 if empty

const RIGHTCOL=75                                        # MAXCOLS for symmetry

const MAXROWS=66                                        # max rows to output

 

portrait

dpi 300

gs on                                                        # graphical shading

cols MAXCOLS                                                # max output columns

rows MAXROWS                                                # max output rows

page MAXROWS                                                # no form-feeds used

 

# to print more copies, increase value and add copy titles in prejob

# Copy 1,2        Statement with aging totals

# Copy 3,4        Statement w/o  aging totals

pcopies 4                                                        # max # of copies

 

 

If this rule set is used to produce a PDF document, then the title "Statement Sample" will be added to the PDF file.  For laser output, the title command is ignored.

 

title "Statement Sample"                                # view in PDF properties

 

 

The prejob command defines a string variable form_title$, assigning it the value "STATEMENT".  This variable is used later in the rule set for a page heading and also in a watermark.

 

prejob {

 # set up variables needed by merged routines below

 # if form title changes per page,

 # set up in prepage routine below

 form_title$="STATEMENT"

}

 

 

The prepage code block performs 2 functions.  It checks the input data for the word "CONTINUED" at position 66, 64.  If that word is present, then a variable continued$ is assigned to the phrase "Continued"; otherwise it is set to null.  In addition, at three individual lines (16, 62, and 64), there may be single ! characters used as character-mode vertical lines in the input data.  Elsewhere in the rule set is a 'vline "!!", erase' command, which erases instances of 2 or more ! characters vertically on the page.  This code takes care of the single-row instances.

 

prepage {

 # get continued if it exists

 continued$=get(66,64,9)

 if continued$="CONTINUED" then continued$="Continued" \

         else continued$=""

 

# remove single ! from line draw regions

       x=pos("!"=text$[16]); \

       while x>0; text$[16](x,1)="",x=pos("!"=text$[16]);wend

 

       x=pos("!"=text$[62]); \

       while x>0; text$[62](x,1)="",x=pos("!"=text$[62]);wend

 

       x=pos("!"=text$[64]); \

       while x>0; text$[64](x,1)="",x=pos("!"=text$[64]);wend

 

}

 

 

The precopy code block is executed as each of the 4 copies are about to be printed.  The logic here indicates the copies 1 and 2 are for pages that do not contain the word "CONTINUED" (remember the prepage code block?), and copies 3 and 4 do contain that word.  By setting the variable skip to a non-zero value, the copy being processed is skipped.  Only 1 of the 2 formats is printed, depending on the content of the page.

 

precopy {

 if copy=1 or copy=2 then if continued$="Continued" then skip=1

 if copy=3 or copy=4 then if continued$<>"Continued" then skip=1

}

 

 

The following lines remove most of the existing character-mode line drawing elements from the input data.  The hline and vline commands scan for places where at least the indicated number of characters, horizontally or vertically, occur on the page.  The erase option removes them rather than replacing them with graphical lines.

 

#remove existing lines

hline "--",erase

hline "==",erase

vline "!!",erase

cerase 1,1,1,MAXROWS                                        # erase all 1st column

cerase MAXCOLS,1,MAXCOLS,MAXROWS                        # erase all last column

 

 

The following lines draw the page headings.  Some of the commands are stored in another rule set, "Mrg Form Header", which is merged as the rule set is parsed.  The headings already exist, and are moved and fonted with text commands using expressions, such as {cut(66,5,4,"")}.

 

# heading section

const HFONT=univers,12                                        # headings

cerase 1,1,MAXCOLS,10

cbox LEFTCOL,1,RIGHTCOL,MAXROWS,5                        # complete page box

merge "Mrg Form Header"                                        # merge std hdr rules

 

# right top ribbon section

const HFONT=univers,11,italic                                # headings

const DFONT=cgtimes,11,bold                                # data

# draw info box with internal grid and shading

# horizontal line at 6

# vertical line at 68 with shading between 63 and 68

cbox 63,5,MAXCOLS,9,5,crows=7,ccols=68::20

text 64,6,{cut(66,5,4,"")},HFONT                        # page #

text 64,8,{cut(59,7,4,"")},HFONT                        # date

text 69,6,{trim(cut(71,5,3,""))},DFONT                # page #

text 69,8,{trim(cut(65,7,8,""))},DFONT                # date

 

# customer section

# draw info box with internal grid and shading

# vertical line at 10 with shading between 1 and 10

cbox LEFTCOL,10,MAXCOLS,15,5,ccols=10::10

text 2,11,{cut(2,10,2,"")},HFONT                        # to

text 4,13,{trim(cut(15,10,10,""))},DFONT                # cust code

cfont 12,11,MAXCOLS,14,DFONT                                # address

 

 

The detail section contains several columns of information.  There are fewer detail lines on pages with the aging data, so the grid drawing is made specific to particular formats with "if copy 1,2" and "if copy 3,4" sections.  Then two groups of font changes are used, first for the column headings and then for the data columns.

 

# detail section

# detail headings

# draw info box with internal grid and shading

# horizontal line at 6

# vertical line at 68 with shading between 63 and 68

if copy 1,2

 cbox LEFTCOL,15,MAXCOLS,56,5,crows=17::20, \

         ccols=10 18 27 39 48 60 63

end if

if copy 3,4

 cbox LEFTCOL,15,MAXCOLS,61,5,crows=17::20, \

         ccols=10 18 27 39 48 60 63

end if

const ROW=16

cfont 2,ROW,9,ROW,HFONT,center                                # date

cfont 11,ROW,17,ROW,HFONT                                        # inv #

cfont 19,ROW,26,ROW,HFONT,center                                # due date

cfont 28,ROW,38,ROW,HFONT,right                                # due amt

cfont 40,ROW,47,ROW,HFONT,center                                # pmt date

cfont 49,ROW,59,ROW,HFONT,right                                # pmt amt

cfont 61,ROW,62,ROW,HFONT,center                                # type

cfont 64,ROW,MAXRCOLS,ROW,HFONT,right                        # balance

# detail data

const DFONT=cgtimes,11                                                # data

cfont 2,18,9,60,DFONT,center                                        # date

cfont 11,18,17,60,DFONT                                                # inv #

cfont 19,18,26,60,DFONT,center                                # due date

cfont 28,18,38,60,DFONT,right                                        # due amt

cfont 40,18,47,60,DFONT,center                                # pmt date

cfont 49,18,59,60,DFONT,right                                        # pmt amt

cfont 61,18,62,60,DFONT,center                                # type

cfont 64,18,MAXRCOLS,60,DFONT,right,BOLD                # balance

 

 

A watermark prints the form title as large, lightly shaded text.  Its position depends upon the format, hence the use of if copy blocks.

 

# watermark - large font with light shading and rotation

if copy 1,2

 text 39,56,{form_title$},cgtimes,75,shade 20,center, \

         cols=MAXCOLS,rotate 90

end if

if copy 3,4

 text 44,61,{form_title$},cgtimes,85,shade 20,center, \

         cols=MAXCOLS,rotate 90

end if

 

 

The footer section differs considerably between the two formats.  Copies 1 and 2 are associated with pages that have aging data, so you see the fonting of the aging columns defined there.  Copies 3 and 4 are printed when the word "CONTINUED" appears, and that word is printed below, though as the value stored in continued$ ("Continued").

 

# footer section

# remarks

if copy 1,2

 cbox LEFTCOL,56,RIGHTCOL,61,5

 cfont 2,57,MAXRCOLS,60,HFONT

endif

# totals

const DFONT=cgtimes,11,bold                                        # data

if copy 1,2

 cbox LEFTCOL,61,RIGHTCOL,64.5,5,crows=63::20, \

         CCOLS=14 26 38 50 62

 const ROW=62

 cfont 1,ROW,13,ROW,HFONT,right                                # current

 cfont 15,ROW,25,ROW,HFONT,right                                # 1-15

 cfont 27,ROW,37,ROW,HFONT,right                                # 16-30

 cfont 39,ROW,49,ROW,HFONT,right                                # 31-45

 cfont 51,ROW,61,ROW,HFONT,right                                # over 45

 cfont 63,ROW,MAXRCOLS,ROW,HFONT,right,bold,12        # total due

 const ROW=64

 cfont 1,ROW,13,ROW,DFONT,right                                # current

 cfont 15,ROW,25,ROW,DFONT,right                                # 1-15

 cfont 27,ROW,37,ROW,DFONT,right                                # 16-30

 cfont 39,ROW,49,ROW,DFONT,right                                # 31-45

 cfont 51,ROW,61,ROW,DFONT,right                                # over 45

 cfont 63,ROW,MAXRCOLS,ROW,DFONT,right,bold,12        # total due

endif

 

if copy 3,4

 cerase 1,62,MAXCOLS,66

 text 1,65,{Continued$},HFONT,right,cols=MAXRCOLS

endif

 

 

Finally, within the two formats are two physical copies.  Each of these copies is either for the customer to keep or for the customer to return with their payment.  Copy 1, the first page of format 1, and copy 3, the first page of format 2, get the "Customer Copy" footer.  The others get the "Remittance Copy" footer.

 

# copy name section

const ROW=65.5

if copy 1,3

 text 1,ROW,"Customer Copy",HFONT,bold,center,cols=MAXCOLS

end if

if copy 2,4

 text 1,ROW,"Remittance Copy",HFONT,bold,center,cols=MAXCOLS

end if