Opciones de datos de salida
La tabla a continuación muestra las opciones que controlan el tipo de información devuelta por ValidateAddress. Algunas de estas opciones pueden anularse para las direcciones de Canadá. Para obtener más información, consulteOpciones de dirección de Canadá.
Parámetro |
Descripción |
---|---|
OutputRecordType |
Tipo de registro de salida. Si son varios, debe proporcionarse una lista.
|
OutputFieldLevelReturnCodes |
Especifica si deben incluirse indicadores de resultados de nivel de campo. Los indicadores de resultados de nivel de campo describen la forma en que se manejó cada elemento de dirección. Estos indicadores se devuelven con el calificador "Result". Por ejemplo, el indicador de resultados del campo HouseNumber se encuentra en HouseNumber.Result. Para obtener una lista completa de los campos de salida de indicadores de resultados, consulte Indicadores de resultado de nivel de campo.
|
OutputFormattedOnFail |
Especifica si se devolverá una dirección con formato cuando no sea posible validar una dirección. A la dirección se le aplica el formato de dirección preferido para el país correspondiente. Si no se selecciona esta opción, los campos de dirección de salida quedarán en blanco cuando no se pueda validar la dirección. Nota: Esta opción se aplica a las direcciones de Estados Unidos y Canadá. No se devuelven datos con formato para otros tipos de direcciones.
Las direcciones con formato se devuelven con el formato que se especifica en la opción OutputRecordType Tenga en cuenta que si especifica el valor OutputRecordType=E, los elementos de dirección analizados incluirán la dirección analizada y validada de las direcciones que no pudieron validarse. Si la dirección no pudo validarse, los elementos de dirección analizados incluirán la dirección de entrada en el formato analizado. Si desea que la dirección de entrada aparezca siempre en la dirección de salida en formato analizado, independiente de si ValidateAddress pudo validarla, especifique OutputRecordType=I. Las direcciones con formato se devuelven con el formato que se especifica en la opción Option.OutputRecordType Tenga en cuenta que si especifica el valor Option.OutputRecordType=E, los elementos de dirección analizados incluirán la dirección analizada y validada de las direcciones que no pudieron validarse. Si la dirección no pudo validarse, los elementos de dirección analizados incluirán la dirección de entrada en el formato analizado. Si desea que la dirección de entrada aparezca siempre en la dirección de salida en formato analizado, independientemente de que ValidateAddress pueda validarla o no, especifique Option.OutputRecordType=I. Las direcciones con formato aplicado se devuelven en el formato especificado en las casillas Incluir una dirección estándar, Incluir elementos de línea de dirección e Incluir información postal. Si se selecciona Incluir elementos de línea de dirección, los elementos de dirección analizados incluirán la dirección analizada y validada en el caso de las direcciones que no pudieron validarse. Si la dirección no pudo validarse, los elementos de dirección analizados incluirán la dirección de entrada en el formato analizado. Si desea que la dirección de entrada aparezca siempre en la salida en formato analizado, independientemente de que ValidateAddress pueda validarla o no, seleccione Incluir elementos de dirección de entrada estandarizados. Si especifica Y, entonces debe especificar "A" o "E" para OutputRecordType. Si especifica Y, entonces debe especificar "A" o "E" para Option.OutputRecordType. Si marca esta opción, debe seleccionar Incluir una dirección estándar o Incluir elementos de línea de dirección. |
OutputStreetNameAlias |
Para para las direcciones de Estados Unidos, esta opción especifica si se usará o no el alias de las calles en la salida. Un alias de una calle es un nombre alternativo y suele aplicarse solamente a un rango específico de direcciones en esa calle. Si no se permite el uso de alias de calles en la salida, el nombre "básico" de la calle aparecerá en los datos de salida independientemente de que la calle tenga o no un alias. El nombre básico es el nombre que se aplica a toda la calle.
|
OutputStreetNameAlias |
Para para las direcciones de Estados Unidos, esta opción especifica cómo se procesarán los alias de nombres de calles utilizados en la entrada. Un alias de una calle es un nombre alternativo y suele aplicarse solamente a un rango específico de direcciones en esa calle. Si se habilita esta opción, los alias de nombres de calles utilizados en los datos de entrada aparecerán en los datos de salida. Si esta opción no se habilita, los alias de nombres de calles que aparecen en los datos de entrada se convertirán al nombre de calle básico en la salida, con las siguientes excepciones:
Esta es una de las tres opciones que controlan la forma en que ValidateAddress maneja los alias de nombres de calles. Las otras dos opciones son OutputPreferredAlias y OutputAbbreviatedAlias. Nota: Si está activada OutputAbbreviatedAlias, el alias abreviado siempre aparecerá en la salida, incluso si OutputStreetNameAlias está desactivada.
|
OutputAddressBlocks |
Especifica si se devolverá una versión de la dirección con formato aplicado tal como se imprimiría en una pieza postal física. Cada línea de la dirección se devuelve en un campo de bloque de dirección separado. Puede haber hasta nueve campos de salida del bloque de dirección: AddressBlock1 hasta AddressBlock9. Por ejemplo, para esta dirección de entrada: AddressLine1: 4200 Parliament Place Se genera este bloque de dirección de salida: AddressBlock1: 4200 PARLIAMENT PL STE 600 ValidateAddress aplica el formato a la dirección en bloques de dirección por medio de las normas de las autoridades postales. El nombre de país se devuelve con el nombre de país estipulado por la Unión Postal Universal. Tenga en cuenta que la opción OutputCountryFormat no afecta al nombre del país en el bloque de dirección, solo afecta al nombre devuelto en el campo de salida Country. Para direcciones que no corresponden a Estados Unidos ni Canadá, si ValidateAddress no puede validar la dirección, no se devuelven bloques de dirección. Para direcciones en los Estados Unidos y Canadá, se obtienen bloques de dirección incluso si falla la validación.
|
OutputAMAS |
Especifica si se devolverá una versión de la dirección con formato aplicado tal como se imprimiría en una pieza postal física. Cada línea de la dirección se devuelve en un campo de bloque de dirección separado. Puede haber hasta nueve campos de salida del bloque de dirección: AddressBlock1 hasta AddressBlock9. Por ejemplo, para esta dirección de entrada: AddressLine1: 4200 Parliament Place Se genera este bloque de dirección de salida: AddressBlock1: 4200 PARLIAMENT PL STE 600 ValidateAddress aplica el formato a la dirección en bloques de dirección por medio de las normas de las autoridades postales. El nombre de país se devuelve con el nombre de país estipulado por la Unión Postal Universal. Tenga en cuenta que la opción OutputCountryFormat no afecta al nombre del país en el bloque de dirección, solo afecta al nombre devuelto en el campo de salida Country. Para direcciones que no corresponden a Estados Unidos ni Canadá, si ValidateAddress no puede validar la dirección, no se devuelven bloques de dirección. Para direcciones en los Estados Unidos y Canadá, se obtienen bloques de dirección incluso si falla la validación.
|