Options

Le tableau suivant énumère les options qui contrôlent le type d'informations renvoyé par ValidateAddress Loqate.

Tableau 1. Options de données de sortie

optionName

Description

Database.Loqate

Spécifie la base de données que vous souhaitez utiliser pour la validation des adresses internationales. Pour spécifier une base de données pour la validation d'adresse internationale, sélectionnez une base de données dans la liste déroulante Base de données.

OutputFieldLevelReturnCodes

Spécifie s'il faut inclure les indicateurs de résultat de champ. Les indicateurs de résultat de champ décrivent comment ValidateAddressLoqate a géré chaque élément d'adresse. Les indicateurs de résultat de champ sont renvoyés dans le qualificateur « Résultat ». Par exemple, l'indicateur de résultat de champ pour HouseNumber est contenu dans HouseNumber.Result. Pour la liste complète des champs de sortie de l'indicateur de résultat, voir Indicateurs de résultat.

N
Non, ne pas sortir les codes de renvoi de champ (par défaut).
Y
Oui, sortir les codes de renvoi de champ.

OutputFormattedOnFail

Spécifie s'il faut ou non renvoyer une adresse formatée quand aucune adresse ne peut être validée. L'adresse est mise en forme selon le format d'adresse préféré pour le pays de l'adresse. Si cette option n'est pas sélectionnée, les champs d'adresse de sortie sont vides lorsque ValidateAddressLoqate ne peut pas valider l'adresse.

N
Non, ne pas mettre en forme les adresses incorrectes (par défaut).
Y
Oui, mettre en forme les adresses incorrectes.

Les adresses mises en forme sont renvoyées au format indiqué par les cases à cocher Inclure une adresse standard, Inclure les éléments de ligne d'adresse et Inclure les informations postales. Notez que si vous sélectionnez Inclure les éléments de ligne d'adresse, les éléments d'adresse analysée contiennent l'adresse analysée et validée des adresses qui ont pu être validées. Si l'adresse n'a pas pu être validée, les éléments des adresses décomposées contiendront l'adresse d'entrée sous forme décomposée. Si vous voulez que la sortie contienne toujours l'adresse d'entrée sous forme analysée, que ValidateAddressLoqate puisse valider l'adresse ou non, sélectionnez Inclure les éléments d'adresse de saisie normalisés.

Si vous cochez cette case, vous devez sélectionner Inclure une adresse standard et/ou Inclure les éléments de ligne d'adresse.

Les adresses mises en forme sont renvoyées au format indiqué par l'option OutputRecordType. Notez que si vous indiquez OutputRecordType=E, les éléments d'adresse analysée contiennent l'adresse analysée et validée des adresses qui ont pu être validées. Si l'adresse n'a pas pu être validée, les éléments des adresses décomposées contiendront l'adresse d'entrée sous forme décomposée. Si vous voulez que la sortie contienne toujours l'adresse d'entrée sous forme analysée, que ValidateAddressLoqate puisse valider l'adresse ou non, précisez OutputRecordType=I.

Si vous indiquez Y, vous devez indiquer « A » et/ou « E » pour OutputRecordType.

Les adresses mises en forme sont renvoyées au format indiqué par l'option Option.OutputRecordType. Notez que si vous indiquez Option.OutputRecordType=E, les éléments d'adresse analysée contiennent l'adresse analysée et validée des adresses qui ont pu être validées. Si l'adresse n'a pas pu être validée, les éléments des adresses décomposées contiendront l'adresse d'entrée sous forme décomposée. Si vous voulez que la sortie contienne toujours l'adresse d'entrée sous forme analysée, que ValidateAddressLoqate puisse ou non valider l'adresse, précisez Option.OutputRecordType=I.

OutputAddressBlocks

Spécifie s'il faut renvoyer une version mise en forme de l'adresse, car elle sera imprimée sur un envoi physique. Chaque ligne de l'adresse est renvoyée dans un champ de bloc d'adresse séparé. Il peut exister jusqu'à neuf champs de sortie de bloc d'adresse : AddressBlock1 à AddressBlock9.

Par exemple, cette adresse de saisie :

AddressLine1: 4200 Parliament Place
AddressLine2: Suite 600
City: Lanham
StateProvince: MD
PostalCode: 20706

Résultats dans ce résultat de bloc d'adresse :

AddressBlock1: 4200 PARLIAMENT PL STE 600
AddressBlock2: LANHAM MD 20706-1882
AddressBlock3: UNITED STATES OF AMERICA

