Optima Option Number (OON) Enumeration - trillium_geolocation - 15.19

Trillium Geolocation Reference

Product type
Software
Portfolio
Verify
Product family
Trillium
Product
Trillium > Trillium Geolocation
Version
15.19
Language
English
Product name
Trillium Geolocation
Title
Trillium Geolocation Reference
Copyright
2023
First publish date
2017
Last updated
2024-04-16
Published on
2024-04-16T03:27:32.653616

The OON enumeration specifies the various options available through the Optima Server object.

Value

Description

SalutationLanguage

This is the language used to generate salutations. 0 (default) means use the country-specific language. The position of a language in the ordered list returned by the GetLanguageList method, described on page 75, determines its numeric value.

CountryLanguage

This option is reserved for future use.

OverrideLanguage

Override the salutation language by using the language of the title field. 0 (default) means do not override.

NameCasing

The casing to use when formatting name data, specified using the OCO enumeration. Default is proper case.

UsePerFieldCasing

Specifies whether the address-wide casing option (‘AddressCasing’) or the per-field casing options (‘StreetCasing, ‘CityCasing’, and so on) should be used when applying casing to an address. The default is 0 (use the address-wide casing option).

AddressCasing

The casing to use when formatting address data, specified using the OCO enumeration. Requires that ‘UsePerFieldCasing’ is set to 0 (false). The default is proper case. Default is proper case.

DepartmentCasing

The casing to use when formatting the Department field. Requires that ‘UsePerFieldCasing’ is set to 1 (true). The default is proper case.

CompanyCasing

 The casing to use when formatting the Company field. Requires that ‘UsePerFieldCasing’ is set to 1 (true). The default is proper case.

BuildingCasing

The casing to use when formatting the Building field. Requires that ‘UsePerFieldCasing’ is set to 1 (true). The default is proper case.

SubBuildingCasing

The casing to use when formatting the Sub Building field. Requires that ‘UsePerFieldCasing’ is set to 1 (true). The default is proper case.

PremiseCasing

The casing to use when formatting the Premise field. Requires that ‘UsePerFieldCasing’ is set to 1 (true). The default is proper case.

StreetCasing

The casing to use when formatting the Street field. Requires that ‘UsePerFieldCasing’ is set to 1 (true). The default is proper case.

SubStreetCasing

The casing to use when formatting the Sub Street field. Requires that ‘UsePerFieldCasing’ is set to 1 (true). The default is proper case.

POBoxCasing

The casing to use when formatting the PO Box field. Requires that ‘UsePerFieldCasing’ is set to 1 (true). The default is proper case.

SubCityCasing

The casing to use when formatting the Sub City field. Requires that ‘UsePerFieldCasing’ is set to 1 (true). The default is proper case.

CityCasing

The casing to use when formatting the City field. Requires that ‘UsePerFieldCasing’ is set to 1 (true). The default is proper case.

RegionCasing

The casing to use when formatting the Region field. Requires that ‘UsePerFieldCasing’ is set to 1 (true). The default is proper case.

PrincipalityCasing

The casing to use when formatting the Principality field. Requires that ‘UsePerFieldCasing’ is set to 1 (true). The default is proper case.

PostcodeCasing

The casing to use when formatting the Postcode field. Requires that ‘UsePerFieldCasing’ is set to 1 (true). The default is proper case.

ExtraPostcodeCasing

The casing to use when formatting the Extra Postcode field. Requires that ‘UsePerFieldCasing’ is set to 1 (true). The default is proper case.

ExtraCityCasing

The casing to use when formatting the Extra City field. Requires that ‘UsePerFieldCasing’ is set to 1 (true). The default is proper case.

CountryCasing

The casing to use when formatting the Country field. Requires that ‘UsePerFieldCasing’ is set to 1 (true). The default is proper case.

TelephoneCasing

This option is for future use.

NameWordCheck

Check for vulgar words and report in the WCR (Word Correction Result) field.

AddressWordCheck

Check for vulgar words and report in the WCR field.

TelephoneWordCheck

This option is for future use.

ForceUpdate1

(Option mask, set using ForceUpdate1)

