SAP Data Quality Management SDK Document Version: 4.2 Support Package 3 (14.2.3.0) - 2014-09-05 Developer Guide Table of Contents 1 Data Quality Management SDK overview............................................10 1.1 Installing Data Quality Management SDK..............................................10 1.1.1 Upgrading.............................................................11 1.1.2 Installing the SDK on Windows...............................................11 1.1.3 Installing the SDK on Unix..................................................11 2 Directory data................................................................13 2.1 Directory listing and update schedule................................................ 13 2.2 U.S. directory expiration..........................................................14 2.2.1 U.S. National and Auxiliary files..............................................15 2.3 Where to copy directories.........................................................15 2.4 To install and set up SAP Download Manager...........................................16 2.5 To download directory files........................................................16 2.6 Extracting directory files..........................................................16 3 Samples.....................................................................18 3.1 Sample program files............................................................18 3.2 Building samples...............................................................18 3.3 Running samples...............................................................19 4 API reference for C++..........................................................20 4.1 Message types................................................................20 4.2 ToLatin1.....................................................................20 4.3 CertifiedReportGenerator.....................................................21 4.4 DataRecordSchema............................................................22 4.5 Date....................................................................... 23 4.6 DateTime....................................................................25 4.7 EmdqException...............................................................25 4.8 InputDataRecord.............................................................26 4.9 MessageHandler..............................................................28 4.10 MultiRecordTransform........................................................28 4.11 MultiRecordTransformHelper...................................................31 4.12 OutputDataRecord............................................................32 4.13 ProgressHandler.............................................................36 4.14 RecordTransform.............................................................36 4.15 RecordTransformHelper.......................................................39 4.16 StatisticsHandler...........................................................39 4.17 StatisticsSchema............................................................40 4.18 Time........................................................................41 Developer Guide 2 © 2014 SAP SE or an SAP affiliate company. All rights reserved. Table of Contents 4.19 TransformFactory............................................................43 5 API reference for Java..........................................................46 5.1 Message types................................................................46 5.2 CertifiedReportGenerator.................................................... 46 5.3 DataRecordSchema ............................................................47 5.4 EmdqException .............................................................. 48 5.5 InputDataRecord ............................................................ 49 5.6 MessageHandler ..............................................................51 5.7 MultiRecordTransform ........................................................51 5.8 MultiRecordTransformHelper ..................................................54 5.9 OutputDataRecord ............................................................56 5.10 ProgressHandler .............................................................58 5.11 RecordTransform .............................................................59 5.12 RecordTransformHelper .......................................................61 5.13 StatisticsHandler ...........................................................62 5.14 StatisticsSchema ............................................................62 5.15 TransformFactory ............................................................63 6 API reference for .Net..........................................................66 6.1 Message types................................................................66 6.2 EmDQException...............................................................66 6.3 LogHandler..................................................................67 6.4 MultiRecordProgressHandler.................................................. 67 6.5 MultiRecordTransform........................................................67 6.6 MultiRecordTransformHelper.................................................. 69 6.7 RecordTransform ............................................................ 69 6.8 RecordTransformHelper .......................................................71 6.9 TransformFactory............................................................ 71 7 Address cleanse concepts.......................................................74 7.1 Setting up the reference files...................................................... 74 8 USA Regulatory Address Cleanse................................................. 76 8.1 USPS DPV®...................................................................76 8.1.1 Benefits of DPV.........................................................77 8.1.2 DPV security...........................................................77 8.1.3 DPV monthly directories.................................................. 80 8.1.4 Required information in the job setup..........................................81 8.1.5 DPV output fields........................................................81 8.1.6 Non certified mode......................................................83 8.1.7 DPV performance.......................................................84 Developer Guide Table of Contents © 2014 SAP SE or an SAP affiliate company. All rights reserved. 3 8.1.8 DPV No Stats indicators...................................................85 8.1.9 DPV Vacant indicators....................................................85 8.2 USPS eLOT® ..................................................................86 8.3 Early Warning System (EWS)......................................................87 8.3.1 Overview of EWS........................................................87 8.3.2 EWS directory..........................................................87 8.4 SuiteLink™ ................................................................... 87 8.4.1 Benefits of SuiteLink .....................................................88 8.4.2 How SuiteLink works .....................................................88 8.4.3 SuiteLink directory ......................................................89 8.4.4 Improve processing speed .................................................89 8.5 LACSLink® ...................................................................89 8.5.1 Benefits of LACSLink .................................................... 90 8.5.2 LACSLink® security......................................................90 8.5.3 How LACSLink works .................................................... 94 8.5.4 Conditions for address processing........................................... 94 8.5.5 LACSLink directory files...................................................94 8.5.6 Required information in the job setup .........................................95 8.5.7 Reasons for errors.......................................................95 8.5.8 LACSLink output fields ...................................................96 8.5.9 Memory usage and caching for LACSLink processing..............................97 8.5.10 USPS Form 3553 ....................................................... 97 8.6 USPS RDI® ...................................................................97 8.6.1 How RDI works .........................................................98 8.6.2 RDI directory files.......................................................98 8.6.3 RDI output field.........................................................99 8.6.4 CASS Statement, USPS Form 3553 ..........................................99 8.7 Z4Change (USA Regulatory Address Cleanse)..........................................99 8.7.1 Enable Z4Change for faster processing .......................................100 8.7.2 Z4Change and USPS rules ................................................100 8.7.3 Z4Change directory.....................................................100 8.8 Suggestion lists...............................................................101 8.8.1 Breaking ties..........................................................102 8.8.2 More information is needed............................................... 103 8.8.3 CASS rule ............................................................103 8.9 USPS certifications............................................................ 104 8.9.1