ValidateAddress Loqate formate l'adresse en blocs d'adresse à l'aide des normes du service postal. Le nom de pays est renvoyé à l'aide du nom de pays UPU (Union postale universelle). Notez que l'option OutputCountryFormat n'affecte pas le nom de pays dans le bloc d'adresse, il n'affecte que le nom renvoyé dans le champ de sortie Country.

L'un des éléments suivants :

N
Non, ne pas renvoyer les blocs d'adresse. Par défaut.
Y
Oui, renvoyer les blocs d'adresse.

AmasFormatting

Indique que les données d'adresse de sortie doivent être mise en forme conformément aux conventions Address Matching Approval System (AMAS).

Cette option oblige Validate Address Loqate à utiliser les règles AMAS lors de la normalisation d'une adresse. AMAS est un programme d'application de normes d'adressage d'Australia Post. Pour plus d'informations sur les conventions de mise en forme AMAS, consultez le manuel Address Matching Approval System (AMAS).

Cette option modifie les données de sortie comme suit.

  • Des zéros sont ajoutés aux champs numériques. Cela affecte les champs de sortie suivants : HouseNumber, HouseNumber2, PostalDeliveryNumber et DPID. Par exemple, si l'adresse d'entrée est 298 New South Head Rd Double Bay NSW 2028, le format du champ HouseNumber passe de 298 à 00298.
  • En l'absence de correspondance, tous les chiffres du champ DPID sont des zéros. Par exemple, 00000000.
  • En l'absence de correspondance, tous les champs renvoyés (éléments d'adresse analysés) sont vierges, sauf les champs numériques, qui ne contiennent tous que des zéros.
  • Le champ CCD n'est pas renvoyé.

Les valeurs valides sont les suivantes :

N
Non, ne pas formater les données de sortie à l'aide des conventions AMAS (par défaut).
Y
Oui, formater les données de sortie à l'aide des conventions AMAS.
Remarque : Lorsque cette option est sélectionnée, les résultats sont renvoyés avec la mise en forme AMAS, quelles que soient les sélections effectuées dans les champs Niveau d'acceptation et Score de correspondance minimal.

OutputCasing

Détermine la casse des données de sortie. L'un des éléments suivants :

M
Le résultat apparaît en majuscules et en minuscules (par défaut). Par exemple :

123 Main St
Mytown FL 12345

U
Le résultat apparaît en majuscules. Par exemple :

123 MAIN ST
MYTOWN FL 12345

HomeCountry

Indique le pays par défaut. Vous devez indiquer le pays où la plupart de vos adresses se trouvent. Par exemple, si la plupart des adresses que vous traitez se trouvent en Allemagne, précisez Allemagne. ValidateAddressLoqate emploie le pays que vous indiquez pour tenter de procéder à la validation quand le programme n'est pas en mesure de déterminer le pays à partir des champs d'adresse StateProvince, PostalCode et Country. Les noms de pays valides sont :

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

Spécifie le format à utiliser pour le nom de pays renvoyé dans le champ de sortie Country. Par exemple, si vous sélectionnez Français, le nom du pays « Deutschland » serait renvoyé comme « Allemagne ».

E
Utiliser les noms de pays anglais (par défaut).
I
Utiliser l'abréviation ISO à deux lettres pour les pays au lieu des noms de pays.
U
Utiliser l'abréviation Union Postale Universelle pour les pays au lieu des noms de pays.

OutputScript

Spécifie l'alphabet ou script dans lequel la sortie doit être retournée. Cette option est bidirectionnelle et passe généralement de Natif à Latin, et de Latin à Natif.

Input
Ne procédez pas à la translittération et fournissez une sortie dans le même script en tant qu'entrée (par défaut).
Native
Sortie dans le script natif pour le pays sélectionné chaque fois que possible.
Latn
Utilisez des valeurs anglaises.
Niveau d'acceptation

AcceptanceLevel

