Options de données de sortie

Le tableau suivant énumère les options qui contrôlent le type d'informations renvoyé par ValidateAddress. Certaines de ces options peuvent être remplacées pour les adresses canadiennes. Pour plus d'informations, reportez-vous à la section Options pour adresse canadienne.

Tableau 1. Options de données de sortie

Option

Description

Inclure une adresse standard

Renvoie 1 à 4 lignes de données d'adresse plus les informations de ville, d'état, de code postal, de nom de société et de nom d'urbanisation. Chaque ligne d'adresse représente une ligne réelle de l'adresse comme elle apparaîtrait sur une enveloppe. Pour plus d'informations, reportez-vous à la section Réponse.

Si Validate Address peut valider l'adresse, les lignes d'adresse contiennent l'adresse normalisée. Lorsque les adresses sont normalisées, la ponctuation est supprimée, les points cardinaux sont abrégés, les suffixes de rue sont abrégés, et les éléments d'adresse sont corrigés.

Si Validate Address n'a pas pu valider l'adresse, la ligne d'adresse contient l'adresse telle qu'elle apparaît en sortie (« données d'intercommunication »). Les adresses non-validées sont toujours inclues comme des données de passe dans les champs d'adresse même si vous décochez cette option.

Inclure les éléments d'adresse en correspondance

Chaque partie de l'adresse, telle que le numéro de maison, le nom de rue, le suffixe de rue, les nombres cardinaux, etc. est renvoyée dans un champ séparé. Pour plus d'informations, reportez-vous à la section Sortie d'éléments d'adresses analysés. Notez que si vous sélectionnez cette option et que vous sélectionnez également Renvoyer des données normalisées si aucune correspondance n'existe, les éléments d'adresse contiendront l'adresse d'entrée pour les adresses qui n'ont pas pu être validées.

Inclure les informations postales

Les adresses de sortie contiennent des données supplémentaires variées pour chaque adresse validée. Pour plus d'informations, reportez-vous à la section Sortie des données postales.

Inclure les éléments d'adresse d'entrée normalisés

Cette option renvoie l'adresse d'entrée sous forme analysée sans prendre en compte si Validate Address est capable ou non de valider l'adresse. Chaque partie de l'adresse d'entrée, telle que le numéro de maison, le nom de rue, le suffixe de rue, les nombres cardinaux, etc. est renvoyée dans un champ séparé.

La sélection de cette option est différente de la sélection de la combinaison Inclure les éléments d'adresse en correspondance/Renvoyer des données normalisées si aucune correspondance n'existe en ce sens que Renvoyer les éléments d'adresse de saisie normalisés renvoie toutes les adresses d'entrée sous forme analysée, pas seulement l'entrée qui n'a pas pu être validée. Pour plus d'informations, reportez-vous à la section Saisie analysée.

Inclure des codes de résultat pour les champs individuels

Spécifie s'il faut inclure les indicateurs de résultat de champ. Indicateurs de résultat de champ décrivent la manière dont chaque élément d'adresse a été traité. 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 de champ.

Renvoyer des données normalisées lorsqu'aucune correspondance n'est trouvée

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 vierges lorsque Validate Address ne peut pas valider l'adresse.

Remarque : Cette option ne s'applique que pour les adresses américaines et canadiennes. Les données formatées ne seront pas renvoyées pour toute autre adresse.

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 souhaitez que la sortie contienne toujours l'adresse d'entrée au format d'adresse analysée, que ValidateAddress puisse ou non valider l'adresse, 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.

Renvoyer l'alias de nom de rue

Pour les adresses américaines, uniquement, indique s'il faut ou non utiliser les alias d'une rue en sortie. Un alias de rue est un autre nom pour une rue qui s'applique généralement à une plage précise d'adresses dans la rue. Si vous ne permettez pas les alias de rue dans la sortie alors le nom de rue de base apparaîtra dans la sortie qu'il soit un alias de rue ou non. Le nom de base est le nom qui s'applique à toute la rue.

Renvoyer l'alias de nom de rue

Pour les adresses américaines uniquement, spécifie comment gérer les alias de nom de rue utilisés dans l'entrée. Un alias de rue est un autre nom pour une rue qui s'applique généralement à une plage précise d'adresses dans la rue.

Si vous activez cette option, les alias de nom de rue utilisés dans l'entrée apparaitront dans la sortie. Si vous n'activez pas cette option, les alias de nom de rue dans l'entrée seront convertis en nom de rue de base dans la sortie, avec les exceptions suivantes :

  • Si un alias préféré est utilisé dans l'entrée, l'alias préféré sera toujours utilisé dans la sortie.
  • Les alias ​​modifiés utilisés dans l'entrée sont toujours convertis en nom de rue de base dans la sortie.

Il s'agit de l'une des trois options qui contrôlent la façon dont ValidateAddress gère les alias de nom de rue. Les deux autres sont Traitement des alias de nom de rue préférés et Traitement des alias de nom de rue abrégés.

Remarque : Si Traitement des alias de nom de rue abrégés est activé, les alias abrégés figurent toujours en sortie, même si Renvoyer l'alias du nom de rue est désactivé.

Renvoyer des blocs de données d'adresse

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 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 Country Format 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.

Pour les adresses en dehors des États-Unis et du Canada, si ValidateAddress n'est pas en mesure de valider l'adresse, aucun bloc d'adresse n'est renvoyé. Pour les adresses aux États-Unis et au Canada, les blocs d'adresse sont renvoyés, même en cas d'échec de validation.

Formater les données à l'aide des conventions AMAS

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 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 Country Format 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.

Pour les adresses en dehors des États-Unis et du Canada, si ValidateAddress n'est pas en mesure de valider l'adresse, aucun bloc d'adresse n'est renvoyé. Pour les adresses aux États-Unis et au Canada, les blocs d'adresse sont renvoyés, même en cas d'échec de validation.