La clase dms_class.php

La clase class_dms.asp, le permite integrar un su página Web el envío de mensajes SMS a teléfonos móviles. La clase tiene las propiedades y funciones necesarias para poder llevar a cabo está labor.

¿Como llamar a la Clase?

Incluiremos en nuestro código una llamada a la clase:

<!--#include file="PATH\class_dms.asp"-->

Siendo PATH, el directorio donde se encuentre la clase class_dms.php

Para crear una instancia de la clase, lo haremos de la siguiente forma:

set sms = new dms_send

En este caso el objeto sms, tendrá todas la propiedades necesarias para realizar el envío.

Métodos y funciones de la Clase

Métodos y Funciones de la Clase

Métodos

• mailError; en caso de un error, la clase nos enviará un mail a la cuenta que especifiquemos en este campo, indicandonos este hecho. Dejelo vacio si no requiere de estas notificaciones.
• MaxSizeMessage; Es el tamaño máximo del mensaje que la clase va a manejar. Dejelo a Cero para no limitar el tamaño del mensaje.
• autentificacion; Le permite configurar los datos de su cuenta y obtenr información de está.
• mensajes; Este método le permite agregar los mensajes a enviar por SMS y tras ser enviado, revisar su estado.

Método Autentificacion

Este método, a su vez tiene los siguientes sub métodos:

• username; donde le especificaremos el nombre de usuario de la cuenta en Descom con la que deseamos enviar los SMS.
• autentificacion; es la contraseña de la cuenta con la que realizaremos el envío.
• saldo; trás enviar los mensajes u obtener el saldo, en esta propiedad podremos ver el saldo actual de la cuenta.
• error; Una variable Booleana que nos devolverá si la cuenta a autenticado o no en la plataforma de envíos de SMS.
• mensajeerror; En caso de error, este campo nos devuelve la descripción del error.

Método Mensajes

Este método, nos permite agregar los mensajes en el envío y su posterior analisis de los resultados acarecidos.

Para agregar un mensaje, empleramos la siguiente función del método mensajes:

mensaje.add key, destino, mensaje, remitente

Esta es la explicación de los argumento de está función:

• key; debe ser una clave única que nosotros asignemos, en cada envío solo podrá haber una única clave para cada mensaje.
• destino;Teléfono destino con formato internacional "0034666555888"
• mensajes; Texto del mensaje que deseamos enviar.
• remitente; nos permite definir el remitente del mensaje, dejelo vación si quiere que aparezca el predeterminado. más información.

Una vez enviemos los mensajes, si deseamos ver el resultado del envío de cada mensajes, llamaremos a la función mensajes.enviados.

Está función nos retornará una matriz con todos los mensajes que hemos intentado enviar. Cada elemento de está matriz, dispone de las siguiente propiedades:

• key; será la misma key que asignamos al agregar el mensaje.
• destino;Teléfono destino con formato internacional "0034666555888"
• mensajes; Texto del mensaje que deseamos enviar.
• error; Una variable Booleana que nos devolverá siel mensaje ha sido enviado o no.
• mensajeerror; En caso de error, este campo nos devuelve la descripción del mismo.

Funciones

La clase proporciona las siguientes funciones:

• Send; está función se encargará de enviar los mensjaes que previamente hemos agregado.
• getSaldo; si únicamente queremos conocer el saldo actual sin enviar ningún mensaje, llamaremos a está función.

Ejemplo

A continuación exponemos un pequeño ejemplo de uso de la clase:

<!--#include file="class_dms.asp"-->
<%

'Configurar Envío SMS
set sms = new dms_send
'sms.mailError="mailadmin@dominio.com"
sms.autentificacion.username=usuario
sms.autentificacion.passwd=clave

'Componer Mensajes
sms.mensajes.add "1","003400000000","mensaje de prueba,""

'Enviar SMS
sms.Send

'Comprobando envío
if sms.autentificacion.error then
     'Cuenta no autentificada
     response.write("<font class='textoERR'>" & sms.autentificacion.mensajeerror & "</font>")
else
     'Cuenta autentificada
     response.write("<table align='center'><tr><td class='texto1'>Saldo: </td><td class='texto1'>" & sms.autentificacion.saldo & "</td></tr>")
     'Lectura de los estados de envío de los mensajes
     for each msg in sms.mensajes.enviados
     if msg.error then
          'Mensaje no enviado
          response.write("<tr><td class='texto1'>Mensajes " & msg.key & " (" & msg.destino & "):</td><td class='textoERR'>" & msg.mensajeerror & "</td></tr>")
     else
          'Mensaje enviado
          response.write("<tr><td class='texto1'>Mensajes " & msg.key & " (" & msg.destino & "):</td><td class='textoOK'>" & msg.mensajeerror & "</td></tr>")
     end if
next
response.write("</table>")
end if
%>

Inicio - Contacto - Datos Identificativos - Aviso Legal - copyright: Descom SL.