FRAMEWORK 2 Recepción de SMS

Transcripción

1 FRAMEWORK 2 Versión 1.1 Área de Integración y Arquitectura de Aplicaciones

2 Hoja de Control Título Documento de Referencia Responsable FW2_MUS_Recepcion_SMS Área de Integración y Arquitectura de Aplicaciones Versión 1.1 Fecha Versión 17/11/2010 Registro de Cambios Versión Causa del Cambio Responsable del Cambio Fecha del Cambio 1.0 Versión inicial del documento Área de Integración y Arquitectura de Aplicaciones 01/11/ Actualización a nueva plantilla Área de Integración y Arquitectura de documentos de Aplicaciones 10/11/2010 Página 2 de 9

3 Índice 1. INTRODUCCIÓN AUDIENCIA OBJETIVO CONOCIMIENTOS PREVIOS DESCRIPCIÓN IMPLEMENTACIÓN DEL SERVICIO WEB DE RECEPCION DE SMS EJEMPLO DE USO...9 Página 3 de 9

4 1. INTRODUCCIÓN Este documento nos presenta como implementar el requisito de recepción de SMS por parte de los proyectos. La plataforma de envío y recepción de SMS para las aplicaciones de la Comunidad de Madrid es la plataforma MENTES de Telefónica Soluciones. 1.1 AUDIENCIA OBJETIVO Este documento va dirigido a jefes de proyecto, analistas y desarrolladores de proyectos que necesiten implementar la recepción de SMS. 1.2 CONOCIMIENTOS PREVIOS Para un completo entendimiento del documento, el lector deberá tener conocimientos previos sobre las siguientes tecnologías: Framework 2 Axis 1.4 Servicios Web Página 4 de 9

5 2 DESCRIPCIÓN La solución de recepción de SMS se basa en que el mensaje recibido incluye una palabra clave que identifica a la aplicación que va a recibir el mensaje. Una vez recibido el mensaje se invocará a un servicio web particular para cada aplicación donde será enviado el mensaje recibido para ser procesado particularmente por el servicio web. La recepción de un sms es por la plataforma MENTES en una tabla de b.d. Esta tabla se llama CIAR_RECEPCION y contiene un trigger que dispara el package de base de datos WS_PACK_MENT_0001 cada vez que llega un sms. En el modelo de datos de mentes existe también una tabla en la que se autoriza a aplicaciones a recibir SMS. A la hora de autorizar una aplicación se le indica con que palabra clave se va a acceder a dicha aplicación y la url del servicio web al que invocar cuando se recibe un mensaje. Esta autorización se realiza a través del área de paso a producción. El package se encarga de evaluar la palabra clave contenida en el sms, y buscarla en la tabla MENT_CIAR_RECEPCION (donde debe estar autorizado y registrado previamente el webservice y la palabra clave) para obtener a que webservice debe enviar el contenido del sms. Si el sms recibido viene vacío o con una palabra clave no registrada, automáticamente se envía un sms al emisor del mensaje indicándole ésta situación. El servicio web a desarrollar deben cumplir una interfaz específica tal y como se comentará en el siguiente apartado. A continuación se muestra un diagrama con el flujo de recepción de sms. Página 5 de 9

6 Página 6 de 9

7 3 IMPLEMENTACIÓN DEL SERVICIO WEB DE RECEPCION DE SMS Con objeto de agilizar el desarrollo del webservice, la Unidad de Arquitectura y Soporte de Aplicaciones ha elaborado un ejemplo que se puede descargar de En este ejemplo cada vez que se recibe un mensaje se envía un correo electrónico a las direcciones de correo definidas en el fichero de configuración. (Simplemente se trata de un ejemplo no de un caso de uso habitual en la recepción de sms) El servicio a implementar debe extender de la clase sistemas.ws.servicioweb e implementar una interfaz como ejpl_recepcionmentes_ws.interfaces.procesarrecepcionsms. A continuación se muestra un ejemplo de código de este interfaz: ProcesarRecepcionSMS.java package ejpl_recepcionmentes_ws.interfaces; import java.rmi.remoteexception; * Interfaz ProcesarRecepcionSMS * icm public abstract interface ProcesarRecepcionSMS { * Método procesar recepcion * texto texto del sms torigen teléfono de origen tdestino teléfono de destino fecharecepcion fecha de recepción horarecepcion hora de recepción mensaje confirmación RemoteException the remote exception String procesarrecepcion(string texto, String torigen, String tdestino, String fecharecepcion, String horarecepcion) throws RemoteException; La implementación de dicha interfaz obliga a implementar el siguiente método. Método a implementar String procesarrecepcion(string texto, String torigen, String tdestino, String fecharecepcion, String horarecepcion) Página 7 de 9

8 Dentro de este método se debe implementar la lógica particular a realizar cuando se recibe un sms. La descripción de los parámetros que recibe dicho método es la siguiente: Parámetro Descripción Texto torigen tdestino fecharecepcion horarecepcion Contenido del SMS recibido Número de teléfono que ha enviado el SMS Número de teléfono donde se ha enviado el SMS (será el número corto asignado a ICM por parte de Telefónica) Fecha de recepción del SMS Hora de recepción del SMS A continuación se muestra un ejemplo de la implementación del método procesarrecepcion. ServicioRecepcionSMS.java package ejpl_recepcionmentes_ws.servicio; import * Servicio que envia un por cada sms que recibe el sistema MenTes. * icm public class ServicioRecepcionSMS extends ServicioWeb implements ProcesarRecepcionSMS { * Constructor de la clase. Carga el fichero de configuracion. public ServicioRecepcionSMS() { super("ejpl_recepcionmentes_ws.conf"); Trazas.permiso(Config.getConfig()); * Procesar recepcion * texto texto del sms torigen teléfono origen tdestino teléfono destino fecharecepcion fecha recepción horarecepcion hora recepción Página 8 de 9

9 mensaje confirmacion java.rmi.remoteexception * RemoteException the remote exception public String procesarrecepcion(string texto, String torigen, String tdestino, String fecharecepcion, String horarecepcion) throws RemoteException { MensajeCorreo msjcorreo = null; try { msjcorreo = new MensajeCorreo(); catch (Throwable t) { Trazas.imprimeErrorExtendido(t); throw new RemoteException("ERROR", t); msjcorreo.setasunto(config.get("correo.asunto")); msjcorreo.setfrom(config.get("correo.from")); msjcorreo.setpara(config.get("correo.to")); Trazas.impLog(Config.get("correo.to").toString()); String mensaje = "Texto del mensaje: " + texto + "\n" + "Tel origen: " + torigen + "\n" + "Tel destino: " + tdestino + "\n" + "Fecha recepcion: " + fecharecepcion + "\n" + "Hora recepcion: " + horarecepcion; try { msjcorreo.enviarmensaje(mensaje); catch (CorreoException cex) { Trazas.imprimeErrorExtendido(cex); Trazas.impLog("CorreoException: " + cex.getmessage()); catch (Exception ex) { Trazas.imprimeErrorExtendido(ex); Trazas.impLog("Exception: " + ex.getmessage()); return " enviado"; 3.1 EJEMPLO DE USO El webservice de ejemplo de recepción de SMS está disponible en la web de soja en el apartado Framework 2/Ejemplos (ejpl_recepcionmentes_ws) Página 9 de 9