1. Home
  2. Documentation
  3. Examples
  4. Handle Validation Failures

Handle Validation Failures

Updated: Aug 6, 2023
View on GitHub
XML Validate Filter

In this example, you will learn how to handle validation failures in data processing. It applies validation rules to the records and adds an additional field to store the reason for the validation failure for any records that do not pass the filtration criteria.

Certain industries, such as finance and healthcare, have strict compliance and regulatory requirements for data handling. DataPipeline can assist in validating data against regulatory rules and identifying non-compliant records. The additional field storing the failure reason helps in auditing and demonstrating compliance.

 

Input XML File

<records>
  <record id="1" first_name="Brian" last_name="Mulliner" hired_on="Thu Jun 18 21:11:17 EDT 2015"></record>
  <record id="2" first_name="Johnny" last_name="Blue" hired_on="Wed Apr 18 21:11:17 EDT 2007"></record>
  <record id="3" first_name="Bula" last_name="Klass" hired_on="Mon Jun 18 21:11:17 EDT 2012"></record>
  <record id="4" first_name="Belinda" last_name="Payor" hired_on="Mon Nov 18 21:11:17 EST 2013"></record>
  <record id="5" first_name="Annmarie" last_name="Remick" hired_on="Tue Sep 18 21:11:17 EDT 2012"></record>
  <record id="6" first_name="Winona" last_name="Arendz" hired_on="Sat Oct 18 21:11:17 EDT 2014"></record>
  <record id="7" first_name="Jeremiah" last_name="Hoelter" hired_on="Mon May 18 21:11:17 EDT 2015"></record>
  <record id="8" first_name="Clayton" last_name="Brucki" hired_on="Tue Feb 18 21:11:17 EST 2014"></record>
  <record id="9" first_name="Lorena" last_name="Decena" hired_on="Tue Nov 18 21:11:17 EST 2014"></record>
  <record id="10" first_name="Cecile" last_name="Fauntleroy" hired_on="Tue Mar 18 21:11:17 EDT 2014"></record>
  <record id="11" first_name="Cherryl" last_name="Creveling" hired_on="Fri Nov 18 21:11:17 EST 2011"></record>
  <record id="12" first_name="Preston" last_name="Penson" hired_on="Sun Jun 18 21:11:17 EDT 2006"></record>
  <record id="13" first_name="Steven" last_name="Pitsenbarger" hired_on="Sun Feb 18 21:11:17 EST 2007"></record>
  <record id="14" first_name="Beaulah" last_name="Graciano" hired_on="Mon Aug 18 21:11:17 EDT 2014"></record>
  <record id="15" first_name="Nadine" last_name="Woollen" hired_on="Mon Nov 18 21:11:17 EST 2013"></record>
  <record id="16" first_name="Jermaine" last_name="Trocchio" hired_on="Sun Apr 18 21:11:17 EDT 2010"></record>
  <record id="17" first_name="Ladawn" last_name="Laroia" hired_on="Fri May 18 21:11:17 EDT 2012"></record>
  <record id="18" first_name="Sharda" last_name="Ackiss" hired_on="Thu Aug 18 21:11:17 EDT 2011"></record>
  <record id="19" first_name="Herlinda" last_name="Moskwa" hired_on="Tue Nov 18 21:11:17 EST 2008"></record>
  <record id="20" first_name="Bob" last_name="Vincik" hired_on="Fri May 18 21:11:17 EDT 2012"></record>
</records>

 

Java Code Listing

package com.northconcepts.datapipeline.examples.cookbook;

import java.io.File;

import com.northconcepts.datapipeline.core.DataReader;
import com.northconcepts.datapipeline.core.DataWriter;
import com.northconcepts.datapipeline.core.StreamWriter;
import com.northconcepts.datapipeline.filter.FieldFilter;
import com.northconcepts.datapipeline.filter.rule.PatternMatch;
import com.northconcepts.datapipeline.job.Job;
import com.northconcepts.datapipeline.memory.MemoryReader;
import com.northconcepts.datapipeline.memory.MemoryWriter;
import com.northconcepts.datapipeline.validate.ValidatingReader;
import com.northconcepts.datapipeline.xml.XmlReader;

public class HandleValidationFailures {

    public static void main(String[] args) {
        // save discarded records in memory, but can be any DataWriter
        MemoryWriter discardWriter = new MemoryWriter();

        // add a "failed_validation_rule" field to each record containing the reason it was discarded 
        String discardReasonFieldName = "failed_validation_rule";
        
        DataReader reader = new XmlReader(new File("example/data/input/call-center-agents-2.xml"))
                .addField("id", "//record/@id")
                .addField("first_name", "//record/@first_name")
                .addField("last_name", "//record/@last_name")
                .addField("hired_on", "//record/@hired_on")
                .addRecordBreak("//record");
        
        reader = new ValidatingReader(reader, discardWriter, discardReasonFieldName)
                .add(new FieldFilter("first_name", new PatternMatch("B.*")));
        
        DataWriter writer = new StreamWriter(System.out);
        
        // write the validated records to STDOUT
        Job.run(reader, writer);
        
        // write the discarded records to STDOUT
        System.out.println("\n---- The discarded records ----");
        Job.run(new MemoryReader(discardWriter.getRecordList()), new StreamWriter(System.out));
    }
}

 