Note: ForceUpdate2 and ForceUpdate3 are not used.

Allow the validation engine to update a particular field irrespective of the original contents.

Deprecated1

This field is obsolete.

NameFlagBadWord

Mark vulgar words found in the name fields with *>word<*.

AddressFlagBadWord

Mark vulgar words found in the address fields with *>word<*.

TelephoneFlagBadWord

This option is for future use.

Deprecated2

This field is obsolete.

CautiousUpdate

Only allow the validation engine to update those fields where the difference between the input data and the reference data is very small. Default is 0 (off).

EnforceBlanks

Update fields with reference data even if that data is empty. WARNING: only use this option for those countries where the reference data is complete for all fields. Default is 0 (off).

DedupeCommonErrors

Correct common address standardization and validation errors by performing cross-component matching. Default is 1 (on).

FormatComponents1

(Option mask, use FormatComponents1)

 

Note: FormatComponents2 and FormatComponents3 are not used.

These specify which components should be included in the output address lines, correctly formatted for the relevant country.

StandardiseComponents1 (Option mask, use StandardiseComponents1)

 

Note: StandardiseComponents2 and StandardiseComponents3 are not used.

These specify which components to consider when standardizing an address from the address lines.

ValidateComponents1(Option mask, use ValidateComponents1)

 

Note: ValidateComponents2 and ValidateComponents3 are not used.

These specify which components to include, and possibly update, in the address validation process.

CompanyWeight

This allows the weight and relative importance of the company field to be altered when generating the inner matchscore. The higher the weight, the lower the matchscore will be if changes have been made to the company field. Default 1.

StreetWeight

This allows the weight and relative importance of the street field to be altered when generating the inner matchscore. The higher the weight, the lower the matchscore will be if changes have been made to the street field. Default 10.

CityWeight

This allows the weight and relative importance of the city field to be altered when generating the inner matchscore. The higher the weight, the lower the matchscore will be if changes have been made to the city field. Default 8.

PostcodeWeight

This allows the weight and relative importance of the postcode field to be altered when generating the inner matchscore. The higher the weight, the lower the matchscore will be if changes have been made to the postcode field. Default 5.

ShuffleLines

Reserved for future use.

ConcatenationLines

This option is for future use.

OuterMatchscoreLines

The number of address lines to analyze in the generation of the outer matchscore. The range is 1 to 8; the default is 8.

CarryStandardisationChanges

This specifies whether or not standardization changes such as 'ROAD' -> 'RD' should be reported in the ACR code. Default 1 (Yes).

ApplyReferenceAccents

This option is obsolete.

ReturnUserData

This specifies whether a call to SearchAddress should return non-validated user data along with the validated reference data. Default 0 (No).

SearchTimeout

This is the maximum amount of time in seconds for each individual search within ProcessAddress, ValidateAddress, SearchAddress, Select, SelectAlias, SelectUnique, or GetAlternatives. Default 5. Setting this option to 0 disables the timeout.

ReplaceAlias1(Option mask, use ReplaceAlias1)

 

Note: ReplaceAlias2 and ReplaceAlias3 are not used.

These specify which components should have values replaced with the master reference value, if applicable.

ValidatedDataOnly

This specifies whether to return address components for which a unique value can be determined, or whether to return only those components listed in the firing validation rule. Default 0 (Derive components if possible).

StandardisationDebugOutput

This specifies whether to return extra standardization information in the URL1, URL2, Email1, and Email2 Contact object fields. Default 0 (No).

FormatSearchResults

This specifies whether to internally call Format Address for each result to a SearchAddress call. Default 0 (No).

CompareField1(Option mask, use CompareField1)

 

Note: CompareField2 and CompareField3 are not used.

These specify which components will be used to generate the result of a CompareContacts call.

AlwaysShow1(Option mask, use Always Show1)

 

Note: AlwaysShow2 and AlwaysShow3 are not used.

Specifies which fields will always be present in an initialized OptimaSearchSession, whether or not validating data exists for them. By default this includes Premise, Street, PO Box and City.

StandardiseComponents

This option is reserved for future use.

Remove Numerics

