オプション
以下の表に、ValidateAddressLoqate が返す情報の種類を制御するオプションの一覧を示します。
オプション名 |
説明 |
---|---|
Database.Loqate |
国際住所の妥当性の確認に使用するデータベースを指定します。国際住所検証用のデータベースを指定するには、[データベース] ドロップダウン リストからデータベースを選択します。 |
OutputFieldLevelReturnCodes |
フィールドレベルの結果インジケータを含めるかどうかを指定します。フィールドレベルの結果インジケータは、ValidateAddressLoqate が各住所要素をどのように処理したかを示します。フィールドレベルの結果インジケータは、修飾子 "Result" で返されます。例えば、HouseNumber のフィールドレベルの結果インジケータは HouseNumber.Result に格納されます。結果インジケータの出力フィールドの完全な一覧は、結果インジケータを参照してください。
|
OutputFormattedOnFail |
住所の妥当性を確認できない場合に書式を整えた住所を返すかどうかを指定します。住所には、その国の標準住所書式が設定されます。このオプションを選択しない場合、ValidateAddressLoqate が住所の妥当性を確認できないと、出力住所フィールドは空白になります。
[標準住所を含める]、[住所行の要素を含める]、および [郵便情報を含める] の各チェック ボックスで指定されたフォーマットを使用して、書式を整えた住所が返されます。[住所行の要素を含める] を選択した場合は、妥当性が確認できた住所に対しては、パース済みで妥当性を確認済みの住所が、パース済み住所要素に含まれることに注意してください。住所の妥当性が確認できなかった場合には、パース済み住所要素には、入力住所がパース済み形式で含まれることになります。ValidateAddressLoqate が住所の妥当性を確認できたかどうかにかかわらず、必ず入力住所をパース済み形式で出力したい場合は、[正規化された入力住所要素を含める] を選択します。 このオプションをオンにする場合は、[標準住所を含める] と [住所行の要素を含める] またはそのいずれかを選択する必要があります。 OutputRecordType オプションで指定されたフォーマットを使用して、書式を整えた住所が返されます。OutputRecordType=E を指定した場合は、妥当性が確認できた住所に対しては、パース済みで妥当性を確認済みの住所が、パース済み住所要素に含まれることに注意してください。住所の妥当性が確認できなかった場合には、パース済み住所要素には、入力住所がパース済み形式で含まれることになります。ValidateAddressLoqate が住所の妥当性を確認できたかどうかにかかわらず、必ず入力住所をパース済み形式で出力したい場合は、OutputRecordType=I を指定します。 Y を指定する場合は、OutputRecordType に対して "A" と "E" またはそのいずれかを指定する必要があります。 Option.OutputRecordType オプションで指定されたフォーマットを使用して、書式を整えた住所が返されます。Option.OutputRecordType=E を指定した場合は、妥当性が確認できた住所に対しては、パース済みで妥当性を確認済みの住所が、パース済み住所要素に含まれることに注意してください。住所の妥当性が確認できなかった場合には、パース済み住所要素には、入力住所がパース済み形式で含まれることになります。ValidateAddressLoqate が住所の妥当性を確認できたかどうかにかかわらず、必ず入力住所をパース済み形式で出力したい場合は、Option.OutputRecordType=I を指定します。 |
OutputAddressBlocks |
実際の郵便物に印字される、書式を整えた住所を返すかどうかを指定します。住所の各行が、別々の住所ブロック フィールドに入れて返されます。AddressBlock1 から AddressBlock9 まで、最大 9 つの住所ブロック出力フィールドが使用されます。 例えば、以下の住所入力の場合、 AddressLine1: 4200 Parliament Place 以下の住所ブロックが出力されます。 AddressBlock1: 4200 PARLIAMENT PL STE 600 ValidateAddressLoqate は、郵便当局の規格に従って住所の書式を整え、住所ブロックの形式にします。国名は、万国郵便連合 (UPU) の国名で返されます。OutputCountryFormat オプションは、住所ブロックの国名には影響を与えないことに注意してください。[国フォーマット] オプションは、Country 出力フィールドに返される名前のみに影響を与えます。 次のいずれかです。
|
AmasFormatting |
Address Matching Approval System (AMAS) 表記を使用して出力住所データをフォーマットすることを指定します。 このオプションを使用すると、Validate Address Loqate は、住所を正規化するときに AMAS ルールを使用するようになります。AMAS は、オーストラリア郵政公社が定める、住所規格を徹底するためのプログラムです。AMAS 書式設定表記の詳細については、『Address Matching Approval System (AMAS) Handbook』を参照してください。 このオプションを使用すると、出力データは次のように変更されます。
有効な値は、次のとおりです。
注: このオプションを選択すると、[許容レベル] フィールドと [最小マッチ スコア] フィールドの選択に関わらず、AMAS フォーマットで結果が返されます。
|
OutputCasing |
出力データの大文字と小文字の区別を指定します。次のいずれかです。
|
HomeCountry |
デフォルト国を指定します。大部分の住所が存在する国を指定してください。例えば、処理する住所の大部分がドイツにある場合は、ドイツを指定します。ValidateAddressLoqate は、[StateProvince]、[PostalCode]、および [Country] の各住所フィールドから国を特定できなかった場合、指定された国を使用して、住所の検証を試みます。有効な国名には次のものがあります。 Afghanistan, Albania, Algeria, American Somoa, Andorra, Angola, Anguilla, Antigua And Barbuda, Argentina, Armenia, Aruba, Australia, Austria, Azerbaijan, Bahamas, Bahrain, Bangladesh, Barbados, Belarus, Belgium, Belize, Benin, Bermuda, Bhutan, Bolivia, Bosnia And Herzegovina, Botswana, Brazil, British Virgin Islands, Brunei Darussalam, Bulgaria, Burkina Faso, Burundi, Cambodia, Cameroon, Canada, Cape Verde, Cayman Islands, Central African Republic, Chad, Chile, China, Colombia, Comoros Islands, Congo, Cook Islands, Costa Rica, Cote D'Ivoire, Croatia, Cuba, Cyprus, Czech Republic, Democratic Republic Of Congo, Denmark, Djibouti, Dominica, Dominican Republic, East Timor, Ecuador, Egypt, El Salvador, Equitorial Guinea, Eritrea, Estonia, Ethiopia, Falkland Islands, Faroe Islands, Federated States Of Micronesia, Fiji, Finland, France, French Guiana, Gabon, Gambia, Germany, Ghana, Gibraltar, Greece, Greenland, Grenada, Guadeloupe, Guam, Guatemala, Guinea, Guinea Bissau, Guyana, Haiti, Holy See, Honduras, Hong Kong, Hungary, Iceland, India, Indonesia, Iran, Iraq, Ireland, Israel, Italy, Jamaica, Japan, Jordan, Kazakhstan, Kenya, Kiribati, Korea, Kuwait, Kyrgyzstan, Laos, Latvia, Lebanon, Lesotho, Liberia, Libya, Liechtenstein, Lithuania, Luxembourg, Macau, Macedonia, Madagascar, Malawi, Malaysia, Maldives, Mali, Malta, Marshall Islands, Martinique, Mauritania, Mauritius, Mayotte, Mexico, Moldova, Monaco, Mongolia, Monserrat, Morocco, Mozambique, Myanmar, Namibia, Nauru, Nepal, Netherlands Antilles, New Caledonia, New Zealand, Nicaragua, Niger, Nigeria, Niue, Norway, Oman, Pakistan, Palau, Panama, Papua New Guinea, Paraguay, Peru, Philippines, Pitcairn Islands, Poland, Portugal, Puerto Rico, Qatar, Republic Of Georgia, Republic Of Korea, Republic Of Singapore, Reunion, Romania, Russia, Rwanda, Saint Helena, Saint Kitts And Nevis, Saint Lucia, Saint Pierre And Miquelon, Saint Vincent And The Grenadines, Samoa, San Marino, Sao Tome And Principe, Saudi Arabia, Senegal, Seychelles, Sierra Leone, Slovakia, Slovenia, Solomon Islands, Somalia, South Africa, Spain, Sri Lanka, Sudan, Surivalue, Swaziland, Sweden, Switzerland, Syria, Tahiti, Taiwan, Tajikistan, Tanzania, Thailand, The Netherlands, Togo, Tonga, Trinidad And Tobago, Tristan Da Cunha, Tunisia, Turkey, Turkmenistan, Turks And Caicos Islands, Tuvalu, Uganda, Ukraine, United Arab Emirates, United Kingdom, United States, Uruguay, Uzbekistan, Vanuatu, Venezuela, Vietnam, Virgin Islands (US), Wallis And Futuna, Yemen, Yugoslavia, Zambia, Zimbabwe |
OutputCountryFormat |
Country 出力フィールドに返される国名に使用するフォーマットを指定します。例えば、英語を選択した場合、"Deutschland" という国名は "Germany" として返されます。
|
OutputScript |
出力がどのアルファベットまたはスクリプトで返されるかを指定します。このオプションは双方向で、通常はネイティブからラテン文字へ、およびラテン文字からネイティブへ実行されます。
|
許容レベル AcceptanceLevel |
レコードが正常に処理されたとみなされるために達成する必要のある、最小検証レベルを指定します。このフィールドの値は、“処理後検証マッチ レベル” と呼ばれる、Address Verification Code の 2 つめの文字に対応します。
|
IsDuplicateHandlingMaskEnable |
重複処理マスクを有効にし、重複レコードの処理および削除の方法を指定します。次のオプションから 1 つ以上を選択します。
|
MinimumMatchScore |
Validate Address Loqate において、Loqate 参照データベースでマッチ結果を得るために、住所に加える変更の度合いを、0 ~ 100 の間の数値で指定します。数値が小さいほど、大きな変更が許容されます。100 の値は、パーシング後に入力住所と検証済み住所がほぼ同一であることを意味します。0 の値は、検証済み住所を得るためにパーシング後の入力住所を大きく変更してしまってもよいことを意味します。 |
KeepMultimatch |
一致する可能性のある住所を複数持つ入力住所に対して複数の住所を返すかどうかを指定します。
詳細については、複数マッチを返すを参照してください。 |
FailMultipleMatches |
一致する可能性のある住所が複数存在する入力住所に対して、複数の住所を許可しません。 |