Aptify's Postal Code look-up functionality applies to all entity fields that have an Extended Extended Type set to set to ZipCode, such as the Addresses service's s Postal Code field field. (See See Administering Entities for more information on entity fields and the Extended Type property.)
Note |
---|
This section is for administrator use only. |
Info |
---|
The As of Aptify 5.5.5, the Postal Code look-up functionality does not currently work works in the Aptify web interface. When using In previous releases of the Aptify web interface, postal codes must be entered manually. |
...
The Postal Codes service includes five attributes that control the behavior of the Postal Code look-up functionality. An administrator can configure these attributes as necessary to modify the Postal Code look look-up behavior for an organization.
- OverrideCountryOnMatch: When set to to True, this will change the address's country if the Country associated with the retrieved Postal Code is different from the address's current value. For example, if if Country is is set to to United States and and you enter a Canadian Postal Code, the system will automatically change the the Country to to Canada and and populate the record's s City, State, and and County fields fields accordingly.
When set to to False, the system retrieves a Postal Code only if its associated Country matches the address's current Country value. For example, if the the Country is is set to to United States and and you enter a Canadian Postal Code, the system will not automatically populate any fields since it could not find a matching ZIP Code in the United States.
Note The country-based look-up functionality described above is only available when Postal Code information for more than one country exists in the Postal Codes service. The standard data provided by Aptify includes only U.S. ZIP Codes. It does not include Canadian or other international Postal Codes.
- DisplayMultipleSetGUIDisplayMultipleResultsGUI: When set to to True (the default setting), the system displays a pop-up selection box if there are multiple matches for the entered Postal Code. For example, if you enter enter 2000 in a a Postal Code field field, a pop-up box appears that lists lists 20001 to to 20009.
- When set to to False, the system does not display the pop-up box. Instead, it completes the the Postal Code, City, State, and and County fields fields using data from the first matching record. For example, if you enter enter 2000 in the the Postal Code field field, 20001 will appear in the the Postal Code field field.
- When set to to False, the system does not display the pop-up box. Instead, it completes the the Postal Code, City, State, and and County fields fields using data from the first matching record. For example, if you enter enter 2000 in the the Postal Code field field, 20001 will appear in the the Postal Code field field.
- AllowPartialMatch: When set to to True (the default setting), the system looks for partial Postal Code matches. When set to to False, the system looks only for exact matches. When this attribute is set to to False, the system will not display the pop-up selection box even if if DisplayMultipleResultsGUI is is set to to True.
- MinimumLookupCharacters: This attribute specifies the minimum number of characters that must be entered in a a Postal Code field field to begin the look-up process. By default, it is set to to 4. Aptify recommends that you do not set this attribute to a value less than 4.
- Using fewer search characters will increase the number of partial matches that are returned by the process, which can have a negative impact on system performance since the system will load all of the partial matches into the Multiple Results pop-up box.
- Using fewer search characters will increase the number of partial matches that are returned by the process, which can have a negative impact on system performance since the system will load all of the partial matches into the Multiple Results pop-up box.
- MaximumLookupCharacters:This attribute specifies the maximum number of characters that the system will use to locate matching Postal Codes in the database. By default, it is set to to 5. This attribute must be set to 5 in order to support ZIP+4 codes in the United States.