Framework 2 Manual de usuario del Servicio de envío de SMS
Contents
1. RECHAZADO El xml de env o se debe componer de acuerdo al siguiente esquema envio xsd P gina 23 de 38 via Agencia de kA dk C Inform tica y Comunicaciones lt xs schema xmins xs http www w3 org 2001 XMLSchema elementFormDefault qualified gt lt xs element name MENSAJE type xs string gt lt xs element name PETICION gt lt xs complexType gt lt XS Sequence gt lt xs element ref SMS maxOccurs unbounded gt lt xs sequence gt lt xs complexType gt lt xs element gt lt xs element name SMS gt lt xs complexType gt lt XS Sequence gt lt xs element ref MENSAJE gt lt xs element ref TELEFONO maxOccurs unbounded gt lt xs sequence gt lt xs attribute name confirmacion type xs byte use optional default 0 gt lt xs attribute name entregaDiferida type xs string use optional gt lt xs attribute name expiracion type xs byte use optional default 0 gt lt xs attribute name telOrigen type xs string use required gt lt xs attribute name lunes type xs byte use optional default 1 gt lt xs attribute name martes type xs byte use optional default 1 gt lt xs attribute name miercoles type xs byte use optional default 1 gt lt xs attribute name jueves type xs byte use optional default 1 gt lt xs attribute name viernes type xs byte use optional default 1 gt lt xs attribute name sabado type xs byte us2. Te Inform tica y Comunicaciones de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS 2 DESCRIPCI N El servicio de env o de sms incluye las siguientes funcionalidades Envi de 1 a n mensajes de texto a 1 o varios n meros de tel fono Env o en el momento de la solicitud Hay que tener en cuenta que el servicio web encola las peticiones en la plataforma mentes por lo que si hay varias peticiones concurrentes los mensajes no son enviados en el mismo momento Env o en diferido a una fecha hora en concreto Env o dentro de una ventana de tiempo tanto dentro de determinadas horas como de determinados d as Tiempo de expiraci n del mensaje en caso de que no se pueda enviar Confirmaci n de env o solamente con algunos operadores Consulta de mensajes enviados O O O O El servicio de env o de sms se ha implementado en un servicio web llamado mentes_ws Este servicio web se comunica con la plataforma MenTeS de Telef nica Soluciones que en realidad es la encargada de la transmisi n de los mensajes a los m viles A 4 aa Tan a A MUA A A SH rn Py Aplicaci n 2 WebService MENTES_WS Producto MenTeS La interfaz que define el servicio web se encuentra en el fichero mentes_ws wsdl y se llama ServicioSMSMentes Las aplicaciones que necesiten acceder a este servicio web deber n crear un cliente de este servicio web partiendo del fichero mentes _ws wsdl P gina 5 de 38
3. sms setExpiracion 1 sms setMensaje request getParameter MENSAJE sms setTelefonos telefonos mensajes 0 sms EnvioSMS envio new EnvioSMS URL_SERVICIO try return envio enviaSMSSimples TEST mensajes catch Exception e throw new AccionException e getMessage P gina 9 de 38 Ada Agencia de Framework 2 Inform tica y Comunicaciones de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS C 3 1 CLASES DE PARAMETROS TIPO OBJETOS 3 1 1 SmsSimpleBean Objeto con los datos b sicos para el env o de un sms Par metro Descripci n aplicaci n Nombre de la aplicaci n que realiza el env o Esta aplicaci n debe ser previamente autorizada para poder enviar sms confirmacion 1 si se quiere confirmaci n y 0 si no se quiere confirmaci n No todos los operadores ofrecen confirmaci n entregaDiferida Instante en el que se va a enviar el mensaje String AAAAMMDDHHMM En blanco si se desea enviar al instante expiracion Tiempo de validez del mensaje en horas de 0 a 23 Si en el tiempo indicado no se ha entregado el mensaje al destinatario entonces no se va a enviar Cuando el par metro expiraci n tiene valor tendr un tiempo de vida m ximo de una semana 168 horas idPeticion Identificador de petici n No hace falta rellenarlo Long para enviar la petici n Texto del mensaje a enviar telOrigen Tel fono que env a el sms 217035 telefonos Li
4. de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS ListaEnviosBean ConsultaEnvios EnvioBean envio Par metros de entrada Par metro Descripci n Tipo Obligatorio envio Fecha c digo de EnvioBean aplicaci n Numero de mensajes solicitados y enviados Retorno ListaEnviosBean Excepciones Exception en el caso de producirse alg n error Ejemplo de uso Par metros de entrada EnvioBean Par metro Descripci n aplicaci n AlAA 20 09 2011 nm_mensajes_sol Retorno ListaEnviosBean 5 6 EnviaMensajes M todo deprecated se mantiene por compatibilidad con los clientes del webservice ssms_ws RespuestaBean EnviaMensajes SmsBean mensajesSMS String aplicacion Par metros de entrada P gina 36 de 38 Ada Agencia de Framework 2 Te Inform tica y Comunicaciones de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS Par metro Descripci n Tipo Obligatorio mensajesSMS Array de Mensajes a enviar SmsBean Aplicaci n C digo de la aplicaci n RespuestaBean Retorno En la clase RespuestaBean devuelve un c digo de error 1 en los mismos casos que en el m todo enviaSMSSimples comentado en el punto 2 1 ya que utiliza el mismo m todo para enviar previa transformaci n de los objetos SmsBean a SmsSimpleBean Excepciones Exception en el caso de producirse alg n error Ejemplo de uso Par metros de entr
5. lt xml version 1 0 encoding UTF 8 gt lt consultaPeticion idPeticion 1408 gt lt confirmados gt 2 lt confirmados gt lt encolados gt 0 lt encolados gt lt pendientes gt 0 lt pendientes gt lt consultaPeticion gt 3 2 METODOS CON PARAMETRO TIPO STRING QUE CONTIENE UN XML 3 2 1 enviaForms Env o de SMS utilizando xml como par metros de entrada salida P gina 26 de 38 de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS Aida Agencia de Framework 2 Te Inform tica y Comunicaciones l E de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS String enviaForms String aplicacion String mensajes Par metros de entrada Par metro Descripci n Tipo Obligatorio aplicacion C digo de la aplicaci n que String solicita los sms mensajes XML donde se definen los String Schema sms que se desean enviar envio xsd Retorno String Un identificador de petici n para poder realizar consultas sobre el estado del envio Excepciones Exception en el caso de producirse alg n error XmlException en el caso de que el formato del XML no sea correcto Ejemplo de uso Par metros de entrada Aplicaci n AlAA Mensajes lt PETICION gt lt SMS confirmacion 0 expiracion 0 telOrigen 217035 lunes 1 martes 1 miercoles 1 jueves 1 viernes 1 sabado 1 domingo 1 horalnicio 00 00 horaFin 23 59 gt lt MENSAJE gt prueba de envioXml
6. PARAMETROS DEPRECADOS 5 1 EnvioBean Bean que se rellena en la consulta ConsultaEnvios por la aplicaci n y la fecha de env o Par metro Descripci n nm_mensajes_env N mero de mensajes enviados P gina 34 de 38 A Agencia de Framework 2 C Inform tica y Comunicaciones o de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS nm_mensajes_sol N mero de mensajes solicitados i aplicacion C digo del tipo de aplicaci n Fecha de env o de los sms 5 2 ListaEnviosBean Lista de Bean del tipo EnvioBean que se devuelve en la consulta ConsultaEnvios realizadas por aplicaci n o por aplicaci n y fecha Par metro Descripci n Array de EnvioBean EnvioBean 5 3 RespuestaBean Bean que devuelve el n mero de SMS enviados y una lista que puede contener el c digo del error o el identificador de petici n Par metro Descripci n numEnviados N mero de mensajes enviados int errores Puede almacenar tanto 1 si es un error o el String identificador de petici n para poder realizar consultas sobre el estado del env o 5 4 SmsBean Bean que se usa para el env o de SMS Par metro Descripci n Tipo Contenido del mensaje String Lista de tel fonos Stringi 5 5 ConsultaEnvios M todo deprecated se mantiene por compatibilidad con los clientes del webservice ssms_ws P gina 35 de 38 TERI Agencia de Framework 2 k x e e Te Inform tica y Comunicaciones
7. RS kk C Agencia de Inform tica y Comunicaciones de la Comunidad de Madrid Framework 2 Manual de Usuario del Servicio de Env o de SMS A continuaci n se muestra un diagrama de clases del servicio web class servicio LA E A Servicio Web ServicioSMSMenTes consultaDetallePeticion String String RespuestaDetalleXMLBean ConsultaEnvios EnvioBean ListaEnviosBean consultaPeticion String ConsultaPeticionBean consultaPeticionForms String String consultaSMSxml String String RespuestaDetalleXMLBean consultaSMSxml String String String String RespuestaDetalleXMLBean enviaForms String String String EnviaMensajes SmsBean String RespuestaBean enviarXML String boolean enviaSMS SmsSimpleBean I String long enviaSMS SmsSimpleBean String String String long enviaSMSDetallados SmsDetalladoBean String String enviaSMSDetallados SmsDetalladoBean String String String String enviaSMSSimples SmsSimpleBeanI String String enviaSMSSimples SmsSimpleBean String String String String enviaSMSxml String String String String String guardaXML String boolean insertarRegistro SmsSimpleBeanI String Connection long insertarRegistro SmsSimpleBean String Connection String String long ServicioSMSMenTex tratarTelefonos String String validarT elOrigen SmsSimpleBean boolean sistemas framework beans ModeloBean fava io Seria
8. String consultaPeticionForms String idPeticion Par metros de entrada Par metro Descripci n Obligatorio idPeticion Identificador de la petici n de envio Obtenido de cualquiera de los tres metodos de envio Retorno String XML con la respuesta de la consulta Schema consulta xsd Excepciones Exception en el caso de producirse un error Ejemplo de uso Par metros de entrada idPeticion 1408 Retorno lt xml version 1 0 encoding UTF 8 gt lt consultaPeticion idPeticion 1408 gt lt confirmados gt 2 lt confirmados gt lt encolados gt 0 lt encolados gt lt pendientes gt 0 lt pendientes gt lt consultaPeticion gt 3 2 4 consultaDetallePeticionForms M todo de consulta devuelve la situaci n detallada de cada uno de los SMS solicitados para una petici n concreta y una aplicaci n concreta en formato xml String consultaDetallePeticionForms String idPeticion String aplicacion Par metros de entrada P gina 29 de 38 Ada Agencia de Framework 2 Te Inform tica y Comunicaciones l o de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS Par metro Descripci n i Obligatorio idPeticion Identificador de la petici n de env o aplicacion C digo de la aplicaci n que solicita los sms Retorno String que contiene un xml con los datos de la petici n Excepciones Exception en el caso de producirse un error Ejemplo de uso P
9. X Discusiones 3 Ey J7 a W Discusiones no disponibles en http Idesarrollo madrid org o El Listo Y sitios de confianza E madrid org Comunidad de Madrid Microsoft Internet Explorer proporcionado por Comunidad de Madrid bag ax Archivo Edici n Yer Favoritos Herramientas Ayuda Qe bs gt D bu Hz i A JA WB Y Q Atr s gd E A A B squeda Favoritos as SS El 5 ol Direcci n l http desarrollo madrid org ment_web_consulta htmi web MuestraListadoCiaEnwio icr Ir V nculos a v M Nombre del Centro Directivo Correspondiente Nombre de la Consejeria Correspondiente T tulo de la aplicaci n en una l nea de texto como m ximo E oi co turas Inicio gt Ho ome Cerrar x Consulta CIA_ENVIO Lista de Envios Consulta Cl4_RESULTADO T _ ID PETICION TDESTMO ONG TEKTO FECHAN EXPIRACION TIPO CABECERA ENVIADO CONFIRMACION EITRECADFERIDA C mENSAJE 37547 38149 654456654 7035 DE 27 11 2009 1 0 1 PRUEBAS tEXTO DE 37548 38150 655555552 7035 27 11 2009 1 0 1 PRUEBAS 2 A u A Humero total de registros 2 1 vo O MADRID COMUNIDAD DIGITAL Copyright Comunidad de Madrid Aviso Legal Privacidad Contacto Accesibilidad X Discusiones Y A Ey 3 gt J ES Discusiones no disponibles en http f desarrollo madrid org 9 El Listo Y sitios de confianza Nota En el caso de que se desee filtrar por varios campos estos se separan como el formato de SQL AND OR etc 5 METODOS Y
10. del cliente de la String aplicaci n que realiza el env o tipoServicio Identificador de tipo de servicio String de la aplicaci n que realiza el env o Retorno String Un identificador de petici n para poder realizar consultas sobre el estado del env o Excepciones Exception en el caso de producirse alg n error 3 2 3 consultaPeticion Consulta el estado de confirmaci n de los sms de una petici n ConsultaPeticionBean consultaPeticion String idPeticion Par metros de entrada P gina 17 de 38 kk e ER C Agencia de Framework 2 Inform tica y Comunicaciones o de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS Par metro Descripci n Obligatorio idPeticion Identificador de la petici n de envio Obtenido de cualquiera de los tres metodos de envio Retorno ConsultaPeticionBean Numero de sms confirmados encolados o pendientes Excepciones Exception En el caso de producirse alguna excepci n Ejemplo de uso Par metros de entrada IdPeticion 1408 Retorno ConsultaPeticionBean Par metro Descripci n IdPeticion 1408 pendientes 3 2 1 consultaDetallePeticion Consulta la situaci n detallada de cada uno de los SMS solicitados para una petici n concreta RespuestaDetalleXMLBean consultaDetallePeticion String idPeticion String aplicacion Par metros de entrada Par metro Descripci n Obligatorio idP
11. env o Devuelve un c digo de petici n para su posterior consulta Este m todo est sobrescrito por lo que es posible invocarlo de las formas siguiente dependiendo de los par metros de entrada String enviaSMSSimples SmsSimpleBean mensajesSMS String aplicacion Par metros de entrada Par metro Descripci n Tipo Obligatorio mensajesSMS Array de mensajes a enviar SmsSimpleBeanT solicita los sms aplicaci n C digo de la aplicaci n que String Retorno String Un identificador de petici n para poder realizar consultas sobre el estado del envio Excepciones Exception en el caso de producirse alg n error Ejemplo de uso Par metros de entrada mensajesSMS Par metro Descripci n aplicaci n ATAA confirmacion mensaje Prueba AR P gina 14 de 38 TERI Agencia de Framework 2 ee Inform tica y Comunicaciones o de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS telefonos XXXXXXXXX Aplicaci n AlAA Retorno 1407 Identificador de petici n para poder realizar consultas sobre el estado del envio Se genera un identificador distinto para cada petici n Nota El c digo de aplicaci n AAA es un c digo de pruebas En producci n este c digo no existe y cada aplicaci n debe solicitar su propio c digo de aplicaci n String enviaSMSSimples SmsSimpleBean mensajesSMS String aplicaci n String cliente String tipoS
12. lt MENSAJE gt lt TELEFONO gt XXXXXXXXX lt TELEFONO gt lt SMS gt lt SMS confirmacion 1 expiracion 0 telOrigen 217035 lunes 1 martes 1 miercoles 1 jueves 1 viernes 1 sabado 1 domingo 1 horalnicio 00 00 horaFin 23 59 gt lt MENSAJE gt Segunda prueba envio xml lt MENSAJE gt lt TELEFONO gt XXXXXXXXX lt TELEFONO gt lt SMS gt lt PETICION gt Retorno 1409 Identificador de petici n para poder realizar consultas sobre el estado del envio Se genera un identificador distinto para cada petici n 3 2 2 enviaSMSxml Env o de SMS utilizando xml como par metros de entrada salida String enviaSMSxml String aplicacion String mensajes String cliente String tipoServicio P gina 27 de 38 ERES Agencia de Framework 2 XA ok Ea e e Te Inform tica y Comunicaciones de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS Par metros de entrada Par metro Descripci n Tipo Obligatorio aplicacion C digo de la aplicaci n que String SI solicita los sms mensajes XML donde se definen los String Schema SI sms que se desean enviar envio xsd cliente Identificador del cliente de String SI la aplicaci n que realiza el env o tipoServicio Identificador de tipo de String SI servicio de la aplicaci n que realiza el env o Retorno String Un identificador de petici n para poder realizar consultas sobre el estado del envio Excepciones Excepti
13. readOnly ConsultaPeticionBean getConfirmados String getEncolados String getldPeticion String getPendientes String setConfirmados String void setEncolados String void setldPeticion String void setPendientes String void toString String clase int domingo int horaFin java lang String horalnicio java lang String jueves int lunes int martes int miercoles int sabado int serialVersionUID long 1L readOnly viernes int getClase int getDomingo int java io Serializable beans SmsDetalladoBean ModeloBean beans RespuestaDetalleXMLBean eConfirma String estadoResultadodEnvio String fCambioEstado String fechaResultadodEnvio String fechaSolicitadoEnvio String horaResultadoEnvio String idPeticion String serial VersionUID long 1L freadOnly tDestino String texto String getEstadoResultadodEnvio String getFechaResultadodEnvio String getFechaSolicitadoEnvio String getHoraResultadoEnvio String getldPeticion String getTexto String RespuestaDetalleXMLBean setEstadoResultadodEnvio String void setFechaResultadodEnvio String void setFechaSolicitadoEnvio String void setHoraResultadoEnvio String void setldPeticion String void setTexto String void n de de es E property get geteConfirma String get CambioEstado String gettDestino String property se
14. E ENEE AEEA NEEE EERENS 1 3 1 4 Consulta Detalle MEDIA esca 12 3 1 5 RespuestaDetalleXml Bean oooooonnnnnnnnnnnnonnncnnnnnnnonononnnnnonnnn nono nnnnr rn non nn nn n rn nn nn nn nn nr nro nn nn nn nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnananinnnns 12 3 2 METODOS CON PARAMETRO TIPO OBJETO ooocoocnncnncnncnncnncnnononocnocnnonncononnonnoo nono non nor no nnr nono nro non nor nr nor nor nr nana nncnnnnnss 14 de ISS SAA PP 14 3 2 2 PAAU TINI KI DIATONA TOTA LONO 15 3 2 3 CONSORCIO A EE A EE EE EEE E REEN 17 3 2 1 consultaDetallePeticion ooooonoonncnncnnoninncnonanannn nn osts tresoreres tse os eser erereene esos osesesosesessneoenensene 18 3 2 2 consultaDetallePeticionTime ooo nana anne rre nar nan nenannnnnss 19 3 2 3 consula SMSA areire aea eE NEEE A EEEN E EEEE EEEE EOE EE EEEN 20 Sl ESQUEMAS PARA LOS FICHEROS XM Lost aisla adas 23 3 1 1 A a A E 23 EA a a aaea E e dea AU 25 3 2 METODOS CON PARAMETRO TIPO STRING QUE CONTIENE UN XML 0cooooccccnnnnnccncnononincnnnnacnnnnonnnccnnnnnncccnnnnonos 26 3 2 1 A a A 26 3 2 2 US id T E ETETETT 27 J2 Cona are e OR OTS een a E 29 3 2 4 consultaDealleP Ena is 29 323 COSTES ESO a E A dic ieititaeos 30 3 2 6 CONSTA MS AO a cid otitanda 31 A URLODEACCESOAL SERVICIO NED cas 33 Ai D ARE A A A E 33 5 METODOS Y PARAMETROS DEPRECADOS sesecsesecscsececscscseocccsesecccsesccseseoccsessesesecsoeoscseseosesesecsesesecscsesesesesesesceseseoses 34 l A O o o E S 34 2 LSTAENVIOS BEA Noia t
15. Framework 2 Manual de usuario del Servicio de env o de SMS Versi n 1 0 rea de Aplicaciones Especiales y Arquitectura de Software ASAS REE A Agencia de Inform tica y Comunicaciones de la Comunidad de Madrid AER Agencia de Framework 2 C Inform tica y Comunicaciones o de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS Hoja de Control T tulo Framework 2 Servicio de env o de SMS Documento de Referencia Responsable rea de Aplicaciones Especiales y Arquitectura de Software Versi n 1 0 Fecha Versi n Versi n Registro de Cambios Versi n Causa del Cambio Responsable del Cambio Fecha del Cambio Area de Aplicaciones Especiales y Versi n inicial del documento Arquitectura de Software rea de Arquitectura de Aplicaciones 14 04 2015 Inclusi n de nuevos m todos en la interfaz del servicio P gina 2 de 38 A Agencia de Framework 2 C Inform tica y Comunicaciones o f de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS Contenido E INTRO CON a 4 LE AUN CA o das cidos 4 2 ECEONOCIMIENTOS PREVIO Saa oia atea 4 IO O O 5 ESE A Sa S 3 USO DE LA LIBRER A MENT _LIB seeseseesessesessesessoseesessosessosesecseoseseososeseossessosessoseososeoneseossoseseesosessoseososeoneseoresseseosesseroses 9 Sl ELASES DE PARAMETROS TIPO OBTETOS a ceads 10 3 1 1 UA A PP A 10 3 1 2 ta A TE AETA 10 3 1 3 Consula P encionb edi eesin n NENEA E
16. a envio lt MENSAJE gt lt TELEFONO gt XXXXXXXXX lt TELEFONO gt lt SMS gt lt PETICION gt 3 1 2 XML de consulta El xml de consulta que nos devuelve en el m todo consultaPeticionForms es de acuerdo al siguiente esquema consulta xsd P gina 25 de 38 AA Agencia de Framework 2 C Inform tica y Comunicaciones lt xml version 1 0 encoding UTF 8 gt lt xs schema xmlins xs http www w3 0rg 2001 XMLSchema elementFormDefault qualified gt lt xs element name confirmados type xs int gt lt xs annotation gt lt xs documentation gt N mero de sms confirmados lt xs documentation gt lt xs annotation gt lt xs element gt lt xs element name encolados type xs int gt lt xs annotation gt lt xs documentation gt N mero de sms encolados lt xs documentation gt lt xs annotation gt lt xs element gt lt xs element name pendientes type xs int gt lt xs annotation gt lt xs documentation gt N mero de sms pendientes lt xs documentation gt lt xs annotation gt lt xs element gt lt xs element name consultaPeticion gt lt xs complexType mixed true gt lt xs sequence gt lt xs element ref confirmados gt lt xs element ref encolados gt lt xs element ref pendientes gt lt xs sequence gt lt xs attribute name idPeticion type xs short use required gt lt xs complexType gt lt xs element gt lt xs schema gt Ejemplo de XML de respuesta de la consulta
17. ada SmSBean 0 Par metro Descripci n mensaje Esto es una prueba Telefonos 0 666666660 Retorno RespuestaBean Par metro Descripci n erroresj0 21078 6 PREGUNTAS M S FRECUENTES En este apartado se incluyen una lista de preguntas m s frecuentes sobre el servicio Pregunta Estoy probando el servicio web contra el entorno de desarrollo y no recibo ning n mensaje Respuesta El entorno de desarrollo se llega a realizar el env o de mensajes P gina 37 de 38 Ada Agencia de Framework 2 Te Inform tica y Comunicaciones l o de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS Pregunta Al invocar al servicio web me dice la aplicaci n XXXX no est autorizada Respuesta Para poder acceder al servicio web es necesario solicitar previamente un c digo de aplicaci n P gina 38 de 38
18. ada uno de los SMS solicitados en una fecha concreta para una aplicaci n centro y servicio Par metros de entrada Par metro Descripci n Tipo Obligatorio aplicacion C digo de la aplicaci n que String SI solicita los sms fechaEnvio Fecha en la que se ha producido String SI el env o tipoServicio Identificador de tipo de servicio String SI de la aplicaci n que realiza el env o codCentro Identificador del cliente de la String SI aplicaci n que realiza el env o Retorno RespuestaDetalleXMLBean Array de RespuestaDetalleXMLBean que contienen el detalle de los SMS solicitados para la petici n concreta Excepciones Exception En el caso de producirse alguna excepci n Ejemplo de uso Par metros de entrada aplicacion AlAA fechaEnvio 08 07 2011 kk kk xk xk P gina 22 de 38 A Agencia de C Inform tica y Comunicaciones de la Comunidad de Madrid tipoServicio tipoServicio codCentro cliente Retorno Framework 2 Manual de Usuario del Servicio de Env o de SMS RespuestaDetalleXMLBean Donde cada RespuestaDetalleXMLBean tendr los siguientes campos Par metro Descripci n fechaSolicitadoEnvio fechaResultadodEnvio horaResultadoEnvio fCambioEstado estadoResultadodEnvio eConfirma 3 1 ESQUEMAS PARA LOS FICHEROS XML 3 1 1 XML de env o 08 07 2011 11 10 2011 13 20 06 11 10 2011 Envio Correcto
19. ar metros de entrada idPeticion oy aplicaci n AlAA Retorno lt respuestaDetalle gt lt sms gt lt correcto gt false lt correcto gt lt eConfirma gt null lt eConfirma gt lt estadoResultadodEnvio gt Telefono erroneo lt estadoResultadodEnvio gt lt fCambioEstado gt 11 10 2011 lt fCambioEstado gt lt ftechaResultadodEnvio gt 11 10 2011 lt fechaResultadodEnvio gt lt fechaSolicitadoEnvio gt 14 06 2011 lt fechaSolicitadoEnvio gt lt horaResultadoEnvio gt 13 20 06 lt horaResultadoEnvio gt lt idPeticion gt 20 lt idPeticion gt lt tDestino gt 61X XXXXXX lt iDestino gt lt texto gt Envio especificando 21 7035 lt texto gt lt sms gt lt respuestaDetalle gt 3 2 5 consultaSMSxmlForms Consulta la situaci n detallada de cada uno de los SMS solicitados en una fecha concreta String consultaSMSxmlForms String aplicacion String fechaEnvio Par metros de entrada Par metro Descripci n i Obligatorio C digo de aplicaci n Fecha de Env o de los sms Retorno String xml que contienen el detalle de los SMS solicitados para la petici n concreta Excepciones Exception en el caso de producirse un error us im P gina 30 de 38 Ara Agencia de o Framework 2 Te Inform tica y Comunicaciones de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS Ejemplo de uso Par metros de entrada aplicacion AlAA fechaEnvio 27 10 2011 Retorno lt
20. del cliente que solicita el env o String opcional cdTipoServicio C digo del tipo de servicio opcional String horalnicio Hora de inicio de la ventana horaria a la que se String van a enviar los sms Formato hh mm 24 horas horaFin Hora de fin de la ventana horaria a la que se van String a enviar los sms Formato hh mm 24 horas lunes 1 indica que se puede enviar en ese d a y 0 int indica que no martes 1 indica que se puede enviar en ese d a y 0 int indica que no miercoles 1 indica que se puede enviar en ese d a y 0 int indica que no jueves 1 indica que se puede enviar en ese d a y 0 int indica que no viernes 1 indica que se puede enviar en ese d a y 0 int indica que no sabado 1 indica que se puede enviar en ese d a y 0 int indica que no domingo 1 indica que se puede enviar en ese d a y 0 int indica que no 3 1 3 ConsultaPeticionBean Objeto que se rellena con la informaci n de resumen del estado de un env o P gina 11 de 38 Framework 2 de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS A Agencia de Framework 2 Inform tica y Comunicaciones C Par metro Descripci n Tipo Identificador de la petici n String N mero de sms confirmados por el operador String encolados N mero de sms enviados al operador pero que String se desconoce su estado ya que hay operadores que no env an confirmaci n Por ejemplo Vodafone pendientes N mero de sms pendien
21. doBean enviar aplicaci n C digo de la aplicaci n que solicita los sms String Un identificador de petici n para poder realizar consultas sobre el estado del env o Retorno Excepciones Exception en el caso de producirse alg n error Ejemplo de uso Par metros de entrada MensajesSMS Par metro Descripci n aplicaci n ATAA confirmacion telefonos XXXXXXXXX horalnicio 09 00 miercoles AR P gina 16 de 38 pd Agencia de o Framework 2 Te Inform tica y Comunicaciones l o de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS viernes sabado domingo Aplicaci n AIAA Retorno 1408 Identificador de petici n para poder realizar consultas sobre el estado del envio Se genera un identificador distinto para cada petici n String enviaSMSDetallados SmsDetalladoBean mensajesSMS String aplicaci n String cliente String tipoServicio Se incluye la posibilidad de llamada a enviaSMSDetallados con dos nuevos campos cliente y tipoServicio pensados para aquellos aplicativos que desean organizar sus env os en base a quienes son los clientes de los mismos y o el tipo de servicio que utilizan Par metros de entrada Par metro Descripci n Tipo Obligatorio mensajesSMS Mensajes sms que se desea SmsDetalladoBean SI enviar aplicaci n C digo de la aplicaci n que String solicita los sms cliente Identificador
22. drid Par metro idPeticion Descripci n Framework 2 Manual de Usuario del Servicio de Env o de SMS Obligatorio Identificador de la petici n de envio Obtenido de cualquiera de los tres metodos de envio aplicacion solicita los sms Retorno C digo de la aplicaci n que RespuestaDetalleXxMLBean Array de RespuestaDetallexMLBean que contienen el detalle de los SMS solicitados para la petici n concreta Excepciones Exception En el caso de producirse alguna excepci n Ejemplo de uso Par metros de entrada idPeticion 1408 aplicacion AlAA Retorno RespuestaDetalleXMLBean Donde cada RespuestaDetalleXMLBean tendr los siguientes campos Par metro idPeticion tDestino texto fechaSolicitadoEnvio fechaResultadodEnvio horaResultadoEnvio fCambioEstado estadoResultadodEnvio eConfirma 3 2 3 consultaSMSxml Descripci n 1408 6XXXXXXXX Mensaje enviado 08 07 2011 09 07 2011 09 00 09 07 2011 10 10 10 Envio Correcto CONFIRMADO Consulta la situaci n detallada de cada uno de los SMS solicitados en una fecha concreta para una aplicaci n o aplicaci n centro y servicio TR xk im P gina 20 de 38 TERI Agencia de Framework 2 kk xk nas e e Te Inform tica y Comunicaciones de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS Este m todo es p
23. e optional default 1 gt lt xs attribute name domingo type xs byte use optional default 1 gt lt xs attribute name horalnicio type xs string use optional default 00 00 gt lt xs attribute name horaFin type xs string use optional default 23 59 gt lt xs complexType gt lt xs element gt lt xs element name TELEFONO gt lt xs simple Type gt lt xs restriction base xs string gt lt xs minLength value 9 gt lt xs maxLength value 9 gt lt xs restriction gt lt xs simple Type gt lt xs element gt lt xs schema gt Ejemplo de XML de env o P gina 24 de 38 Framework 2 de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS ERES Agencia de Framework 2 kA Ak Las e e Te Inform tica y Comunicaciones de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS lt xml version 1 0 encoding UTF 8 gt lt PETICION gt lt SMS confirmacion 0 expiracion 0 telOrigen 217035 lunes 1 martes 1 miercoles 1 jueves 1 viernes 1 sabado 1 domingo 1 horalnicio 00 00 horaFin 23 59 gt lt MENSAJE gt prueba de envio lt MENSAJE gt lt TELEFONO gt XXXXXXXXX lt TELEFONO gt lt TELEFONO gt XXXXXXXXX lt TELEFONO gt lt SMS gt lt SMS confirmacion 1 expiracion 0 telOrigen 217035 lunes 1 martes 1 miercoles 1 jueves 1 viernes 1 sabado 1 domingo 1 horalnicio 00 00 horaFin 23 59 gt lt MENSAJE gt Segunda prueb
24. echaEnvio 08 07 2011 tipoServicio tipoServicio codCentro cliente Retorno lt respuestaDetalle gt lt sms gt lt correcto gt false lt correcto gt lt eConfirma gt CONFIRMADO lt eConfirma gt lt estadoResultadodEnvio gt Envio Correcto lt estadoResultadodEnvio gt lt fCambioEstado gt 11 10 2011 lt fCambioEstado gt lt fechaResultadodEnvio gt 11 10 2011 lt fechaResultadodEnvio gt lt fechaSolicitadoEnvio gt 08 07 2011 lt fechaSolicitadoEnvio gt lt horaResultadoEnvio gt 13 20 06 lt horaResultadoEnvio gt lt idPeticion gt 80 lt idPeticion gt lt tDestino gt 636 959744 lt iDestino gt lt texto gt Pruebas Env o XXXXX realizado lt texto gt lt sms gt lt respuestaDetalle gt P gina 32 de 38 pd Agencia de o Framework 2 Te Inform tica y Comunicaciones o de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS 4 URL DE ACCESO AL SERVICIO WEB La url de acceso al servicio web depende del entorno en el que estemos trabajando 4 1 Desarrollo En el entorno de desarrollo la url del servicio es la siguiente htip deswebservices madrid org mentes ws En el entorno de desarrollo no se realiza el env o de sms real sino que simplemente se introduce el mensaje enviado en una tabla de Oracle Para comprobar que los mensajes se han escrito en la tabla de Oracle existe una aplicaci n en el entorno de desarrollo que nos permite hacer una consulta sobre dicha tabla La url de la aplicac
25. ervicio Se incluye la posibilidad de llamada a enviaSMSSimple con dos nuevos campos cliente y tipoServicio pensados para aquellos aplicativos que desean organizar sus env os en base a quienes son los clientes de los mismos y o el tipo de servicio que utilizan Par metros de entrada Obligatorio S S Par metro Descripci n Tipo mensajesSMS Array de mensajes a enviar SmsSimpleBean aplicaci n C digo de la aplicaci n que String solicita los sms cliente Identificador del cliente de la String S aplicaci n que realiza el env o tipoServicio Identificador de tipo de servicio String S de la aplicaci n que realiza el env o Retorno String Un identificador de petici n para poder realizar consultas sobre el estado del envio Excepciones Exception en el caso de producirse alg n error 3 2 2 enviaSMSDetallados Env a los mensajes SMS que recibe en el SmsDetalladoBean en la ventana de tiempo indicada en el objeto Este m todo est sobrescrito por lo que es posible invocarlo de las formas siguiente dependiendo de los par metros de entrada P gina 15 de 38 Aida Agencia de Framework 2 Te Inform tica y Comunicaciones l E de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS String enviaSMSDetallados SmsDetalladoBean mensajesSMS String aplicaci n Par metros de entrada Par metro Descripci n Obligatorio mensajesSMS Mensajes sms que se desea SmsDetalla
26. eticion Identificador de la petici n de envio Obtenido de cualquiera de los tres metodos de envio P gina 18 de 38 Ada Agencia de Framework 2 Te Inform tica y Comunicaciones l E de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS aplicacion C digo de la aplicaci n que String solicita los sms Retorno RespuestaDetalleXxMLBean Array de RespuestaDetalleXMLBean que contienen el detalle de los SMS solicitados para la petici n concreta E Excepciones Exception En el caso de producirse alguna excepci n Ejemplo de uso Par metros de entrada IdPeticion 1408 aplicacion AlAA Retorno RespuestaDetalleXMLBean Donde cada RespuestaDetalleXMLBean tendr los siguientes campos Par metro Descripci n tDestino GXXXXXXXX texto Mensaje enviado fechaSolicitadoEnvio 08 07 2011 fechaResultadodEnvio horaResultadoEnvio 09 00 fCambioEstado 09 07 2011 estadoResultadodEnvio Envio Correcto eConfirma CONFIRMADO 3 2 2 consultaDetallePeticionTime Consulta la situaci n detallada de cada uno de los SMS solicitados para una petici n concreta Este m todo devuelve la fecha de cambio incluyendo horas minutos y segundos RespuestaDetalleXMLBean consultaDetallePeticion String idPeticion String aplicacion Par metros de entrada P gina 19 de 38 A Agencia de C Inform tica y Comunicaciones de la Comunidad de Ma
27. i n de consulta de entradas de mensajes en desarrollo es httpo desarrollo madrid org ment web consulta Accediendo a esta url nos pedir usuario y password y debemos introducir ADMON ADMON A continuaci n nos aparece la siguiente pantalla el madrid org Comunidad de Madrid Microsoft Internet Explorer proporcionado por Comunidad de Madrid SAXI Archivo Edici n Yer Favoritos Herramientas Ayuda A Q m s gt 2 O z B squeda 5 2 Favoritos Eu ga M7 ES Pal Direcci n http desarrollo madrid org ment_web_consulta html webfindex htm ESTADO_MENU 0 v Ir vinculos a ds Nombre del Centro Directivo Correspondiente Nombre de la Consejer a Correspondiente M T tulo de la aplicaci n en una l nea de texto como m ximo E rousse s iais E Lerrar Consulta ClA_ENVIO Consulta tablas MenTes Consulta Cl4_RESULTADO c IcM 2008 E X Discusiones 7 aA E g g tJ gt Discusiones no disponibles en http fdesarrollo madrid org o E Listo sitios de confianza Pulsando sobre la opci n Consulta CIA_ENVIO nos sale un formulario que nos permite introducir el c digo de aplicaci n que tenemos asignado y filtrar por lo campos que nos interese para localizar los mensajes enviados Como ayuda se presenta a la derecha la lista de los campos de la tabla A continuaci n se muestra un ejemplo de consulta AS im P gina 33 de 38 Agencia de Framework 2 Inform tica y Comunicaciones de la C
28. i n detallada de cada uno de los SMS solicitados para una petici n concreta y una aplicaci n concreta en formato xml consultaSMSxmlForms M todo de consulta devuelve la situaci n detallada de cada uno de los SMS solicitados en una fecha concreta para una aplicaci n en formato xml consultaSMSxmlForms M todo de consulta devuelve la situaci n detallada de cada uno de los SMS solicitados en una fecha concreta para una aplicaci n centro y servicio en formato xml Es necesario que las aplicaciones se identifiquen en el servicio web con un c digo nico de aplicaci n que permita el obtener estad sticas de uso por parte de las aplicaciones Es necesario por lo tanto solicitar a ICM este c digo de aplicaci n antes de la puesta en producci n del aplicativo Se ha desarrollado una librer a para que las aplicaciones Java no tengan que crear cada vez el cliente del servicio AS in P gina 8 de 38 pt Agencia de o Framework 2 Te Inform tica y Comunicaciones l o de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS web Esta librer a se llama ment_lib En el caso de que la aplicaci n sea con otro lenguaje distinto de java ser la aplicaci n la encargada de crear el cliente del servicio web a partir del wsdl 3 USO DE LA LIBRER A MENT_LIB La librer a ment_lib incluye la clase EnvioSMS que incluye los mismos m todos y par metros del Servicio SMSMentes ya descrito anteriormente por lo tan
29. lizable beans SmsSimpleBean aplicacion String cdCliente java lang String cdTipoServicio java lang String confirmacion int entregaDiferida java lang String enviado int expiracion int idPeticion long mensaje java lang String serialVersionUID long 1L readOnly telefonos java lang String telOrigen java lang String y de de ze de 5 E T y 5 i n 7 y 5 de de F 5 getAplicacion String getCdCliente java lang String getCdTipoSemvicio java lang String getConfirmacion int getEntregaDiferida java lang String getEnviado int getExpiracion int getldPeticion long getMensaje java lang String getTelefonos java lang String getTelOrigen java lang String setAplicacion String void setCdCliente java lang String void setCdTipoServicio java lang String void setConfirmacion int void setEntregaDiferida java lang String void setEnviado int void setExpiracion int void setldPeticion long void setMensaje java lang String void setTelefonos java lang Stringl void setTelOrigen java lang String void SmsSimpleBean SmsSimpleBean int java lang String int java lang String java lang String java lang String toString String ModeloBean beans ConsultaPeticionBean A de e a i n ds i i confirmados String encolados String idPeticion String pendientes String serialVersionUID long 1L
30. odita aE ie 35 do ARESPUESTABE Norton ici ended lo E Ta 35 Mk OMSBEAN conmocionado EAE lidia 35 Sd CONSULTA ENVIOS vado io a 35 MO ENVIA NIENS AE eea EIEE ATEEN EE EEEE i diia 36 6 PREGUNTAS MAS FRECUENTES cion iasdn 37 kk kk XK x k P gina 3 de 38 Ada Agencia de Framework 2 Inform tica y Comunicaciones de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS C 1 INTRODUCCI N Para que las aplicaciones de la Comunidad de Madrid puedan enviar SMS se ha desarrollado un servicio web que ser invocado desde las aplicaciones que necesiten implementar este requisito De esta forma toda la complejidad del env o de SMS queda encapsulada en una llamada a un servicio web Dentro del framework 2 se ha incluido una librer a que es una librer a cliente de estos servicios web de forma que las aplicaciones del framework 2 que necesiten enviar sms deber n utilizar esta librer a La librer a se llama ment_lib y se encuentra publicada en la web de soja en el apartado Framework 2 1 1 AUDIENCIA OBJETIVO Este documento est orientado a aquellos desarrolladores de aplicaciones con el framework 2 que requieran implementar env o de sms en sus aplicaciones 1 2 CONOCIMIENTOS PREVIOS Para un completo entendimiento del documento el lector deber tener conocimientos previos sobre las siguientes tecnolog as e Servicios Web e WSDL e Java P gina 4 de 38 TERI Agencia de Framework 2 x z
31. omunidad de Madrid Manual de Usuario del Servicio de Env o de SMS madrid org Comunidad de Madrid Microsoft Internet Explorer proporcionado por Comunidad de Madrid Archivo Edici n Yer Favoritos Herramientas Ayuda w Q Atr s v O 2 CA O B squeda Hz Favoritos gt 2 w LA ES gt Fol wj q A i LS Sa Direcci n E http desarrollo madrid orgfment_web_consulta htrljweb ConsultaCiaEnvio icm ESTADO_MENU 1 x Ir v nculos EY M Nombre del Centro Directivo Correspondiente Nombre de la Consejer a Correspondiente ES T tulo de la aplicaci n en una l nea de texto como m ximo E ocios en toro Inicio gt Home Cerrar o gt Consulta CIA_ENVIO Consulta Tabla MENT_CIA_ENVIO Consulta Cl4_RESULTADO ID NUMBER c ICM 2008 Introduzca el c digo de la aplicaci n ana x IDPETICION NUMBER T_DESTINO VARCHAR2 100 Introduzca par metros clausula where TORANEN NARRAR AL TEXTO VARCHAR2 160 l FECHAENVIO VARCHAR2 12 FECHAENVIO 2 7 11 2009 EXPIRACION VARCHAR2 3 TIPO VARCHAR2 12 CABECERA VARCHAR2 10 ENVIADO NUMBER CONFIRMACION NUMBER 3 ENTREGADIFERIDA VARCHAR2 12 CD_APLICACION VARCHAR2 20 CLASE NUMBER LUNES NUMBER MARTES NUMBER MIERCOLES NUMBER JUEVES NUMBER VIERNES NUMBER SABADO NUMBER DOMINGO NUMBER HORAINICIO VARCHAR2 5 HORAFIN VARCHAR2 5 wa tea MADRID COMUNIDAD DIGITAL Copyright Comunidad de Madrid Aviso Legal Privacidad Contacto Accesibilidad p
32. on en el caso de producirse alg n error XmlException en el caso de que el formato del XML no sea correcto Ejemplo de uso Par metros de entrada Aplicaci n AlAA Cliente Sanidad tipoServicio HospPAsturias Mensajes lt PETICION gt lt SMS confirmacion 0 expiracion 0 telOrigen 217035 lunes 1 martes 1 miercoles 1 jueves 1 viernes 1 sabado 1 domingo 1 horalnicio 00 00 horaFin 23 59 gt lt MENSAJE gt prueba de envioXml lt MENSAJE gt lt TELEFONO gt XXXXXXXXX lt TELEFONO gt lt SMS gt lt SMS confirmacion 1 expiracion 0 telOrigen 217035 lunes 1 martes 1 miercoles 1 jueves 1 viernes 1 sabado 1 domingo 1 horalnicio 00 00 horaFin 23 59 gt lt MENSAJE gt Segunda prueba envio xml lt MENSAJE gt lt TELEFONO gt XXXXXXXXX lt TELEFONO gt lt SMS gt lt PETICION gt Retorno 1409 Identificador de petici n para poder realizar consultas sobre el estado del envio Se genera un identificador distinto para cada petici n BRA k o ms P gina 28 de 38 x ERES Agencia de Framework 2 k x z e e Te Inform tica y Comunicaciones de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS 3 2 3 consultaPeticionForms M todo de consulta de estado de una petici n Devuelve un string con el estado de los SMS solicitados con el siguiente formato C n confirmados P n pendientes E n encolados
33. os para el env o de sms m s los datos de la ventana de tiempo Objeto que se rellena con los datos del estado de un env o Objeto que se que se rellena con una lista de objetos del tipo EnvioBean Objeto que devuelve la situaci n detallada de los SMS solicitados Objeto que se rellena con el c digo de aplicaci n tipo de servicio y cliente as como la fecha de envio Xml que contiene una solicitud de env o de sms de acuerdo al esquema envio xsd Xml que contiene la informaci n del estado de una petici n de env o de acuerdo al esquema consulta xsd La siguiente tabla muestra la lista de m todos que ofrece el servicio web M todos con par metros de tipo objeto M todos Descripci n Env o de SMS de manera simplificada sin opciones de ventana de env o Devuelve un c digo de petici n para su posterior consulta enviaSMSSimples enviaSMSDetallados Env o de SMS con opciones de ventana de env o Devuelve un c digo de petici n para su posterior consulta consultaPeticion M todo de consulta de estado de una petici n Devuelve un objeto de tipo ConsultaPeticionBean con el estado de los SMS solicitados consultaDetallePeticion M todo de consulta de la situaci n detallada de cada uno de los SMS solicitados para una petici n concreta consultaDetallePeticionTime M todo de consulta de la situaci n detallada de cada uno de los SMS solicitados para una petici n concreta este m todo incl
34. osible invocarlo con diferente n mero de par metros RespuestaDetalleXMLBean consultaSMSxml String aplicacion String fechaEnvio Consulta la situaci n detallada de cada uno de los SMS solicitados en una fecha concreta para una aplicaci n Par metros de entrada Par metro Descripci n Obligatorio aplicacion C digo de la aplicaci n que solicita los sms fechaEnvio Fecha en la que se ha producido String el env o Retorno RespuestaDetalleXMLBean Array de RespuestaDetalleXMLBean que contienen el detalle de los SMS solicitados para la petici n concreta Excepciones Exception En el caso de producirse alguna excepci n Ejemplo de uso Par metros de entrada aplicacion AlAA fechaEnvio 14 06 2011 Retorno RespuestaDetalleXMLBean Donde cada RespuestaDetalleXMLBean tendr los siguientes campos Par metro Descripci n idPeticion tDestino 6XXXXXXXX pe fechaSolicitadoEnvio fechaResultadodEnvio AS P gina 21 de 38 pd Agencia de o Framework 2 Te Inform tica y Comunicaciones de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS horaResultadoEnvio 12 00 CambioEstado 14 06 2011 estadoResultadodEnvio Tel fono err neo eConfirma RECHAZADO RespuestaDetalleXMLBean consultaSMSxml String aplicacion String fechaEnvio String tipoServicio String codCentro Consulta la situaci n detallada de c
35. respuestaDetalle gt lt sms gt lt correcto gt false lt correcto gt lt eConfirma gt null lt eConfirma gt lt estadoResultadodEnvio gt Envio Correcto lt estadoResultadodEnvio gt lt fCambioEstado gt 27 10 2011 lt fCambioEstado gt lt fechaResultadodEnvio gt 27 10 2011 lt fechaResultadodEnvio gt lt fechaSolicitadoEnvio gt 27 10 2011 lt fechaSolicitadoEnvio gt lt horaResultadoEnvio gt 11 50 45 lt horaResultadoEnvio gt lt idPeticion gt 21072 lt idPeticion gt lt tDestino gt 654927559 lt tDestino gt lt texto gt PRUEBA DEL SERVICIO DESDE HRC lt texto gt lt sms gt lt sms gt lt correcto gt false lt correcto gt lt eConfirma gt null lt eConfirma gt lt estadoResultadodEnvio gt Envio Correcto lt estadoResultadodEnvio gt lt CambioEstado gt 27 10 2011 lt fCambioEstado gt lt fechaResultadodEnvio gt 27 10 2011 lt fechaResultadodEnvio gt lt fechaSolicitadoEnvio gt 27 10 2011 lt fechaSolicitadoEnvio gt lt horaResultadoEnvio gt 12 01 47 lt horaResultadoEnvio gt lt idPeticion gt 21073 lt idPeticion gt lt tDestino gt 654927559 lt tDestino gt lt texto gt PRUEBA3 DEL SERVICIO DESDE HRC lt texto gt lt sms gt lt sms gt lt correcto gt false lt correcto gt lt eConfirma gt null lt eConfirma gt lt estadoResultadodEnvio gt Envio Correcto lt estadoResultadodEnvio gt lt fCambioEstado gt 27 10 2011 lt fCambioEstado gt lt fechaResultadodEnvio gt 27 10 2011 lt fechaResultadodEnvio gt lt fechaSolicitadoEnvio gt 27 10 2011 lt fechaSolici
36. sta con los tel fonos a los que hay que enviar String el mensaje cdCliente C digo del cliente que solicita el env o opcional cdTipoServicio C digo del tipo de servicio opcional 3 1 2 SmsDetalladoBean Objeto con los datos b sicos para el env o de un sms m s los datos de la ventana de tiempo Hereda de SmsSimpleBean por lo tanto tambi n tiene los atributos de este objeto Par metro Descripci n aplicaci n Nombre de la aplicaci n que realiza el env o Esta aplicaci n debe ser previamente autorizada para poder enviar sms confirmacion 1 si se quiere confirmaci n y O si no se quiere confirmaci n No todos los operadores ofrecen confirmaci n P gina 10 de 38 A Agencia de C Inform tica y Comunicaciones entregaDiferida Instante en el que se va a enviar el mensaje String AAAAMMDDHHMM En blanco si se desea enviar al instante expiracion Tiempo de validez del mensaje en horas de Qa int 23 Si en el tiempo indicado no se ha entregado el mensaje al destinatario entonces no se va a enviar Cuando el par metro expiraci n tiene valor tendr un tiempo de vida m ximo de una semana 168 horas idPeticion Identificador de petici n No hace falta rellenarlo Long para enviar la petici n Texto del mensaje a enviar String telOrigen Tel fono que env a el sms 217035 String telefonos Lista con los tel fonos a los que hay que enviar String el mensaje cdCliente C digo
37. t seteConfirma String void set CambioEstado String void settDestino String void HH getHoraFin java lang String getHoralnicio java lang String getJueves int getLunegs int getMartes int getMiercoles int getSabado int getViemnes int setClase int void setDomingo int void setHoraFin java lang String void setHoralnicio java lang String void setJueves int void setLunes int void setMartes int void setMiercoles int void setSabado int void setViernes int void SmsDetalladoBean SmasDetalladoBean int int java lang String java lang String int int int int int int La forma de pasar par metros a los m todos del servicio puede ser de dos formas o Mediante objetos o En formato XML En atributos de tipo String A continuaci n se muestra los distintos objetos que se van a utilizar como par metros de los m todos del servicio ServiciosMSMentes P gina 6 de 38 A Agencia de Framework 2 C Inform tica y Comunicaciones Objeto de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS Descripci n SmsSimpleBean SmsDetalladoBean ConsultaPeticionBean ListaEnviosBean RespuestaDetalleXMLBean ConsultaDetalleXMLBean XML de env o String XML de consulta String Objeto con los datos b sicos de una solicitud de env o de sms Objeto con los datos b sic
38. tadoEnvio gt lt horaResultadoEnvio gt 16 49 45 lt horaResultadoEnvio gt lt idPeticion gt 21078 lt idPeticion gt lt tDestino gt 666666660 lt tDestino gt lt texto gt Este texto contiene la longitud exacta de 480 caracteres 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 lt texto gt lt sms gt lt respuestaDetalle gt 3 2 6 consultaSMSxmlForms Consulta la situaci n detallada de cada uno de los SMS solicitados en una fecha concreta para una aplicaci n centro y servicio String consultaSMSxmlForms String aplicacion String fechaEnvio String tipoServicio String codCentro Par metros de entrada Par metro Descripci n Tipo Obligatorio Retorno String xml que contienen el detalle de los SMS solicitados para la petici n concreta Excepciones us ijem P gina 31 de 38 da a Agencia de Framework 2 Inform tica y Comunicaciones l o de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS C Exception en el caso de producirse un error Ejemplo de uso Par metros de entrada aplicacion AlAA f
39. tes de enviar al String operador 3 1 4 ConsultaDetalleXMLBean Bean que se utiliza como par metro para realizar consultas seg n los par metros de abajo Par metro Descripci n Tipo 3 1 5 RespuestaDetalleXmlBean Bean que devuelve la situaci n detallada de los SMS solicitados Par metro Descripci n tDestino Tel fono de destino String texto Texto del mensaje String idPeticion Identificador de petici n String fechaSolicitadoEnvio Fecha de solicitud de env o String fechaResultadoEnvio Fecha de env o String horaResultadoEnvio Hora de env o String P gina 12 de 38 de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS pd Agencia de o Framework 2 Te Inform tica y Comunicaciones l o de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS estadoResultadoEnvio Estado del env o Correcto Tel fono err neo y String Error indefinido xxxx donde xxxx es el c digo de error eConfirma Estado de la confirmaci n del env o Rechazado Confirmado Pendiente confirmar Expirado y no confirmable fCambioEstado Fecha en la que se realiz el cambio de estado P gina 13 de 38 Ada Agencia de Framework 2 Te Inform tica y Comunicaciones l E de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS 3 2 METODOS CON PARAMETRO TIPO OBJETO 3 2 1 enviaSMSSimples Env o de SMS de manera simplificada sin opciones de ventana de
40. to no se vuelven a describir estos m todos class ment_lib J urlServicio String consultaDetallePeticion String String RespuestaDetalleXMLBean consultaPeticion String ConsultaPeticionBean consultaPeticionXML String String consultaSMSxml String String RespuestaDetalleXMLBean consultaSMSxml String String String String RespuestaDetalleXMLBean enviaSMSDetallados String SmsDetalladoBeanlT String enviaSMSDetallados String SmsDetalladoBean String String String enviaSMSSimples String SmsSimpleBeanT String enviaSMSSimples String SmsSimpleBean String String String enviaXML String String String enviaXML String String String String String EnvioSMS ava lang String getUrlServicio String setUrlServicio String void 4 n pe A Para utilizar esta clase es necesario pasarle en el contructor la url del servicio web tal y como se puede ver en el ejemplo que se incluye a continuaci n private String URL_SERVICIO Config get ejpl_clientementes_web ws sms private String enviaSimples throws AccionException SmsSimpleBean mensajes new SmsSimpleBean 1 SmsSimpleBean sms new SmsSimpleBean String telefonos new String 1 telefonos 0 request getParameter TELEFONO sms setAplicacion request getParameter APLICACION sms setConfirmacion Integer parselnt request qgetParameter CONFIRMACION
41. uye la informaci n de horas minutos y segundos en la fecha de cambio de estado M todo de consulta de la situaci n detallada de cada uno de los SMS solicitados en una fecha concreta para una aplicaci n o aplicaci n centro y servicio P gina 7 de 38 pd Agencia de o Framework 2 Te Inform tica y Comunicaciones de la Comunidad de Madrid Manual de Usuario del Servicio de Env o de SMS ConsultaEnvios M todo deprecated se mantiene por compatibilidad con los clientes del webservice ssms_ws Consulta por fecha aplicaci n n mero de mensajes solicitados y n mero de mensajes enviados Devuelve un objeto del tipo ListaEnviosBean EnviaMensajes M todo deprecated se mantiene por compatibilidad con los clientes del webservice ssms_ws Envia mensajes Devuelve un objeto del tipo RespuestaBean con el numero de mensajes enviados sus c digos de petici n para posteriores consultas en caso de error con el c digo de error M todos con par metros enviaForms Env o de sms en el que la petici n tipo xml viene definida en un xml enviaSMSxml Env o de sms en el que la petici n viene definida en un xml Con par metros centro y tipo de servicio consultaPeticionForms M todo de consulta de estado de una petici n Devuelve un string con el estado de los SMS solicitados con el siguiente formato C nf confirmados P n2 pendientes E n encolados consultaDetallePeticionForms M todo de consulta devuelve la situac
Download Pdf Manuals
Related Search