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.
optionName |
Description |
---|---|
OutputRecordType |
Type d'enregistrement de sortie. Pour plus d'un, fournir une liste.
|
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.
|
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 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 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 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.
|
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 :
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é.
|
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 Résultats dans ce résultat de bloc d'adresse : AddressBlock1: 4200 PARLIAMENT PL STE 600 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.
|
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 Résultats dans ce résultat de bloc d'adresse : AddressBlock1: 4200 PARLIAMENT PL STE 600 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.
|