Indicadores de resultado de nivel de registro - Spectrum_OnDemand - addressing - web_services - 23.1

Guía de servicios web de Spectrum

Product type
Portfolio
Integrate
Product family
Product
Spectrum > Web Services
Version
23.1
Language
Español (México)
Product name
Spectrum Technology Platform
Title
Guía de servicios web de Spectrum
First publish date
2007
ft:lastEdition
2024-02-07
ft:lastPublication
2024-02-07T18:09:34.894393

Los indicadores de resultado de nivel de registro brindan datos acerca de los resultados del procesamiento de Validate MailingAddressUSCAN para cada registro, como el éxito o el fracaso de un intento de cruce, qué codificador procesó la dirección y otros detalles. En la siguiente tabla, se muestran los indicadores de resultado de nivel de registro que devolvió Validate MailingAddressUSCAN.

Tabla 1. Indicadores de nivel de registro

Nombre de campo

columnName

Elemento de respuesta

Descripción

AddressFormat

Es el tipo de datos de dirección que se comparan con el formato de dirección:

F
Formato francés (por ejemplo: 123 Rue Main)
E
Formato Inglés (por ejemplo: 123 Main St)

Confidence

El nivel de confianza asignado a la dirección devuelta. El rango varía de cero (0) a 100: el cero indica una falla, y el 100 indica un grado muy alto de confianza respecto de que los resultados del cruce sean correctos. En el caso de varias coincidencias, el nivel de confianza es 0. Para obtener detalles sobre cómo se calcula este número, consulte Introducción al algoritmo de confianza de Validate Address.

CouldNotValidate

Si no se encuentra un cruce, este campo indica el componente de la dirección que no pudo validarse:

  • ApartmentNumber
  • HouseNumber
  • StreetName
  • PostalCode
  • City
  • Directional
  • StreetSuffix
  • Empresa
  • POBoxNumber
  • RuralRoute (Ruta rural)
Nota: Es posible que se devuelva más de un componente, en una lista en la que aparecen separados por comas.

CountryLevel

La categoría de cruce de dirección disponible. Para las direcciones de Estados Unidos y Canadá, la categoría es siempre "A". Una de las siguientes:

A
La dirección corresponde a un país para el que hay datos postales con alto nivel de detalles. En las direcciones de este nivel de cruce, los siguientes elementos de dirección pueden estar validados y corregidos, y agregados en caso de que falten en la entrada:
  • Código postal
  • Ciudad
  • Nombre de estado/ condado
  • Elementos de dirección de calle
  • Nombre del país
B
La dirección corresponde a un país para el que hay un nivel intermedio de datos postales disponibles. En las direcciones de este nivel de cruce, los siguientes elementos de dirección pueden estar validados y corregidos, y agregados en caso de que falten en la entrada:
  • Código postal
  • Ciudad
  • Nombre de estado/ condado
  • Nombre del país
C
La dirección corresponde a un país para el que existe el menor nivel de datos postales disponibles. En las direcciones de este nivel de cruce pueden ejecutarse las siguientes acciones:
  • Validar y corregir el nombre del país (no se puede suministrar el nombre del país si falta ese dato)
  • Validar el formato del código postal (no se puede suministrar el código postal o validar el código)

MatchScore

MatchScore (Calificación de cruce) indica el grado de corrección de la dirección de salida. Este campo es muy diferente del campo Confidence (Confianza), pues ese campo indica cuánto se modificó una dirección para obtener un cruce, mientras que el significado de los valores de MatchScore varía si las direcciones corresponden o no a Estados Unidos.

Para las direcciones de EE. UU., MatchScore representa una calificación de un dígito del 0 al 9 que refleja la proximidad del cruce del nombre de calle (después de las transformaciones realizadas en Validate MailingAddressUSCAN, si las hubiera). Un cero indica un cruce exacto, en tanto un 9 indica el cruce menos probable. Si no se encuentra un cruce, el campo queda en blanco.

Para las direcciones que no corresponden a Estados Unidos ni Canadá, MatchScore representa una calificación de cinco dígitos, con un valor máximo de 00999. Los números más altos indican un cruce más cercano.

