Use redaction policies

If you have a corporate sensitive data removal policy as a list of redaction rules, you don’t need to specify them in your code. You can specify an XML document with a list of pre-configured redactions.

Below is an example of redaction policy XML file (code properties mapping is obvious):


<?xml version="1.0" encoding="utf-8"?>  
<redactionPolicy xmlns="">  
  <regexRedaction regularExpression="(dolor)" actionType="ReplaceString" replacement="foobar" />  
  <exactPhraseRedaction searchPhrase="dolor" caseSensitive="true" actionType="DrawBox" color="Red" />   
  <cellColumnRedaction regularExpression="(foo)bar1" replacement="[red1]" columnIndex="1" worksheetIndex="2" /> 
  <cellColumnRedaction regularExpression="(foo)bar2" replacement="[red2]" wokrsheetName="Sample" /> 
  <eraseMetadataRedaction filter="All" />  
  <metadataSearchRedaction filter="Title, Author" replacement="foobar" valueExpression="(metasearch)" keyExpression="" />  
  <annotationRedaction regularExpression="(anno1)" replacement="foobar" />  
  <deleteAnnotationRedaction regularExpression="(anno2)" />  
  <imageAreaRedaction pointX="15" pointY="17" width="200" height="10" color="#AA50FC"  />  
  <imageAreaRedaction pointX="110" pointY="120" width="60" height="20" color="Magenta"  />  

You can have as much policies, as you need, loading them to redact your documents.

An example below shows how to apply redaction policy to all files within given inbound folder, and save to one of outbound folders - for successfully updated files and for failed ones. Current date and time is used as a part of output file name:

RedactionPolicy policy = RedactionPolicy.load("Policy_file.xml");
for (final File fileEntry : new File("\Inbound\").listFiles())
    final Redactor redactor  = new Redactor(fileEntry.getPath());
        //Apply redaction 
        RedactorChangeLog result = redactor.apply(policy);
        // Set the output directory path, it is supposed that all folders exist
        File resultFolder = new File(result.getStatus() != RedactionStatus.Failed ? "Done" : "Failed");
        // Save the ouput files after applying redactions
        final FileOutputStream fileStream = new FileOutputStream(resultFolder.getPath() + fileEntry.getName());
               RasterizationOptions options = new  RasterizationOptions();
        finally { fileStream.close(); }
     finally { redactor.close(); }