This option is reserved for future use.

Geocode Search Results

Specifies whether results from SearchAddress will be automatically geocoded. A suitable geocoding data set must be available. The default is 0 (off).

BusinessFlagSearchResults

This option is reserved for future use.

Transliterate

The transliteration method to use when formatting data, specified using the OTO enumeration. The default is Retain Diacritics.

StrictSelect

Specifies whether calls to the Select follow strict semantics. If set to 1, then criteria which do not match any results are enforced, so the Select call will not return any results. If set to 0, then criteria which do not match any results are ignored. The default value is 0.

PhoneticAliasMatch

This option is reserved for future use.

IgnoreEOLs

This option is reserved for future use.

ReturnPremiseRanges

If set to 1, specifies that calls to SearchAddress (or calls to Select where Premise is specified as a return field) will return a single result for each range of premise numbers, rather than individual results for each premise number within the range. The default value is 0.

ConcatenateValidationRules

If set to 1, specifies that validation rule codes will be concatenated when the same contact object is processed by multiple datasets by sequential calls to ProcessAddress, ValidateAddress or EnhanceContact. If set to 0, each dataset that processes the contact object will overwrite any existing validation rule code. The default value is 0.

AddressValidationRuleOFT

Specifies the field in the contact object that will receive the validation rule code from calls to ProcessAddress or ValidateAddress. The default value is 32 (TCR).

EnhanceValidationRuleOFT

Specifies the field in the contact object that will receive the validation rule code from calls to EnhanceContact. The default value is 32 (TCR).

ExhaustiveValidation

Multiple address datasets from different providers can be installed on Trillium Geolocation server for the same country.

 

If set to 1, this option specifies that calls to ProcessAddress or ValidateAddress will attempt to validate the input data against all available datasets and return the best result, based on the ACR code.

 

If set to 0, the server will use the dataset with the most detailed reference data (unless the priority order of the datasets has been overridden by the administrator of the server).

 

The default value is 1.

ExhaustiveEnhancement

Multiple enhancement datasets containing the same type of data for the same country can be installed on the Trillium Geolocation server. For example, geocode (latitude/longitude) data sets from different providers may be installed.

 

If set to 1, this option specifies that calls to EnhanceContact where a dataset type (such as GEOCODE) is specified will attempt to enhance the input data against all available datasets and return the best result, based on the validation rule code. Calls to EnhanceContact where a dataset name is specified will not be affected.

 

If set to 0, the server will use the dataset with the most detailed data (unless the priority order of the datasets has been overridden by the administrator of the server).

 

The default value is 1.

ExhaustiveSearchAddress

Multiple address datasets from different providers can be installed on a Trillium Geolocation server for the same country.

 

If set to 1, this option specifies that calls to SearchAddress will attempt to search for the input data against all available datasets  until some results are found. Once some results are found, no further datasets will be searched; all results will be from the same dataset.

 

If set to 0, the server will use the dataset with the most detailed reference data (unless the priority order of the datasets has been overridden by the administrator of the server).

 

The default value is 1.

EnhancedDataOnly

Specifies whether calls to EnhanceContact (for example, for geocoding) should strip address components that are not used to produce the enhancement result. The default is 0 (retain all address components).

UseReferenceDataDictionary

Specifies whether the Reference Data Dictionary tool is used during parsing. this tool improves parsing accuracy in most scenarios, but can be disabled if required. The default is 1 (on).

ReferenceDataDictionaryInput1 (option

mask, use ReferenceDataDictionaryInput1)

 

Note: ReferenceDataDictionaryInput2 and ReferenceDataDictionaryInput3 are not used.

Specifies which address component fields should be used as inputs to the Reference Data Dictionary tool when they are populated on input. The default settings are recommended, but they can be changed if required.

 

By default this option is enabled for all address components except Department, Company, Building and SubBuilding. (Address Line fields are always used in Reference Data Dictionary searches).

AdvancedAddressLineDeduplication

Improves the removal of duplicated information in address lines during the parsing process for most forms of input, but can be disabled if required. The default is 1 (on).

NumOptionsPlusOne

This is used to determine the total number of options.