Code Walkthrough

  1. MemoryWriter instance is created to save discarded records in memory.
  2. We may need an additional field in the record to hold the failure message. Therefore, "failed_validation_rule" String field is initialized.
  3. XmlReader is used to read the data from call-center-agents-2.xml file. The arguments for addFields() methods specify the record field name for the output and expression to get the parameter variable from the input file respectively.
  4. ValidatingReader instance is created to validate data from the reader object and store the values that fail the validation to discardWriter with the discardReasonFieldName.
  5. FieldFilter is used to specify the validation expression. In the given example, "first_name" field is checked if its values start with letter "B".
  6. Data is transferred from the reader to the StreamWriter(System.out) via Job.run() method. See how to compile and run data pipeline jobs.
  7. The records of the discarded writer are transferred to StreamWriter(System.out) instance in order to be shown in the console.

 

Console Output

-----------------------------------------------
0 - Record (MODIFIED) {
    0:[id]:STRING=[1]:String
    1:[first_name]:STRING=[Brian]:String
    2:[last_name]:STRING=[Mulliner]:String
    3:[hired_on]:STRING=[Thu Jun 18 21:11:17 EDT 2015]:String
}

-----------------------------------------------
1 - Record (MODIFIED) {
    0:[id]:STRING=[3]:String
    1:[first_name]:STRING=[Bula]:String
    2:[last_name]:STRING=[Klass]:String
    3:[hired_on]:STRING=[Mon Jun 18 21:11:17 EDT 2012]:String
}

-----------------------------------------------
2 - Record (MODIFIED) {
    0:[id]:STRING=[4]:String
    1:[first_name]:STRING=[Belinda]:String
    2:[last_name]:STRING=[Payor]:String
    3:[hired_on]:STRING=[Mon Nov 18 21:11:17 EST 2013]:String
}

-----------------------------------------------
3 - Record (MODIFIED) {
    0:[id]:STRING=[14]:String
    1:[first_name]:STRING=[Beaulah]:String
    2:[last_name]:STRING=[Graciano]:String
    3:[hired_on]:STRING=[Mon Aug 18 21:11:17 EDT 2014]:String
}

-----------------------------------------------
4 - Record (MODIFIED) {
    0:[id]:STRING=[20]:String
    1:[first_name]:STRING=[Bob]:String
    2:[last_name]:STRING=[Vincik]:String
    3:[hired_on]:STRING=[Fri May 18 21:11:17 EDT 2012]:String
}

-----------------------------------------------
5 records

