Pentaho/Contact Zone:SmartMover:Output
← Data Quality Components for Pentaho
SmartMover Navigation | ||||||
---|---|---|---|---|---|---|
Overview | ||||||
Tutorial | ||||||
| ||||||
| ||||||
Result Codes |
The output section consists of various sets of return fields. Output Name returns the concatenated and or parsed Name parts of the input Name. Output Address returns the new change of address data or for non-moves, standardized address information. Additional Output Columns can be used to store additional address info and parsed address parts.
New field names can be created by typing the name into the box.
- Use Input Fields For Output
- Selecting this option will automatically map your input Name and Address fields as the output fields, hence overwriting the original structure with new data. Caution: selecting this option will wipe out any new Output fields you have just created.
Output Name
- FullName
- This field returns the standardized FullName used to look up the change of address.
- Prefix
- This field returns any part of the name that precedes the given name, such as "Mr.," "Ms." or "Dr.," for each full name detected.
- First Name
- This field returns the given name for each full name detected.
- Middle Name
- This field returns the middle names or initials for each full name processed.
- Last Name
- This field returns the family name for each full name processed.
- Suffix
- This field returns any part of the name that follows the family name, such as degrees ("MD" or "PhD") and generational indicators ("IV" or "Jr."), for each full name processed.
Output Address
- Company
- Map the field that will receive the Company information.
- Address
- Map the field that will receive the updated address or standardized street address that was used for verification. This may be the contents of the Address 2 input field, if address swapping has occurred.
- Address 2
- Map the field that will receive the updated address or standardized street address that was not used for verification, if two address lines were present.
- City
- Map the field that will receive the city name. The information returned may be different than the contents of the City input field, if the preferred city name has been substituted for a vanity city name or if the address was coded to a different ZIP Code instead.
- State/Province
- Map the field that will receive the two-character state abbreviation.
- Zip/Postal Code
- Map the field that will receive the five-digit U.S. ZIP Code.
- AddressKey
- Map the field that will receive the AddressKey for the returned record. The Address Key was created by Melissa Data to uniquely identify an address and used as input to our other individual services like Geocoding.
Move information
- Effective Date
- Map this field which receives the effective date (yyyymm) of a change of address.
- Move Type Code
- Indicates the type of address record that was matched.
Code Description F Family B Business I Individual
- Move Return Code
- Indicates the level of matching between the current record and the NCOALink database.
- See SmartMover Component Result Codes for more information.
Additional Output Columns
The Next button navigates to page 2 of the Output Columns tab. Additional Output Columns allow you to map fields for returned data that goes beyond the standard change-of-address information.
Address Information
- Suite
- Map the field that will receive the updated or standardized suite information, if any.
- Private Mailbox
- Map the field that will receive the private mailbox number. This field is populated if the primary address was identified as a Commercial Mail Receiving Agency (CMRA) and the secondary address information is present. This field would also be populated if the secondary address information contains the string "PMB," thus identifying the address as a private mailbox.
- Plus 4
- Map the field that will receive the four-digit extension from the ZIP + 4.
- Delivery Point & Check Digit
- The delivery point is a two-digit number that combined with the ZIP + 4, generates a unique number for each address in that ZIP + 4. This number is used to generate barcodes, so if you plan you use this address data for commercial mailing, it would be necessary to map an output field for this information. Typically, the Delivery Point Code will be the last two digits of the street number, but the most accurate way to obtain this information is by submitting the address for Address Verification and storing the Delivery Point code for future use.
- The delivery point check digit is an additional one-digit number that is combined with the Delivery Point when generating barcodes for mailing.
- Carrier Route
- The Carrier Route is a four-character code that indicates which mail carrier delivers to the input address. The first character of this Carrier Route is always alphabetic and the last three characters are numeric. For example, "R001" or "C027" would be typical carrier routes. The alphabetic letter indicates the type of delivery associated with this address.
- B = PO Box
- C = City Delivery
- G = General Delivery
- H = Highway Contract
- R = Rural Route
- Urbanization
- Map the field that will receive the Urbanization name, if any. See the entry for the Urbanization input field for more information on this field.
- City Abbreviation
- If the name returned by the City field is longer than 13 letters, the City Abbreviation field will return the official abbreviation the Post OfficeTM has associated with that city or municipality name. For example, the City Abbreviation field will return the abbreviation "Rcho Sta Marg" for "Rancho Santa Margarita." If the value returned by the City field is 13 letters or shorter, the City Abbreviation field will return the full city or municipality name.
- Country
- Returns the full name of the country in which the address is located. Currently, only Canada and the United States are supported, although SmartMover Web Service will only update the U.S. addresses.
- Country Abbreviation
- Returns the standard abbreviation of the country in which the address is located. Currently, only Canada and the United States are supported, although SmartMover Web Service will only update the U.S. addresses.
- DPV Footnotes
- JSON: Records[index].DPVFootnotes
The DPV footnotes indicate the level of matching between the current address and the USPS’s DPV database. The footnote may be up to six characters long. Refer to the table below for possible codes returned in this field.
DPV Address Status Codes
Code Description AA Input Address Matched to the ZIP + 4 file A1 Input Address Not Matched to the ZIP + 4 file BB DPV matched (all components) CC Primary Number Match – Secondary present but invalid F1 Address Was Coded to a Military Address G1 Address Was Coded to a General Delivery Address M1 Primary Number missing M3 Primary Number invalid N1 Primary Number Match – Secondary missing P1 Missing PO, RR or HC Box number P3 Invalid PO, RR or HC Box number R1 DPV matched to CMRA – PMB number not present RR DPV matched to CMRA U1 Address Was Coded to a Unique ZIP Code
Parsed Address Columns
These fields return street address information, split into its components.
- Address Range
- This field returns the street number.
- Pre-directional
- This field returns any directional indicators that precede the street name. The directionals are returned as one- or two-character abbreviations. If the input data contained "Southwest," it would be shortened to "SW."
- Street Name
- This field returns only the street name, minus the suffixes or directionals. For "SW Main Street," this would return "Main."
- Suffix
- This field returns the standard abbreviations for the street types: "RD," "ST," "AVE," "BLVD," etc.
- Post-directional
- This field returns any directional indicators that follow the street name. The directionals are returned as one- or two-character abbreviations. If the input data contained "Southwest," it would be shortened to "SW."
- Suite Name
- This field returns the descriptive portion of the secondary address: "SUITE," "APT," "UNIT," etc.
- Suite Range
- This field returns the valid Ranges for Suites for each inputted address.
- Private Mailbox Name
- This field returns the descriptive portion of the private mailbox number. A private mailbox, or PMB, is a secondary address associated with a Commercial Mail Receiving Agency (CMRA). Because the CMRA may itself be located in a suite, such an address may have both a suite number and a PMB number.
- The name portion of the PMB will normally be either "#" or "PMB."
- Private Mailbox Range
- This field returns the valid Ranges for Private Mailboxes for each inputted address.
- Extra Information
- This field returns any text from the street address field that does not fit into one of the above categories.