Este campo no se aplica a las direcciones de Canadá.

No es posible establecer una equivalencia entre las calificaciones para las direcciones de Estados Unidos y las que corresponden a direcciones de otros países. Por ejemplo, una calificación 4 para una dirección de Estados Unidos no indica el mismo nivel de cruce que una calificación 00004 para una dirección que no corresponde a Estados Unidos.

Nota: Tanto los componentes de Validate Address como los del módulo Advanced Matching utilizan el campo MatchScore. El valor del campo MatchScore en la salida de un flujo de datos es determinado por la última etapa que modifica el valor antes de enviarlo a la etapa de salida Si el flujo de datos contiene componentes de Validate Address y del módulo Advanced Matching y desea ver los datos de salida del campo MatchScore para cada etapa, utilice una etapa Transformer para copiar el valor de MatchScore en otro campo. Por ejemplo, Validate Address genera un campo de salida denominado MatchScore y luego una etapa Transformer puede copiar el campo MatchScore desde Validate Address a un campo denominado AddressMatchScore. Al ejecutarse, la etapa de cruce completa el campo MatchScore con el valor proveniente de la etapa y transmite el valor del campo AddressMatchScore a través de la etapa Validate Address.

MultimatchCount

Si se encuentran múltiples cruces, este campo indica la cantidad de registros que pueden ser posibles cruces.

MultipleMatches

Si se encuentra múltiples cruces, este campo indica cuáles son los componentes de la dirección con múltiples cruces:

  • Empresa
  • LeadingDirectional (Elemento direccional anterior)
  • PostalCode
  • StreetName
  • StreetSuffix
  • TrailingDirectional (Elemento direccional posterior)
  • Urbanization (Urbanización)
Nota: Es posible que se devuelva más de un componente, en una lista en la que aparecen separados por comas.

ProbableCorrectness

Se indica la precisión de un cruce en una escala de 0 a 9. Este campo se aplica solo a las direcciones de EE. UU.

El resultado para las direcciones de EE. UU. puede ser el siguiente:
  • En blanco: no se encontró un cruce
  • 0: es más probable que el cruce sea correcto (Cruce exacto)
  • De 1 a 8: probabilidad intermedia de que el cruce sea correcto
  • 9: es menos probable que el cruce sea correcto

ProcessedBy

Indica el codificador de direcciones que procesó la dirección:

USA
Codificador de direcciones de Estados Unidos
CAN
Codificador de direcciones de Canadá
INT
Codificador de direcciones internacionales

RecordType

Tipo de registro de dirección, según la definición de las autoridades postales de Estados Unidos y Canadá (solo para direcciones de esos dos países):

  • FirmRecord
  • GeneralDelivery
  • HighRise
  • PostOfficeBox
  • RRHighwayContract
  • Normal

RecordType.Default

Código que indica el cruce "predeterminado":

Y
La dirección coincide con un registro predeterminado.
null (nulo)
La dirección no coincide con un registro predeterminado.

Status

Resultado exitoso o fallido del intento de cruce. Para múltiples cruces, el valor de este campo es "F" para todos los cruces posibles.

null (nulo)
Sin errores
F
Falla

Status.Code

Motivo de la falla, en caso de que haya una. Para múltiples cruces, todos los cruces posibles llevan el valor "MultipleMatchesFound".

  • DisabledCoder
  • InsufficientInputData
  • MultipleMatchesFound
  • UnableToValidate

Status.Description

Descripción del problema, en caso de que haya alguno.

Possible Multiple Addresses Found
Este valor aparecerá si Status.Code=MultipleMatchesFound.
Address Not Found
Este valor aparecerá si Status.Code=UnableToValidate.
PerformUSProcessing disabled
Este valor aparecerá si Status.Code=DisabledCoder.
PerformCanadianProcessing disabled
Este valor aparecerá si Status.Code=DisabledCoder.
PerformInternationalProcessing disabled
Este valor aparecerá si Status.Code=DisabledCoder.