Accumail Verify HTML Users Guide
Contents
1. Zip 91301 Address 30101 Agoura CH 30101 30101 Agoura Ct Suite 30100 30105 Agoura Ct Company 4 Press Verify to trigger a query to append the 4 to the ZIP Code and to complete the address entry and correction process The complete address element data is displayed below Accumail Verify returned the following address elements Zip 91301 4300 State CA City Agoura Hills Street 30101 Agoura Ct Company Suite Urbanization Verify Clear CRRT Carrier C006 Route Lookup Return Lookup Return viu Code Code Description 2 Input address matched DPV Return AANI DPV Return to the ZIP 4 file z Code Code Description Input address primary LACS PMB RDI County Los Angeles CountyNumber 037 CongressionalDistrict 30 Verify Details Barcode 913014300991 DeliveryPoint 991 RecordType H IsRuralRouteDefault false IsHighriseDefault true O 2010 Datatech SmartSoft Inc V4 4 BROWSE TAB The Browse Tab allows the user to manually browse the address data based on a ZIP Code The browse feature can be used at any point during address entry This tab allows you to view the USPS Data to find the correct address Simply double click on the line you need to select or click on the buttons under the browse window WA Address Correction 4082 4098 Yankee Dr Agoura Hills CA 92. CodeDescip o LACS PMB RDI County Los Angeles CountyNumber 037 CongressionalDistrict 30 Verify Details Barcode 913014301431 DeliveryPoint 431 RecordType H IsRuralRouteDefault false IsHighriseDefault false 7 Aocumalveriy AccuMail Verify User Manual USAGE INSTRUCTIONS The AccuMail Verify user control is a Flex object that is referenced by a web paged served by your server The simplest configuration involves unzipping the downloaded zip file and copying the contents to a website directory currently served by your server The included index html has the basic building blocks for integrating the control into your website and will work for address correction out of the box SAMPLE ARCHITECHTURE FOR ABC INC ABC Inc Web SmartSoft Lookup Servers Web Server Internet Intranet Internet ABC Inc Users Address correction requests ABC Inc web application request response data To integrate the corrected addresses and push the values back to your server side the following 3 dependencies should be understood e AccuMail Verify Flex Object e JavaScript function exposeAccumailVerifyAddress e Form Elements The AccuMail Verify Flex Object calls a JavaScript function exposeAccumailVerifyAddress whenever an address is corrected The JavaScript function takes the values from the Verify Flex Object and pushes them to the HTML form elements These form eleme
3. Web our Address Quality Firewall Lin t 2 System ROG UI CIN D Eee orci dus Deni Til dn UR Ld otUEE ES 2 v lp m cea 2 lujo cic 2 SOU SEC 0S acs gta snes E m 2 PRE VIC WY OF PRO QUE TRE NL c 3 Address took ecclesi eee te 3 alf oa edame 3 M 3 Address Enty PrOCESS 4 spo uj H 5 BU ONS MEN c 5 Address Bi OWS Proc userei AN ut dpt DAMNUM vM EEUU 6 Side UCTIOMNS RE TT T Tm 8 Sampe Ar MC COG ABC NG ouen sasesvacieuepeisteduvssetue M M ME DN 8 OO arsine etd as hapa ice tuu 9 Get CVC TOI NR T Om 10 Po Ge A VS AS deters Scere sachets EE ooo oo 10 Optional Custom COMPUT ONS reaa EEEa E aAa aS 11 Eelo KA ee e E E E E E E EE EE AE EEE ENE E E 11 BE o E e m 12 sre 13 RETU MM
4. Street Adelina Ct Agoura Rd Agoura glen Dr Alan Dr 4 Select Number then press Accept see example C or press Select Suite if applicable then press Accept see example D Wf AcouMailVerity Address Correction 30101 Agoura Ct Agoura Hills CA 91301 Select Street Number 30000 30098 30001 30099 30077 30077 30100 30198 Example C 2010 Datatech SmartSoft Inc Md Acouvailverify vs Correction 30101 Agoura Ct Ste 1 Agoura Hills CA 91301 Select Suite Suite Ste 120 to 120 Ste 123 to 123 Ste 125 to 125 Ste 130 to 130 Example D 4 Scouveiveriy 6 5 Complete the address or suite number indicated by V4 ac mtr Accra Voaldapnen Address Suite Br ive Apt 513 to 514 Apt 403 to 414 Apt 301 to 314 Apt 601 to 614 Ste BtoB Ste 1 to 1 Browse 6 Press the Verify button to trigger a query for the 4 and to complete process ZIP 4 is appended and address elements are displayed Accumail Verify returned the following address elements Zip 91301 4301 State City Agoura Hills Street 130101 Agoura Ct Company Suite Ste 118 Urbanization ci iR C006 Lookup Return i Lookup Return PAE dpi they Code Code Description Input address matched
5. codes for CASS certification T 14 EP 14 PREFACE AccuMail Verify is web component used to query select and insert correct addresses into your form quickly and easily as you type address information The Flex based web control is designed for ease of integration into internet applications The user interface is customizable through configurations to smoothly integrate with your existing application SYSTEM REQUIREMENTS SERVER Standard web server capable of delivering Flash Flex content over http s Examples include IIS Apache Websphere Weblogic Glassfish etc WORKSTATION Standard web browser with version 9 of Adobe flash player installed capable of loading Flash Flex content Examples include Internet Explorer Firefox Safari Chrome etc 256 MB RAM Internet access address data is returned from the SmartSoft web service to the client QUICK SETUP STEPS 1 Extract the contents of the zip file to a directory served by your web server 2 Point a browser to the URL for your server and the index html page that was extracted to the server directory 3 Enter your username license key and toolkit license key when prompted by the application on the first use Credentials will be prompted whenever AccuMail Verify is used in a new domain 4 Contact Datatech SmartSoft if you have not received thi
6. default configurations you will need to include a JavaScript function fetchCustomConfig and point to your AccumailVerifyConfig xml file The included index html also includes the fetchCustomConfig function Optional Custom Configuration JavaScript function fetchCustomConfig return http www xyzcompany com xyzcompany verify_remote AccumailVerifyConfig xml LOOKUP SERVICE The Auto redirect to browse on error controls the flow in the UI when a Lookup is triggered on an incorrect address If this is configured to true the control will automatically redirect the user to the browse tab to help the user search for the correct address AccumailVerifyConfig xml lookup service lt if true the user will be automatically redirected to the browse tab when a lookup fails to return a matched address auto redirect browse on error true auto redirect browse on error lookup service 11 V4 Acci AccuMail Verify User Manual Ul WIDGETS Labels Buttons and Input Fields in Address Lookup can be configured to have custom visibility x amp y coordinates font styles bold underline italics font sizes and font color This allows you to customize and rearrange the entire Address Lookup UI to fit your requirements e Labels can additionally be configured to have custom text For example you may want the label for Zip to read as Zip code e Buttons can additionally be configured to have custom text width height ta
7. the same degree of confidence Incorrect ZIP city or urbanization resulted in multiple matches with the same degree of confidence A corrected field was too long to fit into the supplied field Media Error The database could not be read because of a hardware or system problem Q Why is the building house number not displaying or hidden A We strive to provide as much of the address allowed to ensure users can enter correct addresses as fast as possible There are US Postal Service regulations that prevent address mining and providing exact house numbers is a violation of those regulations Clicking the Lookup button once an address has been entered will validate that the user has entered a valid house number even though AccuMail Verify did not provide the exact house number in the drop down 2010 Datatech SmartSoft Inc V4 14 ADDITIONAL HELP AND CONTACT DETAILS For more information on any Datatech SmartSoft product please call us at 888 227 7221 Datatech SmartSoft Inc 30101 Agoura Court Suite 118 Agoura Hills CA 91301 4301 888 227 7221 or 818 707 9300 Fax 818 707 9333 Web Contact Form http www smartsoftusa com contact Email sales smartsoftusa com Technical Support Toll Free 800 578 8324 Email smartsoftusa com Accounting 800 361 1409 from the US or 514 332 0741 800 361 9673 from Canada Datatech SmartSoft Inc is a non exclusive Limited Service Provider license
8. 1301 Select Street Woodglen Dr Yerba seca Ave De berry Dr De vore Ct 7 Ste 125 to 125 Ste 130 to 130 Selec rect Selec Company BUTTONS e Select City Allows user to choose a specific City if multiple cities are located in a single ZIP Code available matching city data is displayed Select Street Allows user to choose a specific Street Select Suite Allows user to choose a specific Suite number e Select Company Allows user to choose a specific Company Name e Accept Completes browse function and transitions to Address Lookup tab to complete the address entry process 5 V4 ccuMallveri AccuMail Verify User Manual ADDRESS BROWSE PROCESS 1 Enter ZIP Code on the Address Lookup tab Press the Browse Tab The City will either populate automatically and display available Streets see example B or if multiple Cities are located in a single ZIP Code available matching city data is displayed see example A Example A 2 Select desired City then press Select Street 3 Begin typing desired Street name until match is found then press Select Street 7 Example B v4 AccuMailVerify Real time Address Validation Browse 91301 Select City Zip Cada State City 91301 CA Calabasas Hls 91301 CA Calabasas Hills 91301 CA Calabasas Agoura W4 AcouMailverify Address Correction Browse Agoura Hills CA 91301 Select Street
9. 42 Height 342 The size specified in your form will override this value gt lt width gt 600 lt width gt lt height gt 300 lt height gt lt main_form_config gt 2010 Datatech SmartSoft Inc V4 ACTI 12 SECURITY Security is enforced with a set of keys setup by the first use of the AccuMail Verify product and matches within your domain on the SmartSoft lookup server Upon initial access the AccuMail Verify Credential Setup window requires you to enter your Username License Key and Tool License Key for the domain that is serving the AccuMail Verify Object Accumail Verify Credential Setup x Please enter credentials received from SmartSoft Inc Lisernarme License Key Toolkit License Key Submit F Baar Whenever the application is referenced from a new domain the credential will need to be added again For example if you have development test and production environments you would need to input the security credentials one time for each environment The credentials will be prompted for any first access via a new domain If you have multiple domains serving the same application such as the following then you would need to submit the credentials once per domain e WWW Xyzcompany com e xyzcompany com e addresscorrection xyzcompany com Accumail Verify Credential Setup x Please enter credentials received from SmartSoft Inc Username my username License Key 936D401F 9ABD 4d9d 80C7 02
10. AF85C822 Toolkit License Key 5S36DAO01F 2ABD 5d58d S0CF 02AFB8S5CB33F Submit Baa 13 Ma AccuMail Verify User Manual RETURN CODES FOR CASS CERTIFICATION Description The address has been successfully coded The address is coded but undeliverable i e on side of street known to contain no houses The ZIP Code was not found and the city and state cannot be used to determine a geographical area to search Coding would result in changing both ZIP and city This is illegal for P O Box and route type addresses The best match would result in too many suspicious changes The street was identified as an alias but was out of the range restricted for that alias No street address was given There are no street name matches in the given ZIP Code or in any geographically related ZIP code The street may contain superfluous components which cannot be discarded with confidence The house number could not be matched A 6 B8 o The best match was made to a ZIPMOVE record but was not an exact match A ZIPMOVE match was made but no exact match could be found in the new ZIP The Early Warning System indicates that an exact match will become available in the next database update There are multiple matches with the same degree of confidence This may indicate an inconsistency in the USPS data Incorrect suffix directional street name or unit resulted in multiple matches with
11. b index hot keys and background color e Input Fields can additionally be configured to have custom width height tab index and background color e main form can be configured have custom visibility width height AccumailVerifyConfig xml lt Config for Street Input street input lt visible gt true lt visible gt lt x_coord gt 98 lt x_coord gt lt y_coord gt 74 lt y_coord gt lt width gt 420 lt width gt lt height gt 22 lt height gt lt font_style gt Verdana lt font_style gt lt font_effect gt None lt font_effect gt lt None Bold Italic Underline gt lt font_size gt 16 lt font_size gt lt font_color gt black lt font_color gt lt back_color gt white lt back_color gt lt tab_index gt 4 lt tab_index gt lt street_input gt lt street_label gt label text Address label text gt lt visible gt true lt visible gt lt x_coord gt 10 lt x_coord gt lt y_coord gt 74 lt y_coord gt lt font_style gt Verdana lt font_style gt lt font_effect gt None lt font_effect gt lt None Bold Italic Underline gt lt font_size gt 16 lt font_size gt lt font_color gt black lt font_color gt lt street_label gt AccumailVerifyConfig xml lt Config for Main Form gt lt main_form_config gt lt HTML color codes FFDD77 CCAA22 etc or specific color white black blue etc gt lt back_color gt D2DDE1 lt back_color gt lt Default Size Width 7
12. e of the United States Postal Service Its product and service prices are neither established controlled nor approved by the USPS The following trademarks are owned by the United States Postal Service P O Box ZIP ZIP 4 ZIP Code and USPS 15 V4 Verify User Manual
13. nts can be text inputs as the index html example contains or hidden attributes The JavaScript example sets the form elements but can also be changed to set the values to whatever form elements may exist in your current web form 2010 Datatech SmartSoft Inc V4 ACCUMAIL VERIFY FLEX OBJECT To include the Flex object in your page the following object reference is required index html noscript object classid clsid D27CDB6E AE6D 11cf 96B8 444553540000 idz AccumailVerifyFlexApp widthz 600 heightz 302 codebase http fpdownload macromedia com get flashplayer current swflash cab gt lt param name movie value http ncoa smartsoftwebservices com AccumailVerify_v01 web AccumailVerifyFlexApp swf gt lt param name quality value high gt lt param name bgcolor value 869ca7 gt lt param name allowScriptAccess value always gt lt embed src http ncoa smartsoftwebservices com AccumailVerify_v01 web AccumailVerifyFlexApp swf quality high bgcolor 869ca7 width 600 height 302 name AccumailVerifyFlexApp align middle lt loop false quality high allowScriptAccess always type application x shockwave flash pluginspage http www adobe com go getflashplayer gt lt embed gt lt object gt lt noscript gt 9 VE AccuMail Verify User Manual JAVASCRIPT FUNCTION To tie the AccuMail Verify object to the form elements the following JavaSc
14. ript function is required index html script language JavaScript type text javascript gt AccuMail Verify Callout function that sets values of fields hidden or visible on your web form function exposeAccumailVerifyAddress Street City State Zip PlusFour Company SuiteSUD ResultCode ResultCodeDesc document getElementByld calloutAccumailVerifyStreet value Street document getElementByld calloutAccumailVerifyCity value City document getElementByld calloutAccumailVerifyState value State document getElementByld calloutAccumailVerifyZip value Zip document getElementByld calloutAccumailVerifyPlusFour value PlusFour document getElementByld calloutAccumailVerifyCompany value Company document getElementByld calloutAccumailVerifySuite value SuiteSUD document getElementByld calloutAccumailVerifyLookupReturnCode value ResultCode document getElementByld calloutAccumailVerifyLookupReturnCodeDesc value ResultCodeDesc j lt script gt HTML FORM ELEMENTS Table that contains all of the form elements set by the JavaScript function index html lt table gt lt tr gt lt td class pageTitleSecondary gt AccuMail Verify returned the following address elements lt td gt lt tr gt lt table gt lt table gt lt tr gt lt td gt Street lt td gt lt td gt lt input typez text idz calloutAccumailVerifyStreet gt lt br gt lt td gt lt tr gt lt td gt City lt td gt lt td g
15. s information using the contact information below 5 Start correcting addresses 2010 Datatech SmartSoft Inc ccuvalvery 2 REVIEW OF PRODUCT The main control contains two sliding windows Address Lookup and Browse ADDRESS LOOKUP WINDOW The Address Lookup window allows users to manually enter data for validation Use the tab key to navigate through the fields WA ccuveiiverity Address Correction Browse FIELDS e Zip e State e City e Address e Suite e Company BUTTONS e Verify button triggers an address validation to ensure the exact address exists as a delivery point DPV e Clear button clears all the data from the control 3 V4 Verify User Manual ADDRESS ENTRY PROCESS 1 Enter ZIP Code and press Tab the State field will populate automatically 2 Press Tab City will either populate automatically or if multiple Cities are located in a single ZIP Code available matching city data is displayed in the dropdown as additional City data is entered You may also navigate through available matching cities using the arrow keys on your keyboard press enter to choose desired City 3 Press Tab and begin typing Address Number Available matching addresses are displayed in the dropdown as more address data is entered You may also navigate through available matching addresses using the arrow keys on your keyboard press enter to choose desired address Example below
16. t lt input type text id calloutAccumailVerifyCity gt lt br gt lt td gt lt tr gt lt td gt State lt td gt lt td gt lt input type text id calloutAccumailVerifyState amp nbsp gt lt br gt lt td gt lt tr gt lt td gt Zip lt td gt lt td gt lt input type text id calloutAccumailVerifyZip gt lt br gt lt td gt lt tr gt lt td gt Plus Four lt td gt lt td gt lt input typez text id calloutAccumailVerifyPlusFour gt lt br gt lt td gt lt tr gt lt td gt Company lt td gt lt td gt lt input typez text id calloutAccumailVerifyCompany gt lt br gt lt td gt lt tr gt lt td gt Suite lt td gt lt td gt lt input type text id calloutAccumailVerifySuite gt lt br gt lt td gt lt tr gt lt td gt Lookup Return Code lt td gt lt td gt lt input type text id calloutAccumailVerifyLookupReturnCode gt lt br gt lt td gt lt tr gt lt td gt Lookup Return Code Description lt td gt lt td gt lt textarea rows 3 cols 20 id calloutAccumailVerifyLookupReturnCodeDesc gt lt textarea gt lt br gt lt td gt lt tr gt lt table gt 2010 Datatech SmartSoft Inc V4 ACTI 10 OPTIONAL CUSTOM CONFIGURATIONS AccuMail Verify configurations are stored in the AccumailVerifyConfig xml file included in the downloaded zip file This file allows you to configure user interface controls to more readily conform to your existing application In order to use the custom configurations rather than the
Download Pdf Manuals
Related Search