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

optionName

Description

OutputRecordType

Type d'enregistrement de sortie. Pour plus d'un, fournir une liste.

A
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 l'adresse est validée, 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 ValidateAddress 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 incluses comme des données de passe dans les champs d'adresse, même si vous ne spécifiez pas OutputRecordType=A.
E
Éléments d'adresse analysés. 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 indiquez « E » et OutputFormattedOnFail=Y, les éléments d'adresse analysés contiennent l'adresse d'entrée des adresses qui n'ont pas pu être validées.
I
Entrée analysée. Cette option renvoie l'adresse d'entrée sous forme analysée sans tenir compte si l'adresse est validée. 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é. L'entrée analysée (valeur « I ») est différente de la combinaison OutputRecordType=E et OutputFormattedOnFail=Y en ce sens que « I » renvoie toutes les adresses d'entrée au format d'adresse analysée et non uniquement celles qui n'ont pas pu être validées. Pour plus d'informations, reportez-vous à la section Saisie analysée.
P
Données postales. Les adresses de sortie contiennent des données supplémentaires pour chaque adresse validée. Pour plus d'informations, reportez-vous à la section Sortie des données postales.
Blank
Ne renvoyer aucune donnée d'adresse ou postale.

OutputFieldLevelReturnCodes

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.

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

Remarque : Cette option ne s'applique qu'aux adresses du États-Unis et le Canada. Les données formatées ne seront pas renvoyées pour toute autre 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 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 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, indiquez OutputRecordType=I.

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 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, indiquez Option.OutputRecordType=I.

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 indiquez Y, vous devez indiquer « A » et/ou « E » pour OutputRecordType.

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

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

OutputStreetNameAlias

Pour les adresses 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.

N
Non, ne pas renvoyer les alias de nom de rue dans la sortie.
Y
Oui, renvoyer les alias de nom de rue dans la sortie s'il existe un alias pour la rue (par défaut).

OutputStreetNameAlias

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 options sont OutputPreferredAlias et OutputAbbreviatedAlias.

Remarque : Si OutputAbbreviatedAlias est activé, les alias abrégés figurent toujours en sortie, même si OutputStreetNameAlias est désactivé.
N
Non, ne pas renvoyer les alias de nom de rue dans la sortie.
Y
Oui, renvoyer les alias de nom de rue dans la sortie si le nom de rue d'entrée est un alias (par défaut).

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

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.

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

OutputAMAS

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

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.

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