---- The discarded records ----
-----------------------------------------------
0 - Record (MODIFIED) {
    0:[id]:STRING=[2]:String
    1:[first_name]:STRING=[Johnny]:String
    2:[last_name]:STRING=[Blue]:String
    3:[hired_on]:STRING=[Wed Apr 18 21:11:17 EDT 2007]:String
    4:[failed_validation_rule]:STRING=[first_name field: (value's pattern matches B.*)]:String
}

-----------------------------------------------
1 - Record (MODIFIED) {
    0:[id]:STRING=[5]:String
    1:[first_name]:STRING=[Annmarie]:String
    2:[last_name]:STRING=[Remick]:String
    3:[hired_on]:STRING=[Tue Sep 18 21:11:17 EDT 2012]:String
    4:[failed_validation_rule]:STRING=[first_name field: (value's pattern matches B.*)]:String
}

-----------------------------------------------
2 - Record (MODIFIED) {
    0:[id]:STRING=[6]:String
    1:[first_name]:STRING=[Winona]:String
    2:[last_name]:STRING=[Arendz]:String
    3:[hired_on]:STRING=[Sat Oct 18 21:11:17 EDT 2014]:String
    4:[failed_validation_rule]:STRING=[first_name field: (value's pattern matches B.*)]:String
}

-----------------------------------------------
3 - Record (MODIFIED) {
    0:[id]:STRING=[7]:String
    1:[first_name]:STRING=[Jeremiah]:String
    2:[last_name]:STRING=[Hoelter]:String
    3:[hired_on]:STRING=[Mon May 18 21:11:17 EDT 2015]:String
    4:[failed_validation_rule]:STRING=[first_name field: (value's pattern matches B.*)]:String
}

-----------------------------------------------
4 - Record (MODIFIED) {
    0:[id]:STRING=[8]:String
    1:[first_name]:STRING=[Clayton]:String
    2:[last_name]:STRING=[Brucki]:String
    3:[hired_on]:STRING=[Tue Feb 18 21:11:17 EST 2014]:String
    4:[failed_validation_rule]:STRING=[first_name field: (value's pattern matches B.*)]:String
}

-----------------------------------------------
5 - Record (MODIFIED) {
    0:[id]:STRING=[9]:String
    1:[first_name]:STRING=[Lorena]:String
    2:[last_name]:STRING=[Decena]:String
    3:[hired_on]:STRING=[Tue Nov 18 21:11:17 EST 2014]:String
    4:[failed_validation_rule]:STRING=[first_name field: (value's pattern matches B.*)]:String
}

-----------------------------------------------
6 - Record (MODIFIED) {
    0:[id]:STRING=[10]:String
    1:[first_name]:STRING=[Cecile]:String
    2:[last_name]:STRING=[Fauntleroy]:String
    3:[hired_on]:STRING=[Tue Mar 18 21:11:17 EDT 2014]:String
    4:[failed_validation_rule]:STRING=[first_name field: (value's pattern matches B.*)]:String
}

-----------------------------------------------
7 - Record (MODIFIED) {
    0:[id]:STRING=[11]:String
    1:[first_name]:STRING=[Cherryl]:String
    2:[last_name]:STRING=[Creveling]:String
    3:[hired_on]:STRING=[Fri Nov 18 21:11:17 EST 2011]:String
    4:[failed_validation_rule]:STRING=[first_name field: (value's pattern matches B.*)]:String
}

-----------------------------------------------
8 - Record (MODIFIED) {
    0:[id]:STRING=[12]:String
    1:[first_name]:STRING=[Preston]:String
    2:[last_name]:STRING=[Penson]:String
    3:[hired_on]:STRING=[Sun Jun 18 21:11:17 EDT 2006]:String
    4:[failed_validation_rule]:STRING=[first_name field: (value's pattern matches B.*)]:String
}

-----------------------------------------------
9 - Record (MODIFIED) {
    0:[id]:STRING=[13]:String
    1:[first_name]:STRING=[Steven]:String
    2:[last_name]:STRING=[Pitsenbarger]:String
    3:[hired_on]:STRING=[Sun Feb 18 21:11:17 EST 2007]:String
    4:[failed_validation_rule]:STRING=[first_name field: (value's pattern matches B.*)]:String
}

-----------------------------------------------
10 - Record (MODIFIED) {
    0:[id]:STRING=[15]:String
    1:[first_name]:STRING=[Nadine]:String
    2:[last_name]:STRING=[Woollen]:String
    3:[hired_on]:STRING=[Mon Nov 18 21:11:17 EST 2013]:String
    4:[failed_validation_rule]:STRING=[first_name field: (value's pattern matches B.*)]:String
}

-----------------------------------------------
11 - Record (MODIFIED) {
    0:[id]:STRING=[16]:String
    1:[first_name]:STRING=[Jermaine]:String
    2:[last_name]:STRING=[Trocchio]:String
    3:[hired_on]:STRING=[Sun Apr 18 21:11:17 EDT 2010]:String
    4:[failed_validation_rule]:STRING=[first_name field: (value's pattern matches B.*)]:String
}

-----------------------------------------------
12 - Record (MODIFIED) {
    0:[id]:STRING=[17]:String
    1:[first_name]:STRING=[Ladawn]:String
    2:[last_name]:STRING=[Laroia]:String
    3:[hired_on]:STRING=[Fri May 18 21:11:17 EDT 2012]:String
    4:[failed_validation_rule]:STRING=[first_name field: (value's pattern matches B.*)]:String
}

-----------------------------------------------
13 - Record (MODIFIED) {
    0:[id]:STRING=[18]:String
    1:[first_name]:STRING=[Sharda]:String
    2:[last_name]:STRING=[Ackiss]:String
    3:[hired_on]:STRING=[Thu Aug 18 21:11:17 EDT 2011]:String
    4:[failed_validation_rule]:STRING=[first_name field: (value's pattern matches B.*)]:String
}

-----------------------------------------------
14 - Record (MODIFIED) {
    0:[id]:STRING=[19]:String
    1:[first_name]:STRING=[Herlinda]:String
    2:[last_name]:STRING=[Moskwa]:String
    3:[hired_on]:STRING=[Tue Nov 18 21:11:17 EST 2008]:String
    4:[failed_validation_rule]:STRING=[first_name field: (value's pattern matches B.*)]:String
}

-----------------------------------------------
15 records
Get DataPipeline 9.0.0
All Tags | All Examples
Mobile Analytics