Cómo se transmiten los datos a un servicio

El siguiente diagrama ilustra cómo se transfieren los datos a un servicio a través de la API:

Mensaje

Utilice el componente Message para enviar sus datos de entrada al Spectrum™ Technology Platform servicio y recibir datos de salida desde el servicio.

También puede utilizar el componente Message para anular las opciones de procesamiento predeterminadas de un servicio. Las opciones predeterminadas para un servicio se establecen en Management Console. Por ejemplo, el servicio ValidateAddress tiene la capacidad de producir datos de salida en mayúscula y minúscula, o bien, en solo en mayúscula. En la mayoría de los casos, se necesitan datos en mayúscula. No obstante, supongamos que una de sus aplicaciones requiere datos en mayúscula y minúscula. En esta situación, puede configurar el uso de mayúsculas como opción predeterminada en el servicio ValidateAddress y anular la configuración predeterminada solo para esa aplicación utilizando la API. Para las solicitudes que se deben procesar de acuerdo con los valores predeterminados que haya especificado, no es necesario proporcionar opciones de entrada en la solicitud.

Las propiedades de Message incluyen propiedades de contexto tales como ID de cuenta, contraseña de cuenta, nombre de servicio y método de servicio; propiedades de opciones, que son las opciones de ejecución específicas de cada servicio, y propiedades de error, que son las clases de errores, los mensajes de error y el seguimiento de errores.

DataTable

El componente DataTable (Tabla de datos) contiene los registros para los datos de entrada y salida. Por medio de los métodos correspondientes a esta clase, usted puede definir los nombres de columna para los datos de salida y agregar registros al conjunto de datos. Los métodos Reset y Next ("restablecimiento" y "siguiente") se usan para iterar en los resultados que se devuelven en una respuesta del servidor.

DataRow

El componente DataRow (Fila de datos) contiene información de esquema y una lista de filas de datos. Los registros individuales residen en filas de datos. Para cada fila de datos de salida hay calificadores de nivel de registro, datos de nivel de campo y calificadores de nivel de campo.

Los calificadores de nivel de registro describen el procesamiento del registro. Los calificadores de nivel de registro incluyen el estado de la solicitud (éxito, falla o error) y la confianza en la exactitud del registro de salida.

Los datos de nivel de campo contienen el registro validado, estandarizado o mejorado.

Los calificadores de nivel de campo incluyen datos adicionales acerca de un campo determinado. Por ejemplo, un tipo de buzón de correo privado, de conformidad con la categorización de USPS, es un calificador de nivel de campo.

Servidor

El componente Servidor representa al servidor de Spectrum™ Technology Platform. Este componente permite conectarse, desconectarse o acceder a un servicio específico desde el servidor.

Servicios

El componente Servicio se utiliza para procesar el mensaje que se envía (enviar el mensaje de entrada y obtener la respuesta). El componente Servicio utiliza un solo método: procesar mensajes.