git.sur5r.net Git - glabels/blob - help/C/skipfields.page

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