1 <?xml version="1.0" encoding="utf-8"?>
2 <page xmlns="http://projectmallard.org/1.0/" xmlns:e="http://projectmallard.org/experimental/" type="guide" id="mergeskipfields" xml:lang="nl">
5 <link type="guide" xref="index#merging"/>
6 <revision pkgversion="3.0" version="0.1" date="2010-05-04" status="incomplete"/>
8 How to skip blank address lines when doing a document merge.
10 <credit type="author">
11 <name>Jim Evins</name>
12 <email>evins@snaught.com</email>
14 <credit type="author">
15 <name>Mario Blättermann</name>
16 <email>mario.blaettermann@gmail.com</email>
19 <p>Creative Commons Share Alike 3.0</p>
23 <title>Skipping blank address lines</title>
25 <p>This feature can be best described by a simple example. In the
26 following CSV file, column 5 (ADDR2) contains the second address line
27 for each record. This field is empty in records 1 and 2, but not in
28 record 3. (For this feature to work, the field must be completely
29 empty -- any text, including spaces will defeat this feature.)</p>
32 LAST,FIRST,MI,ADDR1,ADDR2,CITY,STATE,ZIP
33 Summers,Joyce,,"1630 Revello Dr",,Sunnydale,CA,95037
34 McGarret,Steve,O,"404 Piikoi Street",,Honolulu,HI,96813
35 Kramer,Cosmo,,"Apt 5B","129 W. 81 St.","New York",NY,10024-7207
38 <p>In the following screenshot, a single multiline text object has been
39 created to format these addresses. Notice that ${ADDR2} representing
40 the second address line is on a line by itself. (Any additional text
41 on this line, including spaces would defeat this feature.)</p>
43 <media type="image" src="figures/skip-fields-screenshot.png" mime="image/png" style="right">
44 <p>Multi-line address</p>
47 <p>Printing this label results in the following output. Notice that the
48 line containing the ${ADDR2} field is completely skipped for the first
49 two records, without printing a blank line.</p>
51 <media type="image" src="figures/skip-fields-output.png" mime="image/png" style="right">