View source for Flat File Parser Configuration Example

== Purpose ==

This example shows how to move the parser configuration out of the program into a xml file for easier configuration. It is the same scenario as the validation example.

== Data Format ==
The data format is exactly the same as in the validation example.


== Line Formats ==
{| border="1"
! 
! Identifier
! Data
|-
| Store ID 
| 100
| 4 digits numeric
|-
| Date
| 110
| date ISO format yyyy-MM-dd
|-
| Item
| 210
| 13 alphanumeric (EAN)
|-
| Quantity 
| 220
| 4 digits numeric
|-
| End
| 999 
| no extra data
|}

== Code ==
Only the parser and a configuration provider need to be created. Everything else is done by the configuration provider.

The '''whole''' program:
<code>
      /include 'ffp/parser_h.rpgle'
      /include 'ffp/xml_config_provider_h.rpgle'
      
     D parser          S               *
     D configProvider  S               *
     D configPath      S           1000A
   
      /free
       configPath = '/home/iusr0001/src/ffp/example/xmlconfig.xml' + x'00';
       
       parser = ffp_create();
       configProvider = ffp_config_xml_create(%addr(configPath));
       ffp_setConfigurationProvider(parser : configProvider);
       ffp_loadConfiguration(parser);
       
       ffp_parse(parser);
       
       ffp_finalize(parser);
       
       *inlr = *on;
      /end-free
</code>

== XML Configuration file ==
<code>
  <?xml version="1.0" ?>
  <!DOCTYPE config SYSTEM "ffp.dtd" >
  <config
    ignoreBlankLines="yes"
    processInvalidLines="yes">
    
    <lineFormat name="id" type="var" imageString="100####" />
    
    <lineFormat name="date" type="var" imageString="110@@@@@@@@@@">
    	<field length="3" />
    	<field length="10">
    		<validator serviceprogram="FFPVALDAT" 
    			procedure="ffp_validator_date_create" parameter="*ISO" />
    	</field>
    </lineFormat>
    
    <lineFormat name="store" type="var" imageString="120######" />
    
    <lineFormat name="item" type="var" imageString="210#############" />
    
    <lineFormat name="quantity" type="var" imageString="220#######" >
    	<field length="3" />
    	<field length="6">
    		<validator serviceprogram="FFPVALRNG" 
    			procedure="ffp_validator_range_create" parameter="1 99999" />
    	</field>
    </lineFormat>
    
    <lineFormat name="end" type="const" imageString="999" />
    
    <inputProvider serviceprogram="FFPINSF" procedure="ffp_input_stmf_create" 
        parameter="/home/iusr0001/src/ffp/example/xmlconfig-input.txt" />
    
    <lineProcessor serviceprogram="FFPPRCG" procedure="ffp_processor_grouping_create"
    	parameter="id end FFPEX02EX" />
    
    <logger serviceprogram="FFPLOGJOBL" procedure="ffp_logger_joblog_create" />
    
  </config>
</code>