Indique le niveau de vérification minimal qu'un enregistrement doit atteindre pour être considéré comme correctement traité. La valeur de ce champ correspond au deuxième caractère du Code de vérification d'adresse (AVC), appelé « Post-Processed Verification Match Level » (Niveau de correspondance de vérification post-traitement) :

  • 5 : Point de livraison (immeuble ou boîte postale) L'enregistrement est accepté ou présente un haut niveau de confiance si ApartmentNumber, HouseNumber, Street, City et StateProvince, fournis dans l'enregistrement d'entrée, correspondent au jeu de données de référence Loqate. Il présente un niveau de confiance modéré si ApartmentNumber est correct, mais que les autres champs restants sont incorrects ; mais, dans ce cas, le moteur Loqate devrait être capable d'identifier ApartmentNumber, car ApartmentNumber se trouve à un niveau plus granulaire. Il présente un niveau de confiance zéro si le moteur Loqate n'est pas en mesure d'analyser ApartmentNumber ni d'autres champs.
  • 4 : Établissement ou bâtiment. L'enregistrement est accepté ou présente un haut niveau de confiance si House Number, Street, City et StateProvince, fournis dans l'enregistrement d'entrée, correspondent au jeu de données de référence Loqate. Il présente un niveau de confiance modéré si HouseNumber est correct, mais que les autres champs ne le sont pas ; cependant, dans ce cas, le moteur Loqate devrait être capable d'identifier HouseNumber, car HouseNumber se trouve à un niveau plus granulaire. Il présente un niveau de confiance zéro si le moteur Loqate n'est pas en mesure d'analyser HouseNumber ni d'autres champs.
  • 3 : Voie, route ou rue. L'enregistrement est accepté ou présente un haut niveau de confiance si Street, City et StateProvince, fournis dans l'enregistrement d'entrée, correspondent au jeu de données de référence Loqate. Il présente un niveau de confiance modéré si City est correct, mais que StateProvince ne l'est pas ; cependant, dans ce cas, le moteur Loqate devrait être capable d'identifier StateProvince, car City fait partie de StateProvince. Il présente un niveau de confiance zéro si le moteur Loqate n'est pas en mesure d'analyser City ou les deux champs (City et State Province).
  • 2 : Localité (ville ou agglomération). L'enregistrement est accepté ou présente un haut niveau de confiance si City et StateProvince, fournis dans l'enregistrement d'entrée, correspondent au jeu de données de référence Loqate. Il présente un niveau de confiance modéré si City est correct, mais que StateProvince ne l'est pas ; cependant, dans ce cas, le moteur Loqate devrait être capable d'identifier StateProvince, car City fait partie de StateProvince. Il présente un niveau de confiance zéro si le moteur Loqate n'est pas en mesure d'analyser City ou les deux champs (City et StateProvince).
  • 1 : Zone administrative (état ou région). L'enregistrement est accepté ou présente un haut niveau de confiance si StateProvince, fourni dans l'enregistrement d'entrée, correspond au jeu de données de référence Loqate.
  • 0 : Aucun. Il s'agit de l'équivalent de l'option de correspondance la plus lâche.

IsDuplicateHandlingMaskEnable

Active le masque de gestion des doublons et spécifie le mode de traitement et de suppression des enregistrements doublons. Sélectionnez l'une et/ou l'autre des options suivantes :

S
Sélectionné par défaut. Pré-traite l'entrée et supprime les doublons qui se produisent dans un seul champ.
C
Sélectionné par défaut. Pré-traite l'entrée et supprime les doublons qui se produisent dans tous les champs.
T
Pré-traite l'entrée et supprime les doublons des champs qui ne sont pas des champs d'adresse standard.
F
Sélectionné par défaut. Post-traite la sortie de la vérification et supprime les doublons des champs non vérifiés.

MinimumMatchScore

Spécifie une valeur numérique comprise entre 0 et 100 qui indique le degré auquel Validate Address Loqate modifie une adresse afin d'obtenir une correspondance dans la base de données de référence Loqate. Plus le nombre est faible, plus la quantité de modifications autorisées est importante. Une valeur 100 signifie qu'après analyse, l'adresse d'entrée est presque identique à l'adresse validée. Une valeur 0 signifie que l'adresse d'entrée analysé peut être complètement modifiée afin d'obtenir une adresse validée.

KeepMultimatch

Indique s'il faut ou non renvoyer plusieurs adresses pour les adresses d'entrée qui ont plus d'une correspondance possible.

Y
Oui, renvoyer plusieurs adresses (par défaut).
N
Non, ne pas renvoyer plusieurs adresses.

Pour plus d'informations, reportez-vous à la section Renvoi de correspondances multiples.

FailMultipleMatches

Fait échouer plusieurs adresses pour les adresses d'entrée qui ont plus d'une correspondance possible.